日期与时间
日期与时间数据类型
| 名称 | 别名 | 存储大小 | 分辨率 | 最小值 | 最大值 | 描述 |
|---|---|---|---|---|---|---|
| DATE | 4 字节 | 天 | 1000-01-01 | 9999-12-31 | YYYY-MM-DD | |
| TIMESTAMP | DATETIME | 8 字节 | 微秒 | 1000-01-01 00:00:00 | 9999-12-31 23:59:59.999999 UTC | YYYY-MM-DD hh:mm:ss[.fraction]，最高可达微秒（6 位）精度 |
示例
CREATE TABLE test_dt
(
date DATE,
ts TIMESTAMP
);
DESC test_dt;
结果:
┌────────────────────────────────────────────────┐
│ 字段 │ 类型 │ 空值 │ 默认值 │ 额外 │
├────────┼───────────┼────────┼─────────┼────────┤
│ date │ DATE │ 是 │ NULL │ │
│ ts │ TIMESTAMP │ 是 │ NULL │ │
└────────────────────────────────────────────────┘
TIMESTAMP 值可以选择性地包含尾随的微秒部分，最高可达微秒（6 位）精度。
-- 向表中插入值
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;
结果:
┌─────────────────────────────────────────────┐
│ date │ ts │
├────────────────┼────────────────────────────┤
│ 2022-04-07 │ 2022-04-07 01:01:01.123456 │
│ 2022-04-08 │ 2022-04-08 01:01:01 │
└─────────────────────────────────────────────┘
Databend 识别多种 TIMESTAMP 格式。
-- 创建一个表来测试不同的 timestamp 格式
CREATE TABLE test_formats (
id INT,
a TIMESTAMP
);
-- 插入不同格式的 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');
SELECT *
FROM test_formats;
结果:
┌───────────────────────────────────────┐
│ 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 │
└───────────────────────────────────────┘
Databend 会根据您当前的时区自动调整并显示 TIMESTAMP 值。
-- 创建一个表来测试带有时区调整的 timestamp 值
CREATE TABLE test_tz (
id INT,
t TIMESTAMP
);
-- 设置时区为 UTC
SET timezone = 'UTC';
-- 插入考虑不同时区的 timestamp 值
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');
SELECT *
FROM test_tz;
结果:
┌───────────────────────────────────────┐
│ 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 │
└───────────────────────────────────────┘
-- 将时区更改为 Asia/Shanghai
SET timezone = 'Asia/Shanghai';
-- 使用新的时区设置从表中选择数据
SELECT *
FROM test_tz;
结果:
┌───────────────────────────────────────┐
│ 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 │
└───────────────────────────────────────┘
函数
参见 日期与时间函数。
处理夏令时调整
在某些地区，实行夏令时。在夏令时开始的那一天，时钟会向前拨快一小时。Databend 通过 enable_dst_hour_fix 设置来管理夏令时调整。启用后，Databend 会自动将时间提前一小时（例如，2:10 AM 将被处理为 3:10 AM）。
例如，多伦多的夏令时于 2024 年 3 月 10 日凌晨 2:00 开始。因此，当天 2:00 AM 到 3:00 AM 之间的时间不存在。Databend 依赖 Chrono 来确定每个时区的夏令时。如果提供了该范围内的某个时间，Databend 将返回错误：
SET timezone = 'America/Toronto';
SELECT to_datetime('2024-03-10 02:01:00');
error: APIError: ResponseError with 1006: cannot parse to type `TIMESTAMP`. BadArguments. Code: 1006, Text = unexpected argument. while evaluating function `to_timestamp('2024-03-10 02:01:00')` in expr `to_timestamp('2024-03-10 02:01:00')`
要修复此类错误，您可以启用 enable_dst_hour_fix 设置以将时间提前一小时：
SET enable_dst_hour_fix = 1;
SELECT to_datetime('2024-03-10 02:01:00');
┌───────────────────────────────── ───┐
│ to_datetime('2024-03-10 02:01:00') │
├────────────────────────────────────┤
│ 2024-03-10 03:01:00 │
└────────────────────────────────────┘
处理无效值
Databend 会自动将无效的 Date 或 Timestamp 值转换为其最小有效等价值，1000-01-01 用于日期，1000-01-01 00:00:00 用于时间戳，以确保在处理超出范围或格式错误的日期和时间戳时保持一致性。
示例:
-- 尝试将最大日期加一天，超出有效范围。
-- 结果: 返回 DateMIN (1000-01-01) 而不是错误。
SELECT ADD_DAYS(TO_DATE('9999-12-31'), 1);
┌────────────────────────────────────┐
│ add_days(to_date('9999-12-31'), 1) │
├────────────────────────────────────┤
│ 1000-01-01 │
└────────────────────────────────────┘
-- 尝试从最小日期减去一分钟，这将无效。
-- 结果: 返回 DateMIN (1000-01-01 00:00:00)，确保结果的稳定性。
SELECT SUBTRACT_MINUTES(TO_DATE('1000-01-01'), 1);
┌────────────────────────────────────────────┐
│ subtract_minutes(to_date('1000-01-01'), 1) │
├────────────────────────────────────────────┤
│ 1000-01-01 00:00:00 │
└────────────────────────────────────────────┘
格式化日期与时间
在 Databend 中，某些日期和时间函数如 TO_DATE 和 TO_TIMESTAMP 要求您指定所需的日期和时间值格式。为了处理日期和时间格式化，Databend 使用了 chrono::format::strftime 模块，这是 Rust 中 chrono 库提供的一个标准模块。该模块允许对日期和时间进行精确的格式控制。以下内容摘自 https://docs.rs/chrono/latest/chrono/format/strftime/index.html：
| Spec. | 示例 | 描述 |
|---|---|---|
| 日期说明符： | ||
| %Y | 2001 | 完整的公历年份，零填充到4位数字。chrono支持从-262144到262143的年份。注意：公元前1年之前或公元9999年之后的年份，需要一个初始符号（+/-）。 |
| %C | 20 | 公历年份除以100，零填充到2位数字。 |
| %y | 01 | 公历年份模100，零填充到2位数字。 |
| %m | 07 | 月份编号（01–12），零填充到2位数字。 |
| %b | Jul | 缩写的月份名称。总是3个字母。 |
| %B | July | 完整的月份名称。在解析时也接受相应的缩写。 |
| %h | Jul | 与%b相同。 |
| %d | 08 | 日期编号（01–31），零填充到2位数字。 |
| %e | 8 | 与%d相同但空格填充。与%_d相同。 |
| %a | Sun | 缩写的星期几名称。总是3个字母。 |
| %A | Sunday | 完整的星期几名称。在解析时也接受相应的缩写。 |
| %w | 0 | 星期日 = 0，星期一 = 1，…，星期六 = 6。 |
| %u | 7 | 星期一 = 1，星期二 = 2，…，星期日 = 7。（ISO 8601） |
| %U | 28 | 从星期日开始计算的周数（00–53），零填充到2位数字。 |
| %W | 27 | 与%U相同，但第1周从该年的第一个星期一开始。 |
| %G | 2001 | 与%Y相同但使用ISO 8601周日期中的年份编号。 |
| %g | 01 | 与%y相同但使用ISO 8601周日期中的年份编号。 |
| %V | 27 | 与%U相同但使用ISO 8601周日期中的周数（01–53 ）。 |
| %j | 189 | 一年中的第几天（001–366），零填充到3位数字。 |
| %D | 07/08/01 | 月-日-年格式。与%m/%d/%y相同。 |
| %x | 07/08/01 | 本地化的日期表示（例如，12/31/99）。 |
| %F | 2001-07-08 | 年-月-日格式（ISO 8601）。与%Y-%m-%d相同。 |
| %v | 8-Jul-2001 | 日-月-年格式。与%e-%b-%Y相同。 |
| 时间说明符： | ||
| %H | 00 | 小时编号（00–23），零填充到2位数字。 |
| %k | 0 | 与%H相同但空格填充。与%_H相同。 |
| %I | 12 | 12小时制的小时编号（01–12），零填充到2位数字。 |
| %l | 12 | 与%I相同但空格填充。与%_I相同。 |
| %P | am | 12小时制的am或pm。 |
| %p | AM | 12小时制的AM或PM。 |
| %M | 34 | 分钟编号（00–59），零填充到2位数字。 |
| %S | 60 | 秒编号（00–60），零填充到2位数字。 |
| %f | 026490000 | 自上次整秒以来的分数秒（以纳秒为单位）。 |
| %.f | .026490 | 类似于.%f但左对齐。这些都消耗前导点。 |
| %.3f | .026 | 类似于.%f但左对齐但固定为长度3。 |
| %.6f | .026490 | 类似于.%f但左对齐但固定为长度6。 |
| %.9f | .026490000 | 类似于.%f但左对齐但固定为长度9。 |
| %3f | 026 | 类似于%.3f但没有前导点。 |
| %6f | 026490 | 类似于%.6f但没有前导点。 |
| %9f | 026490000 | 类似于%.9f但没有前导点。 |
| %R | 00:34 | 小时-分钟格式。与%H:%M相同。 |
| %T | 00:34:60 | 小时-分钟-秒格式。与%H:%M:%S相同。 |
| %X | 00:34:60 | 本地化的时间表示（例如，23:13:48）。 |
| %r | 12:34:60 AM | 12小时制的小时-分钟-秒格式。与%I:%M:%S %p相同。 |
| 时区说明符： | ||
| %Z | ACST | 本地时区名称。在解析时跳过所有非空白字符。 |
| %z | +0930 | 本地时间到UTC的偏移量（UTC为+0000）。 |
| %:z | +09:30 | 与%z相同但带有冒号。 |
| %::z | +09:30:00 | 本地时间到UTC的偏移量，带有秒。 |
| %:::z | +09 | 本地时间到UTC的偏移量，不带分钟。 |
| %#z | +09 | 仅解析：与%z相同但允许分钟缺失或存在。 |
| 日期和时间说明符： | ||
| %c | Sun Jul 8 00:34:60 2001 | 本地化的日期和时间（例如，Thu Mar 3 23:05:25 2005）。 |
| %+ | 2001-07-08T00:34:60.026490+09:30 | ISO 8601 / RFC 3339日期和时间格式。 |
| %s | 994518299 | UNIX时间戳，自1970-01-01 00:00 UTC以来的秒数。Databend建议首先将整数字符串转换为整数，而不是使用此说明符。有关示例，请参见将整数转换为时间戳。 |
| 特殊说明符： | ||
| %t | 文字制表符（\t）。 | |
| %n | 文字换行符（\n）。 | |
| %% | 文字百分号。 |
可以覆盖数字说明符 %? 的默认填充行为。其他说明符不允许这样做，并且会导致 BAD_FORMAT 错误。
| 修饰符 | 描述 |
|---|---|
| %-? | 抑制任 何填充，包括空格和零。（例如 %j = 012, %-j = 12） |
| %_? | 使用空格作为填充。（例如 %j = 012, %_j = 12） |
| %0? | 使用零作为填充。（例如 %e = 9, %0e = 09） |
-
%C, %y: 这是向下取整的除法，所以公元前 100 年（年份编号 -99）将分别打印 -1 和 99。
-
%U: 第 1 周从该年的第一个星期日开始。在第一个星期日之前的日期可能会有第 0 周。
-
%G, %g, %V: 第 1 周是该年至少有 4 天的第一周。不存在第 0 周，因此应与 %G 或 %g 一起使用。
-
%S: 它考虑了闰秒，因此可能为 60。
-
%f, %.f, %.3f, %.6f, %.9f, %3f, %6f, %9f: 默认的 %f 是右对齐的，并且总是填充到 9 位数字以与 glibc 和其他兼容，因此它总是计算自上一个整秒以来的纳秒数。例如，在上一个整秒之后的 7 毫秒将打印 007000000，解析 7000000 将得到相同的结果。
变体 %.f 是左对齐的，并根据精度打印 0、3、6 或 9 位小数。例如，在上一个整秒之后的 70 毫秒在 %.f 下将打印 .070（注意：不是 .07），解析 .07、.070000 等将得到相同的结果。请注意，如果小数部分为零或下一个字符不是 .，它们可以打印或读取为空。
变体 %.3f、%.6f 和 %.9f 是左对齐的，并根据前面的数字打印 3、6 或 9 位小数。例如，在上一个整秒之后的 70 毫秒在 %.3f 下将打印 .070（注意：不是 .07），解析 .07、.070000 等将得到相同的结果。请注意，如果小数部分为零或下一个字符不是 .，它们可以读取为空，但会以指定长度打印。
变体 %3f、%6f 和 %9f 是左对齐的，并根据前面的数字打印 3、6 或 9 位小数，但没有前导点。例如，在上一个整秒之后的 70 毫秒在 %3f 下将打印 070（注意：不是 07），解析 07、070000 等将得到相同的结果。请注意 ，如果小数部分为零，它们可以读取为空。
-
%Z: 偏移量不会从解析的数据中填充，也不会被验证。时区完全被忽略。类似于 glibc strptime 对此格式代码的处理。
不可能可靠地从缩写转换为偏移量，例如 CDT 可以表示北美中部夏令时或中国夏令时。
-
%+: 与 %Y-%m-%dT%H:%M:%S%.f%:z 相同，即秒的小数部分为 0、3、6 或 9 位，时区偏移中有冒号。
此格式还支持在 %:z 的位置使用 Z 或 UTC。它们等同于 +00:00。
请注意，所有 T、Z 和 UTC 都是不区分大小写解析的。
典型的 strftime 实现对此说明符有不同的（且依赖于本地化的）格式。虽然 Chrono 的 %+ 格式更加稳定，但如果您想要控制确切的输出，最好避免使用此说明符。
-
%s: 这不填充且可以为负数。对于 Chrono 来说，它只考虑非闰秒，因此与 ISO C strftime 行为略有不同。
