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.
|
|
Protected Constructor Summary
Public Method Summary
int | |
int | |
boolean | |
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 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.
Protected Constructors
protected Timestamp (Parcel in)
Public Methods
public int compareTo (Timestamp other)
public int describeContents ()
public boolean equals (Object 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.