google::cloud::spanner::v1::Timestamp Class Reference

A representation of the Spanner TIMESTAMP type: An instant in time. More...

#include <google/cloud/spanner/timestamp.h>

Public Member Functions
	Timestamp ()
	Default construction yields 1970-01-01T00:00:00Z. More...
Regular value type, supporting copy, assign, move.
	Timestamp (Timestamp &&)=default
Timestamp &	operator= (Timestamp &&)=default
	Timestamp (Timestamp const &)=default
Timestamp &	operator= (Timestamp const &)=default

Friends
Relational operators
bool	operator== (Timestamp const &a, Timestamp const &b)
bool	operator!= (Timestamp const &a, Timestamp const &b)
bool	operator< (Timestamp const &a, Timestamp const &b)
bool	operator<= (Timestamp const &a, Timestamp const &b)
bool	operator>= (Timestamp const &a, Timestamp const &b)
bool	operator> (Timestamp const &a, Timestamp const &b)

Output streaming
template<typename T >
StatusOr< T >	get () const
	Convert the Timestamp to the user-specified template type. More...
std::ostream &	operator<< (std::ostream &os, Timestamp ts)
template<typename Duration >
StatusOr< Timestamp >	MakeTimestamp (sys_time< Duration > const &)
	Construct a Timestamp from a std::chrono::time_point on the system clock. More...

Detailed Description

A representation of the Spanner TIMESTAMP type: An instant in time.

A Timestamp represents an absolute point in time (i.e., is independent of any time zone), with at least nanosecond precision, and with a range of at least 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z.

The MakeTimestamp(src) factory function(s) should be used to construct Timestamp values from standard representations of absolute time.

A Timestamp can be converted back to a standard representation using ts.get<T>().

Definition at line 73 of file timestamp.h.

Constructor & Destructor Documentation

Timestamp() [1/3]

google::cloud::spanner::v1::Timestamp::Timestamp ( )

inline

Default construction yields 1970-01-01T00:00:00Z.

Definition at line 76 of file timestamp.h.

Timestamp() [2/3]

google::cloud::spanner::v1::Timestamp::Timestamp ( Timestamp &&  )

default

Timestamp() [3/3]

google::cloud::spanner::v1::Timestamp::Timestamp ( Timestamp const &  )

default

Member Function Documentation

get()

template<typename T >

StatusOr<T> google::cloud::spanner::v1::Timestamp::get ( ) const

inline

Convert the Timestamp to the user-specified template type.

Fails if *this cannot be represented as a T.

Supported destination types are:

• google::cloud::spanner::sys_time<Duration> (Duration::rep may not be wider than std::intmax_t.)

Example

sys_time<std::chrono::nanoseconds> tp = ...;
Timestamp ts = MakeTimestamp(tp).value();
assert(tp == ts.get<sys_time<std::chrono::nanoseconds>>().value());

Definition at line 130 of file timestamp.h.

operator=() [1/2]

Timestamp& google::cloud::spanner::v1::Timestamp::operator= ( Timestamp &&  )

default

operator=() [2/2]

Timestamp& google::cloud::spanner::v1::Timestamp::operator= ( Timestamp const &  )

default

Friends And Related Function Documentation

MakeTimestamp

template<typename Duration >

StatusOr<Timestamp> MakeTimestamp ( sys_time< Duration > const &  tp )

friend

Construct a Timestamp from a std::chrono::time_point on the system clock.

May produce out-of-range errors, depending on the properties of Duration and the std::chrono::system_clock epoch. Duration::rep may not be wider than std::intmax_t.

Definition at line 194 of file timestamp.h.

operator!=

bool operator!= ( Timestamp const &  a, Timestamp const &  b  )

friend

Definition at line 91 of file timestamp.h.

operator<

bool operator< ( Timestamp const &  a, Timestamp const &  b  )

friend

Definition at line 94 of file timestamp.h.

operator<<

std::ostream& operator<< ( std::ostream &  os, Timestamp  ts  )

friend

Definition at line 109 of file timestamp.h.

operator<=

bool operator<= ( Timestamp const &  a, Timestamp const &  b  )

friend

Definition at line 97 of file timestamp.h.

operator==

bool operator== ( Timestamp const &  a, Timestamp const &  b  )

friend

Definition at line 88 of file timestamp.h.

operator>

bool operator> ( Timestamp const &  a, Timestamp const &  b  )

friend

Definition at line 103 of file timestamp.h.

operator>=

bool operator>= ( Timestamp const &  a, Timestamp const &  b  )

friend

Definition at line 100 of file timestamp.h.