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").
MIN_VALUE
public static final Timestamp MIN_VALUE
The smallest legal timestamp ("0001-01-01T00:00:00Z").
Static Methods
fromProto(Timestamp proto)
public static Timestamp fromProto(Timestamp proto)
Creates an instance of Timestamp from com.google.protobuf.Timestamp.
now()
public static Timestamp now()
Creates an instance with current time.
of(Timestamp timestamp)
public static Timestamp of(Timestamp timestamp)
Creates an instance representing the value of timestamp.
| Parameter |
| Name |
Description |
timestamp |
Timestamp
|
of(Date date)
public static Timestamp of(Date date)
Creates an instance representing the value of Date.
| Parameter |
| Name |
Description |
date |
Date
|
ofTimeMicroseconds(long microseconds)
public static Timestamp ofTimeMicroseconds(long microseconds)
Creates an instance representing the value of microseconds.
| Parameter |
| Name |
Description |
microseconds |
long
|
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.
|
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 |
| Type |
Description |
Timestamp |
created Timestamp
|
Methods
compareTo(Timestamp other)
public int compareTo(Timestamp other)
| Returns |
| Type |
Description |
int |
|
equals(Object o)
public boolean equals(Object o)
| Parameter |
| Name |
Description |
o |
Object
|
Overrides
getNanos()
Returns the fractional seconds component, in nanoseconds.
| Returns |
| Type |
Description |
int |
|
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 |
| Type |
Description |
long |
|
hashCode()
| Returns |
| Type |
Description |
int |
|
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.
toSqlTimestamp()
public Timestamp toSqlTimestamp()
Returns a JDBC timestamp initialized to the same point in time as this.
toString()
| Returns |
| Type |
Description |
String |
|
Overrides
