Timestamp | Doclava
public final class

Timestamp

extends Object
implements Comparable<Timestamp>
java.lang.Object
   ↳ com.google.firebase.Timestamp

Class Overview

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:

Summary

Public Constructors
Timestamp(long seconds, int nanoseconds)
Creates a new timestamp.
Timestamp(Date date)
Creates a new timestamp from the given date.
Public Methods
int compareTo(Timestamp other)
boolean equals(Object other)
Date getApproximateDate()
Returns a new Date corresponding to this timestamp.
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.
String toString()
[Expand]
Inherited Methods
From class java.lang.Object
From interface java.lang.Comparable

Public Constructors

public Timestamp (long seconds, int nanoseconds)

Creates a new timestamp.

Parameters
seconds long: 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 int: 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 Date

Public Methods

public int compareTo (Timestamp other)

Parameters
other Timestamp
Returns
int

public boolean equals (Object other)

Parameters
other Object
Returns
boolean

public Date getApproximateDate ()

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

Returns
Date

public int getNanoseconds ()

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

Returns
int

public long getSeconds ()

Returns the seconds part of the timestamp.

Returns
long

public int hashCode ()

Returns
int

public static Timestamp now ()

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

Returns
Timestamp

public String toString ()

Returns
String