Class Timestamp (2.42.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
Type Description
Timestamp

MIN_VALUE

public static final Timestamp MIN_VALUE

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

Field Value
Type Description
Timestamp

Static Methods

fromProto(Timestamp proto)

public static Timestamp fromProto(Timestamp proto)

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

Parameter
Name Description
proto Timestamp
Returns
Type Description
Timestamp

now()

public static Timestamp now()

Creates an instance with current time.

Returns
Type Description
Timestamp

of(Timestamp timestamp)

public static Timestamp of(Timestamp timestamp)

Creates an instance representing the value of timestamp.

Parameter
Name Description
timestamp Timestamp
Returns
Type Description
Timestamp

of(Date date)

public static Timestamp of(Date date)

Creates an instance representing the value of Date.

Parameter
Name Description
date Date
Returns
Type Description
Timestamp

ofTimeMicroseconds(long microseconds)

public static Timestamp ofTimeMicroseconds(long microseconds)

Creates an instance representing the value of microseconds.

Parameter
Name Description
microseconds long
Returns
Type Description
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
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
Type Description
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
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)
Parameter
Name Description
other Timestamp
Returns
Type Description
int

equals(Object o)

public boolean equals(Object o)
Parameter
Name Description
o Object
Returns
Type Description
boolean
Overrides

getNanos()

public int getNanos()

Returns the fractional seconds component, in nanoseconds.

Returns
Type Description
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
Type Description
long

hashCode()

public int hashCode()
Returns
Type Description
int
Overrides

toDate()

public Date 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
Type Description
Timestamp

toSqlTimestamp()

public Timestamp toSqlTimestamp()

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

Returns
Type Description
Timestamp

toString()

public String toString()
Returns
Type Description
String
Overrides