Skip to content

Commit

Permalink
TIMESTAMP / TIMESTAMPTZ clarifications
Browse files Browse the repository at this point in the history
Follow up to cockroachdb#5762.
  • Loading branch information
jseldess committed Nov 9, 2019
1 parent 26a0cba commit edb1348
Show file tree
Hide file tree
Showing 12 changed files with 24 additions and 28 deletions.
2 changes: 1 addition & 1 deletion v1.0/data-types.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Type | Description | Example
[`FLOAT`](float.html) | A 64-bit, inexact, floating-point number. | `1.2345`
[`BOOL`](bool.html) | A Boolean value. | `true`
[`DATE`](date.html) | A date. | `DATE '2016-01-25'`
[`TIMESTAMP`](timestamp.html) | A date and time pairing. | `TIMESTAMP '2016-01-25 10:10:10'`
[`TIMESTAMP`<br>`TIMESTAMPTZ`](timestamp.html) | A date and time pairing in UTC. | `TIMESTAMP '2016-01-25 10:10:10'`<br>`TIMESTAMPTZ '2016-01-25 10:10:10-05:00'`
[`INTERVAL`](interval.html) | A span of time. | `INTERVAL '2h30m30s'`
[`STRING`](string.html) | A string of Unicode characters. | `'a1b2c3'`
[`COLLATE`](collate.html) | The `COLLATE` feature lets you sort [`STRING`](string.html) values according to language- and country-specific rules, known as collations. | `'a1b2c3' COLLATE en`
Expand Down
6 changes: 3 additions & 3 deletions v1.0/timestamp.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: TIMESTAMP
summary: The TIMESTAMP data type stores a date and time pair in UTC.
title: TIMESTAMP / TIMESTAMPTZ
summary: The TIMESTAMP and TIMESTAMPTZ data types stores a date and time pair in UTC.
toc: true
---

The `TIMESTAMP` [data type](data-types.html) stores a date and time pair in UTC.
The `TIMESTAMP` and `TIMESTAMPTZ` [data types](data-types.html) stores a date and time pair in UTC.


## Time Zone Details
Expand Down
2 changes: 1 addition & 1 deletion v1.1/data-types.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Type | Description | Example
[`FLOAT`](float.html) | A 64-bit, inexact, floating-point number. | `1.2345`
[`BOOL`](bool.html) | A Boolean value. | `true`
[`DATE`](date.html) | A date. | `DATE '2016-01-25'`
[`TIMESTAMP`](timestamp.html) | A date and time pairing. | `TIMESTAMP '2016-01-25 10:10:10'`
[`TIMESTAMP`<br>`TIMESTAMPTZ`](timestamp.html) | A date and time pairing in UTC. | `TIMESTAMP '2016-01-25 10:10:10'`<br>`TIMESTAMPTZ '2016-01-25 10:10:10-05:00'`
[`INTERVAL`](interval.html) | A span of time. | `INTERVAL '2h30m30s'`
[`STRING`](string.html) | A string of Unicode characters. | `'a1b2c3'`
[`COLLATE`](collate.html) | The `COLLATE` feature lets you sort [`STRING`](string.html) values according to language- and country-specific rules, known as collations. | `'a1b2c3' COLLATE en`
Expand Down
6 changes: 3 additions & 3 deletions v1.1/timestamp.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: TIMESTAMP
summary: The TIMESTAMP data type stores a date and time pair in UTC.
title: TIMESTAMP / TIMESTAMPTZ
summary: The TIMESTAMP and TIMESTAMPTZ data types stores a date and time pair in UTC.
toc: true
---

The `TIMESTAMP` [data type](data-types.html) stores a date and time pair in UTC.
The `TIMESTAMP` and `TIMESTAMPTZ` [data types](data-types.html) stores a date and time pair in UTC.


## Time Zone Details
Expand Down
3 changes: 1 addition & 2 deletions v19.1/data-types.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,8 +25,7 @@ Type | Description | Example
[`SERIAL`](serial.html) | A pseudo-type that combines an [integer type](int.html) with a [`DEFAULT` expression](default-value.html). | `148591304110702593`
[`STRING`](string.html) | A string of Unicode characters. | `'a1b2c3'`
[`TIME`](time.html) | A time of day in UTC. | `TIME '01:23:45.123456'`
[`TIMESTAMP`](timestamp.html) | A date and time pairing in UTC. | `TIMESTAMP '2016-01-25 10:10:10'`
[`TIMESTAMPTZ`](timestamp.html) | A date and time pairing with a time zone offset from UTC. | `TIMESTAMPTZ '2016-01-25 10:10:10-05:00'`
[`TIMESTAMP`<br>`TIMESTAMPTZ`](timestamp.html) | A date and time pairing in UTC. | `TIMESTAMP '2016-01-25 10:10:10'`<br>`TIMESTAMPTZ '2016-01-25 10:10:10-05:00'`
[`UUID`](uuid.html) | A 128-bit hexadecimal value. | `7f9c24e8-3b12-4fef-91e0-56a2d5a246ec`

## Data type conversions and casts
Expand Down
6 changes: 3 additions & 3 deletions v19.1/timestamp.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: TIMESTAMP
summary: The TIMESTAMP data type stores a date and time pair in UTC.
title: TIMESTAMP / TIMESTAMPTZ
summary: The TIMESTAMP and TIMESTAMPTZ data types stores a date and time pair in UTC.
toc: true
---

The `TIMESTAMP` [data type](data-types.html) stores a date and time pair in UTC.
The `TIMESTAMP` and `TIMESTAMPTZ` [data types](data-types.html) stores a date and time pair in UTC.


## Variants
Expand Down
3 changes: 1 addition & 2 deletions v19.2/data-types.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,8 +25,7 @@ Type | Description | Example
[`SERIAL`](serial.html) | A pseudo-type that combines an [integer type](int.html) with a [`DEFAULT` expression](default-value.html). | `148591304110702593`
[`STRING`](string.html) | A string of Unicode characters. | `'a1b2c3'`
[`TIME`](time.html) | A time of day in UTC. | `TIME '01:23:45.123456'`
[`TIMESTAMP`](timestamp.html) | A date and time pairing in UTC. | `TIMESTAMP '2016-01-25 10:10:10'`
[`TIMESTAMPTZ`](timestamp.html) | A date and time pairing with a time zone offset from UTC. | `TIMESTAMPTZ '2016-01-25 10:10:10-05:00'`
[`TIMESTAMP`<br>`TIMESTAMPTZ`](timestamp.html) | A date and time pairing in UTC. | `TIMESTAMP '2016-01-25 10:10:10'`<br>`TIMESTAMPTZ '2016-01-25 10:10:10-05:00'`
[`UUID`](uuid.html) | A 128-bit hexadecimal value. | `7f9c24e8-3b12-4fef-91e0-56a2d5a246ec`

## Data type conversions and casts
Expand Down
7 changes: 3 additions & 4 deletions v19.2/timestamp.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,10 @@
---
title: TIMESTAMP
summary: The TIMESTAMP data type stores a date and time pair in UTC.
title: TIMESTAMP / TIMESTAMPTZ
summary: The TIMESTAMP and TIMESTAMPTZ data types stores a date and time pair in UTC.
toc: true
---

The `TIMESTAMP` [data type](data-types.html) stores a date and time pair in UTC.

The `TIMESTAMP` and `TIMESTAMPTZ` [data types](data-types.html) stores a date and time pair in UTC.

## Variants

Expand Down
2 changes: 1 addition & 1 deletion v2.0/data-types.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ Type | Description | Example
[`SERIAL`](serial.html) | A pseudo-type that combines an [integer type](int.html) with a [`DEFAULT` expression](default-value.html). | `148591304110702593 `
[`STRING`](string.html) | A string of Unicode characters. | `'a1b2c3'`
[`TIME`](time.html) | <span class="version-tag">New in v2.0:</span> A time of day with no time zone. | `TIME '01:23:45.123456'`
[`TIMESTAMP`](timestamp.html) | A date and time pairing. | `TIMESTAMP '2016-01-25 10:10:10'`
[`TIMESTAMP`<br>`TIMESTAMPTZ`](timestamp.html) | A date and time pairing in UTC. | `TIMESTAMP '2016-01-25 10:10:10'`<br>`TIMESTAMPTZ '2016-01-25 10:10:10-05:00'`
[`UUID`](uuid.html) | A 128-bit hexadecimal value. | `7f9c24e8-3b12-4fef-91e0-56a2d5a246ec`

## Data Type Conversions & Casts
Expand Down
6 changes: 3 additions & 3 deletions v2.0/timestamp.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: TIMESTAMP
summary: The TIMESTAMP data type stores a date and time pair in UTC.
title: TIMESTAMP / TIMESTAMPTZ
summary: The TIMESTAMP and TIMESTAMPTZ data types stores a date and time pair in UTC.
toc: true
---

The `TIMESTAMP` [data type](data-types.html) stores a date and time pair in UTC.
The `TIMESTAMP` and `TIMESTAMPTZ` [data types](data-types.html) stores a date and time pair in UTC.


## Time Zone Details
Expand Down
3 changes: 1 addition & 2 deletions v2.1/data-types.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,8 +24,7 @@ Type | Description | Example
[`SERIAL`](serial.html) | A pseudo-type that combines an [integer type](int.html) with a [`DEFAULT` expression](default-value.html). | `148591304110702593`
[`STRING`](string.html) | A string of Unicode characters. | `'a1b2c3'`
[`TIME`](time.html) | A time of day in UTC. | `TIME '01:23:45.123456'`
[`TIMESTAMP`](timestamp.html) | A date and time pairing in UTC. | `TIMESTAMP '2016-01-25 10:10:10'`
[`TIMESTAMPTZ`](timestamp.html) | A date and time pairing with a time zone offset from UTC. | `TIMESTAMPTZ '2016-01-25 10:10:10-05:00'`
[`TIMESTAMP`<br>`TIMESTAMPTZ`](timestamp.html) | A date and time pairing in UTC. | `TIMESTAMP '2016-01-25 10:10:10'`<br>`TIMESTAMPTZ '2016-01-25 10:10:10-05:00'`
[`UUID`](uuid.html) | A 128-bit hexadecimal value. | `7f9c24e8-3b12-4fef-91e0-56a2d5a246ec`

## Data type conversions and casts
Expand Down
6 changes: 3 additions & 3 deletions v2.1/timestamp.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: TIMESTAMP
summary: The TIMESTAMP data type stores a date and time pair in UTC.
title: TIMESTAMP / TIMESTAMPTZ
summary: The TIMESTAMP and TIMESTAMPTZ data types stores a date and time pair in UTC.
toc: true
---

The `TIMESTAMP` [data type](data-types.html) stores a date and time pair in UTC.
The `TIMESTAMP` and `TIMESTAMPTZ` [data types](data-types.html) stores a date and time pair in UTC.


## Variants
Expand Down

0 comments on commit edb1348

Please sign in to comment.