Send feedback
Class Timestamp (2.12.0) Stay organized with collections
Save and categorize content based on your preferences.
Version 2.12.0 keyboard_arrow_down
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
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()
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
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()
public
String
toString
()
Returns
Overrides
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-04 UTC.
Need to tell us more?
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,[]]
