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.

See Also

• The reference timestamp definition

Inherited Constant Summary

From interface android.os.Parcelable

int	CONTENTS_FILE_DESCRIPTOR
int	PARCELABLE_WRITE_RETURN_VALUE

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

From class java.lang.Object

Object	clone()
boolean	equals(Object arg0)
void	finalize()
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

From interface java.lang.Comparable

abstract int

compareTo(Timestamp arg0)

From interface android.os.Parcelable

abstract int	describeContents()
abstract void	writeToParcel(Parcel arg0, int arg1)

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)