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>

public class Timestamp
extends Timestamp

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.

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
Calendar	getCalendar() Gets the calendar for this date.
boolean	isUTC() Gets the UTC flag.
void	setTime(long timestamp)
void	setUTC(boolean utc) Sets the UTC flag.

Methods inherited from class java.sql.Timestamp

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

Methods inherited from class java.util.Date

after, before, clone, getDate, getDay, getHours, getMinutes, getMonth, getSeconds, getTimezoneOffset, getYear, parse, setDate, setHours, setMinutes, setMonth, setSeconds, setYear, toGMTString, toLocaleString, UTC

Methods inherited from class java.lang.Object

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

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

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

setTime

public void setTime(long timestamp)

Overridden to clear the lazy calendar.

Overrides:

setTime in class Timestamp