org.tentackle.common

Class Date

java.lang.Object

java.util.Date

java.sql.Date

org.tentackle.common.Date

All Implemented Interfaces:

Serializable, Cloneable, Comparable<Date>, Freezable

public class Date
extends Date
implements Freezable

Date with database semantics.

Differs from java.sql.Date when serialized/deserialized in different timezones. Databases don't provide a time and therefore no timezone for a date, i.e. when sent over wire to different locations a date should always remain the same for all timezones. In java.sql.Data, however, the epochal time is serialized which may lead to a different date when deserialized in another timezone. In Date the effective date is serialized as YYYYMMDD to provide the same semantics as databases do.

Furthermore, tentackle dates can be frozen, i.e. made immutable.

Author:

harald

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Date() Creates the current date.
Date(long date) Constructs a Date object using the given milliseconds time value.

Method Summary

Modifier and Type	Method and Description
Date	clone()
static Date	createFrozen(long epoch) Creates a frozen date.
void	freeze() Makes this object immutable.
Calendar	getCalendar() Gets the calendar for this date.
void	setDate(int date)
void	setHours(int hours)
void	setMinutes(int minutes)
void	setMonth(int month)
void	setSeconds(int seconds)
void	setTime(long date)
void	setYear(int year)

Methods inherited from class java.sql.Date

getHours, getMinutes, getSeconds, toInstant, toLocalDate, toString, valueOf, valueOf

Methods inherited from class java.util.Date

after, before, compareTo, equals, from, getDate, getDay, getMonth, getTime, getTimezoneOffset, getYear, hashCode, parse, toGMTString, toLocaleString, UTC

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.tentackle.common.Freezable

freeze

Constructor Detail

Date

public Date(long date)

Constructs a Date object using the given milliseconds time value. If the given milliseconds value contains time information, the driver will set the time components to the time in the default time zone (the time zone of the Java virtual machine running the application) that corresponds to zero GMT.

Parameters:

date - milliseconds since January 1, 1970, 00:00:00 GMT not to exceed the milliseconds representation for the year 8099. A negative number indicates the number of milliseconds before January 1, 1970, 00:00:00 GMT.

Date

public Date()

Creates the current date.

Method Detail

createFrozen

public static Date createFrozen(long epoch)

Creates a frozen date.

Parameters:

epoch - epochal milliseconds since January 1, 1970, 00:00:00 GMT

Returns:

the frozen date

clone

public Date clone()

Cloned dates are always not frozen.

Overrides:

clone in class Date

getCalendar

public Calendar getCalendar()

Gets the calendar for this date.

Returns:

the calendar

freeze

public void freeze()

Description copied from interface: Freezable

Makes this object immutable.

Specified by:

freeze in interface Freezable

setTime

public void setTime(long date)

Overridden to clear the lazy calendar and to check for frozen.

Overrides:

setTime in class Date

setYear

public void setYear(int year)

Overrides:

setYear in class Date

setMonth

public void setMonth(int month)

Overrides:

setMonth in class Date

setDate

public void setDate(int date)

Overrides:

setDate in class Date

setHours

public void setHours(int hours)

Overrides:

setHours in class Date

setMinutes

public void setMinutes(int minutes)

Overrides:

setMinutes in class Date

setSeconds

public void setSeconds(int seconds)

Overrides:

setSeconds in class Date