public final class Timestamp extends Object
implements Comparable<Timestamp> Parcelable

A Timestamp represents a point in time independent of any time zone or calendar, represented as seconds and fractions of seconds at nanosecond resolution in UTC Epoch time. It is encoded using the Proleptic Gregorian Calendar which extends the Gregorian calendar backwards to year one. It is encoded assuming all minutes are 60 seconds long, i.e. leap seconds are "smeared" so that no leap second table is needed for interpretation. Range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By restricting to that range, we ensure that we can convert to and from RFC 3339 date strings.

See Also

Inherited Constant Summary

Field Summary

public static final Creator<Timestamp> CREATOR

Public Constructor Summary

Timestamp(long seconds, int nanoseconds)
Creates a new timestamp.
Timestamp(Date date)
Creates a new timestamp from the given date.

Protected Constructor Summary

Timestamp(Parcel in)

Public Method Summary

int
compareTo(Timestamp other)
int
describeContents()
boolean
equals(Object other)
int
getNanoseconds()
Returns the sub-second part of the timestamp, in nanoseconds.
long
getSeconds()
Returns the seconds part of the timestamp.
int
hashCode()
static Timestamp
now()
Creates a new timestamp with the current date, with millisecond precision.
Date
toDate()
Returns a new Date corresponding to this timestamp.
String
toString()
void
writeToParcel(Parcel dest, int flags)

Inherited Method Summary

Fields

public static final Creator<Timestamp> CREATOR

Public Constructors

public Timestamp (long seconds, int nanoseconds)

Creates a new timestamp.

Parameters
seconds represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z inclusive.
nanoseconds represents non-negative fractions of a second at nanosecond resolution. Negative second values with fractions must still have non-negative nanoseconds values that count forward in time. Must be from 0 to 999,999,999 inclusive.

public Timestamp (Date date)

Creates a new timestamp from the given date.

Parameters
date

Protected Constructors

protected Timestamp (Parcel in)

Parameters
in

Public Methods

public int compareTo (Timestamp other)

Parameters
other

public int describeContents ()

public boolean equals (Object other)

Parameters
other

public int getNanoseconds ()

Returns the sub-second part of the timestamp, in nanoseconds.

public long getSeconds ()

Returns the seconds part of the timestamp.

public int hashCode ()

public static Timestamp now ()

Creates a new timestamp with the current date, with millisecond precision.

public Date toDate ()

Returns a new Date corresponding to this timestamp. This may lose precision.

public String toString ()

public void writeToParcel (Parcel dest, int flags)

Parameters
dest
flags