DateTime64
允许存储时间点,可以用日历日期和一天中的时间表示,并具有定义的亚秒级精度
刻度大小(精度):10-precision 秒。有效范围[ 0 : 9 ]. 通常使用 - 3(毫秒)、6(微秒)、9(纳秒)。
语法
DateTime64(precision, [timezone])
在内部,将数据存储为自纪元开始(1970-01-01 00:00:00 UTC)以来的“刻度”数作为 Int64。刻度分辨率由 precision 参数确定。此外,DateTime64
类型可以存储适用于整个列的时区,这会影响 DateTime64
类型值的文本格式显示方式以及字符串指定的值的解析方式('2020-01-01 05:00:01.000')。时区不存储在表的行中(或结果集中),而是存储在列元数据中。详细信息请参阅DateTime。
支持的值范围[1900-01-01 00:00:00, 2299-12-31 23:59:59.99999999]
注意:最大值的精度为 8。如果使用 9 位(纳秒)的最大精度,则 UTC 中支持的最大值为 2262-04-11 23:47:16
。
示例
- 创建具有
DateTime64
类型列的表并向其中插入数据
CREATE TABLE dt64
(
`timestamp` DateTime64(3, 'Asia/Istanbul'),
`event_id` UInt8
)
ENGINE = TinyLog;
-- Parse DateTime
-- - from integer interpreted as number of seconds since 1970-01-01.
-- - from string,
INSERT INTO dt64 VALUES (1546300800123, 1), (1546300800.123, 2), ('2019-01-01 00:00:00', 3);
SELECT * FROM dt64;
┌───────────────timestamp─┬─event_id─┐
│ 2019-01-01 03:00:00.123 │ 1 │
│ 2019-01-01 03:00:00.123 │ 2 │
│ 2019-01-01 00:00:00.000 │ 3 │
└─────────────────────────┴──────────┘
- 插入日期时间作为整数时,它将被视为适当缩放的 Unix 时间戳(UTC)。
1546300800000
(精度为 3)表示 UTC 中的'2019-01-01 00:00:00'
。但是,由于timestamp
列指定了Asia/Istanbul
(UTC+3)时区,因此在输出为字符串时,该值将显示为'2019-01-01 03:00:00'
。插入日期时间作为小数将类似于整数进行处理,除了小数点前的值为包括秒在内的 Unix 时间戳,小数点后的值将被视为精度。 - 插入字符串值作为日期时间时,它将被视为处于列时区。
'2019-01-01 00:00:00'
将被视为处于Asia/Istanbul
时区并存储为1546290000000
。
- 对
DateTime64
值进行过滤
SELECT * FROM dt64 WHERE timestamp = toDateTime64('2019-01-01 00:00:00', 3, 'Asia/Istanbul');
┌───────────────timestamp─┬─event_id─┐
│ 2019-01-01 00:00:00.000 │ 3 │
└─────────────────────────┴──────────┘
与 DateTime
不同,DateTime64
值不会自动从 String
转换。
SELECT * FROM dt64 WHERE timestamp = toDateTime64(1546300800.123, 3);
┌───────────────timestamp─┬─event_id─┐
│ 2019-01-01 03:00:00.123 │ 1 │
│ 2019-01-01 03:00:00.123 │ 2 │
└─────────────────────────┴──────────┘
与插入相反,toDateTime64
函数将所有值视为小数变体,因此需要在小数点后给出精度。
- 获取
DateTime64
类型值的时区
SELECT toDateTime64(now(), 3, 'Asia/Istanbul') AS column, toTypeName(column) AS x;
┌──────────────────column─┬─x──────────────────────────────┐
│ 2023-06-05 00:09:52.000 │ DateTime64(3, 'Asia/Istanbul') │
└─────────────────────────┴────────────────────────────────┘
- 时区转换
SELECT
toDateTime64(timestamp, 3, 'Europe/London') as lon_time,
toDateTime64(timestamp, 3, 'Asia/Istanbul') as istanbul_time
FROM dt64;
┌────────────────lon_time─┬───────────istanbul_time─┐
│ 2019-01-01 00:00:00.123 │ 2019-01-01 03:00:00.123 │
│ 2019-01-01 00:00:00.123 │ 2019-01-01 03:00:00.123 │
│ 2018-12-31 21:00:00.000 │ 2019-01-01 00:00:00.000 │
└─────────────────────────┴─────────────────────────┘
另请参阅