Timestamp (Google Cloud 0.90.0-alpha API)

java.lang.Object
- com.google.cloud.Timestamp

All Implemented Interfaces:

Serializable, Comparable<Timestamp>
```
public final class Timestamp
extends Object
implements Comparable<Timestamp>, Serializable
```
Represents a timestamp with nanosecond precision. Timestamps cover the range [0001-01-01, 9999-12-31].
Timestamp instances are immutable.

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static Timestamp`	`MAX_VALUE` The largest legal timestamp ("9999-12-31T23:59:59Z").
`static Timestamp`	`MIN_VALUE` The smallest legal timestamp ("0001-01-01T00:00:00Z").

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`int`	`compareTo(Timestamp other)`
`boolean`	`equals(Object o)`
`static Timestamp`	`fromProto(Timestamp proto)` Creates an instance of Timestamp from `com.google.protobuf.Timestamp`.
`int`	`getNanos()` Returns the fractional seconds component, in nanoseconds.
`long`	`getSeconds()` Returns the number of seconds since January 1, 1970, 00:00:00 UTC.
`int`	`hashCode()`
`static Timestamp`	`now()` Creates an instance with current time.
`static Timestamp`	`of(Date date)` Creates an instance representing the value of `Date`.
`static Timestamp`	`of(Timestamp timestamp)` Creates an instance representing the value of `timestamp`.
`static Timestamp`	`ofTimeMicroseconds(long microseconds)` Creates an instance representing the value of `microseconds`.
`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.
`static Timestamp`	`parseTimestamp(String timestamp)` Creates a Timestamp instance from the given string.
`Date`	`toDate()` Returns a new `java.util.Date` corresponding to this `timestamp`.
`Timestamp`	`toProto()` Returns a `com.google.protobuf.Timestamp` initialized to the same point in time as `this`.
`Timestamp`	`toSqlTimestamp()` Returns a JDBC timestamp initialized to the same point in time as `this`.
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - MIN_VALUE
```
public static final Timestamp MIN_VALUE
```
    The smallest legal timestamp ("0001-01-01T00:00:00Z").
  - MAX_VALUE
```
public static final Timestamp MAX_VALUE
```
    The largest legal timestamp ("9999-12-31T23:59:59Z").
- Method Detail
  - ofTimeSecondsAndNanos
```
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:
    
    seconds - 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 - the fractional seconds component, in the range 0..999999999.
    
    Throws:
    
    IllegalArgumentException - if the timestamp is outside the representable range
  - ofTimeMicroseconds
```
public static Timestamp ofTimeMicroseconds(long microseconds)
```
    Creates an instance representing the value of microseconds.
    
    Throws:
    
    IllegalArgumentException - if the timestamp is outside the representable range
  - of
```
public static Timestamp of(Date date)
```
    Creates an instance representing the value of Date.
    
    Throws:
    
    IllegalArgumentException - if the timestamp is outside the representable range
  - now
```
public static Timestamp now()
```
    Creates an instance with current time.
  - of
```
public static Timestamp of(Timestamp timestamp)
```
    Creates an instance representing the value of timestamp.
    
    Throws:
    
    IllegalArgumentException - if the timestamp is outside the representable range
  - 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.
  - getNanos
```
public int getNanos()
```
    Returns the fractional seconds component, in nanoseconds.
  - toSqlTimestamp
```
public Timestamp toSqlTimestamp()
```
    Returns a JDBC timestamp initialized to the same point in time as this.
  - toDate
```
public Date toDate()
```
    Returns a new java.util.Date corresponding to this timestamp. Any sub-millisecond precision will be stripped.
    
    Returns:
    
    An approximate java.util.Date representation of this timestamp.
  - compareTo
```
public int compareTo(Timestamp other)
```
    Specified by:
    
    compareTo in interface Comparable<Timestamp>
  - fromProto
```
public static Timestamp fromProto(Timestamp proto)
```
    Creates an instance of Timestamp from com.google.protobuf.Timestamp.
  - toProto
```
public Timestamp toProto()
```
    Returns a com.google.protobuf.Timestamp initialized to the same point in time as this.
  - parseTimestamp
```
public static Timestamp parseTimestamp(String timestamp)
```
    Creates a Timestamp instance from the given string. String is in the RFC 3339 format without the timezone offset (always ends in "Z").
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - equals
```
public boolean equals(Object o)
```
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object

Class Timestamp

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

MIN_VALUE

MAX_VALUE

Method Detail

ofTimeSecondsAndNanos

ofTimeMicroseconds

of

now

of

getSeconds

getNanos

toSqlTimestamp

toDate

compareTo

fromProto

toProto

parseTimestamp

toString

equals

hashCode