org.tentackle.common

Class Timestamp

java.lang.Object

java.util.Date

java.sql.Timestamp

org.tentackle.common.Timestamp

All Implemented Interfaces:

Serializable, Cloneable, Comparable<Date>, Freezable

public class Timestamp
extends Timestamp
implements Freezable

Timestamp with UTC option.

Differs from java.sql.Timestamp when serialized/deserialized in different timezones. By default, if timestamps are serialized and deserialized in different timezones, their representation may differ according to the GMT-offset and/or daylight saving. This is okay for most cases. In some cases, however, a timestamp should not be converted, i.e. regarded as fixed and related to some timezone by convention, for example UTC. This is what the UTC-attribute and the tentackle model's [UTC]-option is provided for.

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

Author:

harald

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Timestamp() Creates the current timestamp.
Timestamp(long time) Constructs a Timestamp object using a milliseconds time value.

Method Summary

Modifier and Type	Method and Description
Timestamp	clone()
static Timestamp	createFrozen(long epoch, int nanos) Creates a frozen timestamp.
void	freeze() Makes this object immutable.
Calendar	getCalendar() Gets the calendar for this date.
boolean	isUTC() Gets the UTC flag.
void	setDate(int date)
void	setHours(int hours)
void	setMinutes(int minutes)
void	setMonth(int month)
void	setNanos(int n)
void	setSeconds(int seconds)
void	setTime(long timestamp)
void	setUTC(boolean utc) Sets the UTC flag.
static void	setUTC(Timestamp timestamp, boolean utc) Sets the UTC flag null-safe. Method provided to reduce generated code.
void	setYear(int year)

Methods inherited from class java.sql.Timestamp

after, before, compareTo, compareTo, equals, equals, from, getNanos, getTime, hashCode, toInstant, toLocalDateTime, toString, valueOf, valueOf

Methods inherited from class java.util.Date

after, before, getDate, getDay, getHours, getMinutes, getMonth, getSeconds, getTimezoneOffset, getYear, 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

Timestamp

public Timestamp(long time)

Constructs a Timestamp object using a milliseconds time value. The integral seconds are stored in the underlying date value; the fractional seconds are stored in the nanos field of the Timestamp object.

Parameters:

time - milliseconds since January 1, 1970, 00:00:00 GMT. A negative number is the number of milliseconds before January 1, 1970, 00:00:00 GMT.

See Also:

Calendar

Timestamp

public Timestamp()

Creates the current timestamp.

Method Detail

createFrozen

public static Timestamp createFrozen(long epoch,
                                     int nanos)

Creates a frozen timestamp.

Parameters:

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

nanos - the new fractional seconds component

Returns:

the frozen timestamp

setUTC

public static void setUTC(Timestamp timestamp,
                          boolean utc)

Sets the UTC flag null-safe.
Method provided to reduce generated code.

Parameters:

timestamp - the timestamp, may be null

utc - the UTC flag

clone

public Timestamp clone()

Cloned timestamps are always not frozen.

Overrides:

clone in class Date

setUTC

public void setUTC(boolean utc)

Sets the UTC flag.

Timestamps with UTC set are serialized and deserialized without timezone.

Parameters:

utc - the UTC flag

isUTC

public boolean isUTC()

Gets the UTC flag.

Returns:

true if timestamp is UTC

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 timestamp)

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

Overrides:

setTime in class Timestamp

setNanos

public void setNanos(int n)

Overrides:

setNanos in class Timestamp

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