TIMESTAMPTZ（Time Stamp with Time Zone）用于存储包含日期、时间的完整数值，并能够自动处理时区转换。说明：
提示： 在 TCHouse-X 中，
TIMESTAMP 是 TIMESTAMPTZ 的别名。核心属性
字段构成：可拆分为年、月、日、时、分、秒。
时区支持：包含本地时区信息。默认情况下，系统以 UTC 格式存储，但在写入、读取或与系统时间交互时，使用本地时区进行解释。
存储精度：支持 微秒（Microsecond）级别。
取值范围：
0001-01-01 至 9999-12-31。超出此范围的值将转换为 NULL。语法说明
列定义
在
CREATE TABLE 语句中，以下两种写法等效：column_name TIMESTAMPcolumn_name TIMESTAMPTZ
运算表达式
支持使用
INTERVAL 关键字或日期函数进行时间偏移计算：timestamp_value [+|-] INTERVAL 'interval_expression'
interval_expression 定义见下方 INTERVAL 表达式介绍。INTERVAL 表达式
可以使用
INTERVAL 配合运算符实现灵活的时间加减。支持单位：
YEAR[S], MONTH[S], WEEK[S], DAY[S], HOUR[S], MINUTE[S], SECOND[S]。限制条件：
INTERVAL 表达式仅能指定一种单位。INTERVAL 数值需要为整数。复合运算示例：
-- 通过连续计算实现任意粒度的偏移SELECT CAST('2025-01-01 01:00:00' as TIMESTAMP) + INTERVAL '3 WEEKS' - INTERVAL '1 DAY';
数据转换与格式规范
字符串解析
TCHouse-X 会自动解析符合特定格式的字符串。
标准格式：
'yyyy-MM-dd HH:mm:ss.SSSSSS'。弹性规则：
可仅包含日期（如
'1966-07-30'）。小数秒部分可省略。
各部分数字的前导零可省略（如
'2018-1-1 1:2:3'）。时区指定：支持带时区名的字面量，如
'2024-05-20 14:00:00 America/New_York'。转换时的特殊处理
1. 空白字符：自动忽略字符串两端的空格、制表符（
\\t）、换行（\\n）或回车（\\r）。2. 分隔符：在
CAST() 显式转换中，日期与时间之间支持使用“一个或多个空格”或“字符 T”。3. 安全性：如果字符串格式不符合要求，转换结果为
NULL 而不会触发系统报错。4. 2038年问题：在涉及 UNIX 时间戳的函数（如
FROM_UNIXTIME）中，系统内部使用 BIGINT 处理，彻底规避了传统 32 位 INT 溢出的风险。分区注意事项
TIMESTAMP 列不可以作为分区键。基础转换与函数示例
-- 显式转换示例SELECT CAST('1966-07-30' AS TIMESTAMP);SET TIMEZONE = 'Asia/Shanghai';SELECT CAST('2024-05-20 14:00:00 America/New_York' AS TIMESTAMP); -- 返回2024-05-21 02:00:00-- 将按本地时区(如 Asia/Shanghai)返回对应时间，纽约使用东部时区（ET），且2024年5月20日处于夏令时（EDT，UTC-4），-- 北京时间是 UTC+8，所以纽约时间比北京时间晚12个小时-- 常用日期函数SELECT HOUR('1970-01-01 15:30:00'); -- 返回 15SELECT DAYOFWEEK('2004-06-13'); -- 返回 1 (星期日)SELECT DATE_ADD('2004-06-13', 365); -- 返回 '2005-06-13 00:00:00'SELECT DATEDIFF('1989-12-31', '1984-09-01'); -- 计算间隔天数SELECT NOW(); -- 返回当前本地时间
表操作示例
CREATE TABLE dates_and_times (t TIMESTAMP);INSERT INTO dates_and_times VALUES('1966-07-30'),('1985-09-25 17:45:30.005'),('08:30:00');SELECT * FROM dates_and_times;+-------------------------+| t |+-------------------------+| 1966-07-30 00:00:00 || 1985-09-25 17:45:30.005 || NULL |+-------------------------+
