Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Interval

View as MarkdownEdit this pageReport an issueSet up docs MCP

表示时间和日期时间隔的数据类型家族。INTERVAL 运算符的结果类型。

结构：

  • 以无符号整数值表示的时间间隔。
  • 时间间隔的类型。

支持的时间间隔类型：

  • NANOSECOND
  • MICROSECOND
  • MILLISECOND
  • SECOND
  • MINUTE
  • HOUR
  • DAY
  • WEEK
  • MONTH
  • QUARTER
  • YEAR

每种时间间隔类型都有各自独立的数据类型。例如，DAY 时间间隔对应 IntervalDay 数据类型：

SELECT toTypeName(INTERVAL 4 DAY)
┌─toTypeName(toIntervalDay(4))─┐
│ IntervalDay                  │
└──────────────────────────────┘

使用说明

您可以将 Interval 类型的值与 Date 和 DateTime 类型的值进行算术运算。例如，可以在当前时间上加 4 天：

SELECT now() AS current_date_time, current_date_time + INTERVAL 4 DAY
┌───current_date_time─┬─plus(now(), toIntervalDay(4))─┐
│ 2019-10-23 10:58:45 │           2019-10-27 10:58:45 │
└─────────────────────┴───────────────────────────────┘

也可以同时使用多个时间间隔：

SELECT now() AS current_date_time, current_date_time + (INTERVAL 4 DAY + INTERVAL 3 HOUR)
┌───current_date_time─┬─plus(current_date_time, plus(toIntervalDay(4), toIntervalHour(3)))─┐
│ 2024-08-08 18:31:39 │                                                2024-08-12 21:31:39 │
└─────────────────────┴────────────────────────────────────────────────────────────────────┘

以及比较不同时间间隔的值：

SELECT toIntervalMicrosecond(179999999) < toIntervalMinute(3);
┌─less(toIntervalMicrosecond(179999999), toIntervalMinute(3))─┐
│                                                           1 │
└─────────────────────────────────────────────────────────────┘
SELECT toIntervalMicrosecond(3600000000) = toIntervalHour(1);
┌─equals(toIntervalMicrosecond(3600000000), toIntervalHour(1))─┐
│                                                            1 │
└──────────────────────────────────────────────────────────────┘

混合类型时间间隔

混合类型的时间间隔 (例如同时包含多个小时和多个分钟) 可以使用 INTERVAL 'value' <from_kind> TO <to_kind> 语法创建。 结果是一个由两个或多个时间间隔组成的元组。

支持的组合：

语法 字符串格式 示例
YEAR TO MONTH Y-M INTERVAL '2-6' YEAR TO MONTH
DAY TO HOUR D H INTERVAL '5 12' DAY TO HOUR
DAY TO MINUTE D H:M INTERVAL '5 12:30' DAY TO MINUTE
DAY TO SECOND D H:M:S INTERVAL '5 12:30:45' DAY TO SECOND
HOUR TO MINUTE H:M INTERVAL '1:30' HOUR TO MINUTE
HOUR TO SECOND H:M:S INTERVAL '1:30:45' HOUR TO SECOND
MINUTE TO SECOND M:S INTERVAL '5:30' MINUTE TO SECOND

非首位字段会按照 SQL 标准进行校验：MONTH 为 0-11，HOUR 为 0-23，MINUTE 为 0-59，SECOND 为 0-59。

SELECT INTERVAL '1:30' HOUR TO MINUTE;
┌─(toIntervalHour(1), toIntervalMinute(30))─┐
│ (1,30)                                     │
└────────────────────────────────────────────┘

可选的前导 + 或 - 符号适用于所有部分：

SELECT INTERVAL '+1:30' HOUR TO MINUTE;
-- 等价于：
-- SELECT INTERVAL '1:30' HOUR TO MINUTE;
┌─(toIntervalHour(1), toIntervalMinute(30))─┐
│ (1,30)                                     │
└────────────────────────────────────────────┘

另请参阅

Navigation