Class Timestamp (2.12.0)

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
TypeDescription
Timestamp

MIN_VALUE

public static final Timestamp MIN_VALUE

The smallest legal timestamp ("0001-01-01T00:00:00Z").

Field Value
TypeDescription
Timestamp

Static Methods

fromProto(Timestamp proto)

public static Timestamp fromProto(Timestamp proto)

Creates an instance of Timestamp from com.google.protobuf.Timestamp.

Parameter
NameDescription
protoTimestamp
Returns
TypeDescription
Timestamp

now()

public static Timestamp now()

Creates an instance with current time.

Returns
TypeDescription
Timestamp

of(Timestamp timestamp)

public static Timestamp of(Timestamp timestamp)

Creates an instance representing the value of timestamp.

Parameter
NameDescription
timestampTimestamp
Returns
TypeDescription
Timestamp

of(Date date)

public static Timestamp of(Date date)

Creates an instance representing the value of Date.

Parameter
NameDescription
dateDate
Returns
TypeDescription
Timestamp

ofTimeMicroseconds(long microseconds)

public static Timestamp ofTimeMicroseconds(long microseconds)

Creates an instance representing the value of microseconds.

Parameter
NameDescription
microsecondslong
Returns
TypeDescription
Timestamp

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
NameDescription
secondslong

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.

nanosint

the fractional seconds component, in the range 0..999999999.

Returns
TypeDescription
Timestamp

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
NameDescription
timestampString

string in the RFC 3339 format

Returns
TypeDescription
Timestamp

created Timestamp

Methods

compareTo(Timestamp other)

public int compareTo(Timestamp other)
Parameter
NameDescription
otherTimestamp
Returns
TypeDescription
int

equals(Object o)

public boolean equals(Object o)
Parameter
NameDescription
oObject
Returns
TypeDescription
boolean
Overrides

getNanos()

public int getNanos()

Returns the fractional seconds component, in nanoseconds.

Returns
TypeDescription
int

getSeconds()

public long 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
TypeDescription
long

hashCode()

public int hashCode()
Returns
TypeDescription
int
Overrides

toDate()

public Date toDate()

Returns a new java.util.Date corresponding to this timestamp. Any sub-millisecond precision will be stripped.

Returns
TypeDescription
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
TypeDescription
Timestamp

toSqlTimestamp()

public Timestamp toSqlTimestamp()

Returns a JDBC timestamp initialized to the same point in time as this.

Returns
TypeDescription
Timestamp

toString()

public String toString()
Returns
TypeDescription
String
Overrides