Send feedback Class Timestamp (2.59.0) Stay organized with collections Save and categorize content based on your preferences. Version 2.59.0keyboard_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.
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 fromcom.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 oftimestamp.
of(Date date)
public static Timestamp of ( Date date ) Creates an instance representing the value ofDate.
Parameter Name Description dateDate
ofTimeMicroseconds(long microseconds)
public static Timestamp ofTimeMicroseconds ( long microseconds ) Creates an instance representing the value ofmicroseconds.
Parameter Name Description microsecondslong
ofTimeSecondsAndNanos(long seconds, int nanos)
public static Timestamp ofTimeSecondsAndNanos ( long seconds , int nanos ) Creates an instance representing the value ofseconds andnanos since January 1, 1970, 00:00:00 UTC.
Parameters Name Description 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.
parseTimestamp(String timestamp)
public static Timestamp parseTimestamp ( String timestamp ) Parameter Name Description timestampString
parseTimestampDuration(String timestamp)
public static Timestamp parseTimestampDuration ( 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 timestampString 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 oObject
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 newjava.util.Date corresponding to thistimestamp. Any sub-millisecond precision will be stripped.
Returns Type Description Date An approximatejava.util.Date representation of thistimestamp.
toProto() Returns acom.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 asthis.
toString() Overrides Send feedback
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License , and code samples are licensed under theApache 2.0 License . For details, see theGoogle Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-01-31 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 2026-01-31 UTC."],[],[]]
