Class Timestamp (2.34.0-rc)

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 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, inclusive.

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>().

See Also

https://cloud.google.com/spanner/docs/data-types#timestamp_type

Fails if *this cannot be represented as a T.

Supported destination types are:

• absl::Time - Since absl::Time can represent all possible Timestamp values, get<absl::Time>() never returns an error.
• google::protobuf::Timestamp - Never returns an error, but any sub-nanosecond precision will be lost.
• google::cloud::spanner::sys_time<Duration> - Duration::rep may not be wider than std::int64_t, and Duration::period may be no more precise than std::nano.

Example

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