docs: add TIMESTAMP_TZ data type documentation (#2938)

- Add TIMESTAMP_TZ type to datetime data types table
- Add separate sections for DATE, TIMESTAMP, and TIMESTAMP_TZ with examples
- Include timezone behavior explanations and use cases
- Update version to v1.2.834
- Fix table formatting alignment
- Add both English and Chinese documentation

Author: BohuTANG

docs/cn/sql-reference/00-sql-reference/10-data-types/datetime.md

@@ -5,168 +5,146 @@ description: Databend 的日期和时间数据类型支持标准化，并与各
 
 import FunctionDescription from '@site/src/components/FunctionDescription';
 
-<FunctionDescription description="引入或更新于: v1.2.745"/>
+<FunctionDescription description="引入或更新于: v1.2.834"/>
 
 ## 日期和时间数据类型
 
 | 名称      | 别名     | 存储大小 | 精度        | 最小值                     | 最大值                         | 格式                                                                           |
 |-----------|----------|----------|-------------|----------------------------|--------------------------------|--------------------------------------------------------------------------------|
 | DATE      |          | 4 字节   | 天          | 0001-01-01                 | 9999-12-31                     | `YYYY-MM-DD`                                                                   |
 | TIMESTAMP | DATETIME | 8 字节   | 微秒        | 0001-01-01 00:00:00.000000 | 9999-12-31 23:59:59.999999 UTC | `YYYY-MM-DD hh:mm:ss[.fraction]`，支持最多 6 位微秒精度                       |
+| TIMESTAMP_TZ | TIMESTAMP WITH TIME ZONE | 8 字节 | 微秒 | 0001-01-01 00:00:00.000000 | 9999-12-31 23:59:59.999999 UTC | `YYYY-MM-DD hh:mm:ss[.fraction]±hh:mm`，存储 UTC 值和时区偏移 |
 
+## DATE
 
-## 示例
+DATE 类型用于存储日历日期（年、月、日）。
 
 ```sql
-CREATE TABLE test_dt
-  (
-     date DATE,
-     ts   TIMESTAMP
-  );
-```
+CREATE TABLE events (
+    event_date DATE
+);
 
-```sql
-DESC test_dt;
-```
+INSERT INTO events VALUES
+    ('2024-01-15'),
+    ('2024-12-31');
 
-结果:
+SELECT * FROM events;
+```
 
+结果：
 ```
-┌────────────────────────────────────────────────┐
-│  Field │    Type   │  Null  │ Default │  Extra │
-├────────┼───────────┼────────┼─────────┼────────┤
-│ date   │ DATE      │ YES    │ NULL    │        │
-│ ts     │ TIMESTAMP │ YES    │ NULL    │        │
-└────────────────────────────────────────────────┘
+┌────────────┐
+│ event_date │
+├────────────┤
+│ 2024-01-15 │
+│ 2024-12-31 │
+└────────────┘
 ```
 
-TIMESTAMP 值可以选择性地包含尾随的小数秒部分，精度最高可达微秒 (6 位数字)。
+## TIMESTAMP
+
+TIMESTAMP 在内部以 UTC 格式存储时间点，但会根据会话的时区设置来显示。当您希望不同用户在各自的本地时区查看时间时，这很有用。
 
 ```sql
--- 向表中插入值
-INSERT INTO test_dt
-VALUES
-  ('2022-04-07', '2022-04-07 01:01:01.123456'),
-  ('2022-04-08', '2022-04-08 01:01:01');
-
-SELECT *
-FROM test_dt;
-```
+CREATE TABLE meetings (
+    meeting_id INT,
+    meeting_time TIMESTAMP
+);
 
-结果:
+-- 插入一个会议时间
+INSERT INTO meetings VALUES (1, '2024-01-15 14:00:00+08:00');
 
-```
-┌─────────────────────────────────────────────┐
-│      date      │             ts             │
-├────────────────┼────────────────────────────┤
-│ 2022-04-07     │ 2022-04-07 01:01:01.123456 │
-│ 2022-04-08     │ 2022-04-08 01:01:01        │
-└─────────────────────────────────────────────┘
+-- 在 UTC 时区查看
+SET timezone = 'UTC';
+SELECT * FROM meetings;
 ```
 
-Databend 识别多种格式的 TIMESTAMP 值。
-
-```sql
--- 创建表来测试不同的时间戳格式
-CREATE TABLE test_formats (
-    id INT,
-    a TIMESTAMP
-);
-
--- 插入不同时间戳格式的值
-INSERT INTO test_formats
-VALUES
-    (1, '2022-01-01 02:00:11'),
-    (2, '2022-01-02T02:00:22'),
-    (3, '2022-02-02T04:00:03+00:00'),
-    (4, '2022-02-03');
+结果：
+```
+┌────────────┬─────────────────────┐
+│ meeting_id │ meeting_time        │
+├────────────┼─────────────────────┤
+│          1 │ 2024-01-15 06:00:00 │
+└────────────┴─────────────────────┘
 ```
 
 ```sql
-SELECT *
-FROM test_formats;
-
+-- 在纽约时区查看
+SET timezone = 'America/New_York';
+SELECT * FROM meetings;
 ```
 
-结果:
-
+结果：
 ```
-┌───────────────────────────────────────┐
-│        id       │          a          │
-├─────────────────┼─────────────────────┤
-│               1 │ 2022-01-01 02:00:11 │
-│               2 │ 2022-01-02 02:00:22 │
-│               3 │ 2022-02-02 04:00:03 │
-│               4 │ 2022-02-03 00:00:00 │
-└───────────────────────────────────────┘
+┌────────────┬─────────────────────┐
+│ meeting_id │ meeting_time        │
+├────────────┼─────────────────────┤
+│          1 │ 2024-01-15 01:00:00 │
+└────────────┴─────────────────────┘
 ```
 
-Databend 会根据您当前的时区自动调整并显示 TIMESTAMP 值。
+同一个时间戳会根据会话时区设置显示为不同的值。
+
+## TIMESTAMP_TZ
+
+TIMESTAMP_TZ 同时存储 UTC 时间和原始时区偏移。显示时始终包含偏移量，且不受会话时区影响。这对于审计日志、金融交易或需要保留确切时区上下文的场景非常有用。
 
 ```sql
--- 创建表来测试带时区调整的时间戳值
-CREATE TABLE test_tz (
-    id INT,
-    t TIMESTAMP
+CREATE TABLE system_logs (
+    log_id INT,
+    log_time TIMESTAMP_TZ
 );
 
--- 设置时区为 UTC
-SET timezone = 'UTC';
+-- 插入来自不同地点的日志
+INSERT INTO system_logs VALUES
+    (1, '2024-01-15 14:00:00+08:00'),  -- 北京
+    (2, '2024-01-15 06:00:00+00:00'),  -- UTC
+    (3, '2024-01-15 01:00:00-05:00');  -- 纽约
 
--- 插入考虑不同时区的时间戳值
-INSERT INTO test_tz
-VALUES
-    (1, '2022-02-03T03:00:00'),
-    (2, '2022-02-03T03:00:00+08:00'),
-    (3, '2022-02-03T03:00:00-08:00'),
-    (4, '2022-02-03'),
-    (5, '2022-02-03T03:00:00+09:00'),
-    (6, '2022-02-03T03:00:00+06:00');
+-- 使用任意会话时区查看
+SET timezone = 'UTC';
+SELECT * FROM system_logs;
 ```
 
+结果：
 ```
-SELECT *
-FROM test_tz;
+┌────────┬───────────────────────────┐
+│ log_id │ log_time                  │
+├────────┼───────────────────────────┤
+│      1 │ 2024-01-15 14:00:00+08:00 │
+│      2 │ 2024-01-15 06:00:00+00:00 │
+│      3 │ 2024-01-15 01:00:00-05:00 │
+└────────┴───────────────────────────┘
 ```
 
-结果:
+```sql
+-- 更改会话时区
+SET timezone = 'Asia/Shanghai';
+SELECT * FROM system_logs;
+```
 
+结果：
 ```
-┌───────────────────────────────────────┐
-│        id       │          t          │
-├─────────────────┼─────────────────────┤
-│               1 │ 2022-02-03 03:00:00 │
-│               2 │ 2022-02-02 19:00:00 │
-│               3 │ 2022-02-03 11:00:00 │
-│               4 │ 2022-02-03 00:00:00 │
-│               5 │ 2022-02-02 18:00:00 │
-│               6 │ 2022-02-02 21:00:00 │
-└───────────────────────────────────────┘
+┌────────┬───────────────────────────┐
+│ log_id │ log_time                  │
+├────────┼───────────────────────────┤
+│      1 │ 2024-01-15 14:00:00+08:00 │
+│      2 │ 2024-01-15 06:00:00+00:00 │
+│      3 │ 2024-01-15 01:00:00-05:00 │
+└────────┴───────────────────────────┘
 ```
 
-```sql
--- 将时区更改为 Asia/Shanghai
-SET timezone = 'Asia/Shanghai';
+时区偏移始终被保留并显示。
 
--- 使用新的时区设置从表中选择数据
-SELECT *
-FROM test_tz;
-```
+:::note
+TIMESTAMP_TZ 只存储数值偏移（如 `+08:00`），而不存储时区名称。该偏移量不会随夏令时变化而自动调整。
+:::
 
-结果:
+## 选择合适的类型
 
-```
-┌───────────────────────────────────────┐
-│        id       │          t          │
-├─────────────────┼─────────────────────┤
-│               1 │ 2022-02-03 11:00:00 │
-│               2 │ 2022-02-03 03:00:00 │
-│               3 │ 2022-02-03 19:00:00 │
-│               4 │ 2022-02-03 08:00:00 │
-│               5 │ 2022-02-03 02:00:00 │
-│               6 │ 2022-02-03 05:00:00 │
-└───────────────────────────────────────┘
-```
+- 使用 **DATE** 存储不包含时间信息的日历日期
+- 使用 **TIMESTAMP** 当您希望时间在每个用户的本地时区显示
+- 使用 **TIMESTAMP_TZ** 当您需要保留原始时区上下文
 
 ## 函数