Timestamp

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.

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

Public Method Summary

int
int
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
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
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.

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.

public String toString ()

public void writeToParcel (Parcel dest, int flags)