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
.
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()
Overrides