Class Timestamp (2.35.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

MIN_VALUE

  public 
  
 static 
  
 final 
  
 Timestamp 
  
 MIN_VALUE 
 

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

Field Value
Type
Description

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

now()

  public 
  
 static 
  
 Timestamp 
  
 now 
 () 
 

Creates an instance with current time.

Returns
Type
Description

of(Timestamp timestamp)

  public 
  
 static 
  
 Timestamp 
  
 of 
 ( 
 Timestamp 
  
 timestamp 
 ) 
 

Creates an instance representing the value of timestamp .

Parameter
Name
Description
timestamp
Returns
Type
Description

of(Date date)

  public 
  
 static 
  
 Timestamp 
  
 of 
 ( 
 Date 
  
 date 
 ) 
 

Creates an instance representing the value of Date .

Parameter
Name
Description
date
Returns
Type
Description

ofTimeMicroseconds(long microseconds)

  public 
  
 static 
  
 Timestamp 
  
 ofTimeMicroseconds 
 ( 
 long 
  
 microseconds 
 ) 
 

Creates an instance representing the value of microseconds .

Parameter
Name
Description
microseconds
Returns
Type
Description

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

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

created Timestamp

Methods

compareTo(Timestamp other)

  public 
  
 int 
  
 compareTo 
 ( 
 Timestamp 
  
 other 
 ) 
 
Parameter
Name
Description
other
Returns
Type
Description
int

equals(Object o)

  public 
  
 boolean 
  
 equals 
 ( 
 Object 
  
 o 
 ) 
 
Parameter
Name
Description
o
Returns
Type
Description
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

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

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

toSqlTimestamp()

  public 
  
 Timestamp 
  
 toSqlTimestamp 
 () 
 

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

Returns
Type
Description

toString()

  public 
  
 String 
  
 toString 
 () 
 
Returns
Type
Description
Overrides
Design a Mobile Site
View Site in Mobile | Classic
Share by: