public final class Timestamp implements Comparable<Timestamp>, Serializable
Represents a timestamp with nanosecond precision. Timestamps cover the range [0001-01-01,
9999-12-31].
Timestamp
instances are immutable.
Inheritance
Object >
Timestamp
Static Fields
MAX_VALUE
public static final Timestamp MAX_VALUE
The largest legal timestamp ("9999-12-31T23:59:59Z").
Field Value
MIN_VALUE
public static final Timestamp MIN_VALUE
The smallest legal timestamp ("0001-01-01T00:00:00Z").
Field Value
Static Methods
fromProto(Timestamp proto)
public static Timestamp fromProto(Timestamp proto)
Creates an instance of Timestamp from com.google.protobuf.Timestamp
.
Parameter
Returns
now()
public static Timestamp now()
Creates an instance with current time.
Returns
of(Timestamp timestamp)
public static Timestamp of(Timestamp timestamp)
Creates an instance representing the value of timestamp
.
Parameter
Returns
of(Date date)
public static Timestamp of(Date date)
Creates an instance representing the value of Date
.
Parameter
Returns
ofTimeMicroseconds(long microseconds)
public static Timestamp ofTimeMicroseconds(long microseconds)
Creates an instance representing the value of microseconds
.
Parameter
Name | Description |
microseconds | long
|
Returns
ofTimeSecondsAndNanos(long seconds, int nanos)
public static Timestamp ofTimeSecondsAndNanos(long seconds, int nanos)
Creates an instance representing the value of seconds
and nanos
since January
1, 1970, 00:00:00 UTC.
Parameters
Name | Description |
seconds | long
seconds since January 1, 1970, 00:00:00 UTC. A negative value is the number of
seconds before January 1, 1970, 00:00:00 UTC.
|
nanos | int
the fractional seconds component, in the range 0..999999999.
|
Returns
parseTimestamp(String timestamp)
public static Timestamp parseTimestamp(String timestamp)
Creates a Timestamp instance from the given string. Input string should be in the RFC 3339
format, like '2020-12-01T10:15:30.000Z' or with the timezone offset, such as
'2020-12-01T10:15:30+01:00'.
Parameter
Name | Description |
timestamp | String
string in the RFC 3339 format
|
Returns
Methods
compareTo(Timestamp other)
public int compareTo(Timestamp other)
Parameter
Returns
equals(Object o)
public boolean equals(Object o)
Parameter
Returns
Overrides
getNanos()
Returns the fractional seconds component, in nanoseconds.
Returns
getSeconds()
Returns the number of seconds since January 1, 1970, 00:00:00 UTC. A negative value is the
number of seconds before January 1, 1970, 00:00:00 UTC.
Returns
hashCode()
Returns
Overrides
toDate()
Returns a new java.util.Date
corresponding to this timestamp
. Any
sub-millisecond precision will be stripped.
Returns
Type | Description |
Date | An approximate java.util.Date representation of this timestamp .
|
toProto()
public Timestamp toProto()
Returns a com.google.protobuf.Timestamp
initialized to the same point in time as
this
.
Returns
toSqlTimestamp()
public Timestamp toSqlTimestamp()
Returns a JDBC timestamp initialized to the same point in time as this
.
Returns
toString()
Returns
Overrides