# Class Timestamp (3.7.0-rc)

3.7.0-rc 3.6.0 (latest) 3.5.0 3.4.0 3.3.0 3.2.0 2.48.0-rc 2.47.1 2.46.0 2.45.0 2.44.0 2.43.0 2.42.0 2.41.0 2.40.0 2.39.0 2.38.0 2.37.0 2.36.0 2.35.0 2.34.0 2.33.0 2.32.0 2.31.0 2.30.0 2.29.0 2.28.0 2.27.0 2.26.0 2.25.1 2.24.0 2.23.0 2.22.1 2.21.0 2.20.0 2.19.0 2.18.0 2.17.0 2.16.0 2.15.1 2.14.0 2.13.0 2.12.0 2.11.0 A representation of the Spanner TIMESTAMP type: An instant in time.
A [`Timestamp`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Timestamp) 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)`](about:invalid#zCSafez) factory function(s) should be used to construct [`Timestamp`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Timestamp) values from standard representations of absolute time.

A [`Timestamp`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Timestamp) can be converted back to a standard representation using `ts.get<T>()`.

###### See Also

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

## Constructors

### Timestamp(Timestamp \&\&)

Regular value type, supporting copy, assign, move.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
|   | `Timestamp &&` |

### Timestamp(Timestamp const \&)

Regular value type, supporting copy, assign, move.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
|   | `Timestamp const &` |

### Timestamp()

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

## Operators

### operator=(Timestamp \&\&)

Regular value type, supporting copy, assign, move.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
|   | `Timestamp &&` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `Timestamp &` |   |

### operator=(Timestamp const \&)

Regular value type, supporting copy, assign, move.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
|   | `Timestamp const &` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `Timestamp &` |   |

## Functions

### get() const

Convert the [`Timestamp`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Timestamp) to the user-specified template type.
Fails if `*this` cannot be represented as a `T`.

Supported destination types are:

- `absl::Time` - Since `absl::Time` can represent all possible [`Timestamp`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Timestamp) 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`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/namespacegoogle_1_1cloud_1_1spanner)`<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());

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `typename T` |   |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `StatusOr< T >` |   |