日期与时间函数
本文按功能分类整理了 Databend 中的所有日期时间函数，方便您快速查找使用。
当前日期与时间函数
| 函数 | 描述 | 示例 |
|---|---|---|
| NOW | 获取当前日期和时间 | NOW() → 2024-06-04 17:42:31.123456 |
| CURRENT_TIMESTAMP | 获取当前日期和时间 | CURRENT_TIMESTAMP() → 2024-06-04 17:42:31.123456 |
| TODAY | 返回当前日期 | TODAY() → 2024-06-04 |
| TOMORROW | 获取明天的日期 | TOMORROW() → 2024-06-05 |
| YESTERDAY | 获取昨天的日期 | YESTERDAY() → 2024-06-03 |
日期与时间提取函数
| 函数 | 描述 | 示例 |
|---|---|---|
| YEAR | 提取年份 | YEAR('2024-06-04') → 2024 |
| MONTH | 提取月份 | MONTH('2024-06-04') → 6 |
| DAY | 提取日期 | DAY('2024-06-04') → 4 |
| QUARTER | 提取季度 | QUARTER('2024-06-04') → 2 |
| WEEK / WEEKOFYEAR | 提取周数 | WEEK('2024-06-04') → 23 |
| EXTRACT | 提取日期的指定部分 | EXTRACT(MONTH FROM '2024-06-04') → 6 |
| DATE_PART | 提取日期的指定部分 | DATE_PART('month', '2024-06-04') → 6 |
| YEARWEEK | 获取年份和周数 | YEARWEEK('2024-06-04') → 202423 |
| MILLENNIUM | 获取日期所在的千年 | MILLENNIUM('2024-06-04') → 3 |
日期与时间转换函数
| 函数 | 描述 | 示例 |
|---|---|---|
| DATE | 转换为 DATE 类型 | DATE('2024-06-04') → 2024-06-04 |
| TO_DATE | 字符串转 DATE 类型 | TO_DATE('2024-06-04') → 2024-06-04 |
| TO_DATETIME | 字符串转 DATETIME 类型 | TO_DATETIME('2024-06-04 12:30:45') → 2024-06-04 12:30:45 |
| TO_TIMESTAMP | 字符串转 TIMESTAMP 类型 | TO_TIMESTAMP('2024-06-04 12:30:45') → 2024-06-04 12:30:45 |
| TO_UNIX_TIMESTAMP | 日期转 Unix 时间戳 | TO_UNIX_TIMESTAMP('2024-06-04') → 1717516800 |
| TO_YYYYMM | 格式化为 YYYYMM | TO_YYYYMM('2024-06-04') → 202406 |
| TO_YYYYMMDD | 格式化为 YYYYMMDD | TO_YYYYMMDD('2024-06-04') → 20240604 |
| TO_YYYYMMDDHH | 格式化为 YYYYMMDDHH | TO_YYYYMMDDHH('2024-06-04 12:30:45') → 2024060412 |
| TO_YYYYMMDDHHMMSS | 格式化为 YYYYMMDDHHMMSS | TO_YYYYMMDDHHMMSS('2024-06-04 12:30:45') → 20240604123045 |
| DATE_FORMAT | 按指定格式格式化日期 | DATE_FORMAT('2024-06-04', '%Y-%m-%d') → '2024-06-04' |
| CONVERT_TIMEZONE | 转换时间戳至目标时区 | CONVERT_TIMEZONE('America/Los_Angeles', '2024-11-01 11:36:10') → 2024-10-31 20:36:10 |
日期与时间算术函数
| 函数 | 描述 | 示例 |
|---|---|---|
| DATE_ADD | 添加时间间隔 | DATE_ADD(DAY, 7, '2024-06-04') → 2024-06-11 |
| DATE_SUB | 减去时间间隔 | DATE_SUB(MONTH, 1, '2024-06-04') → 2024-05-04 |
| ADD INTERVAL | 添加时间间隔 | '2024-06-04' + INTERVAL 1 DAY → 2024-06-05 |
| SUBTRACT INTERVAL | 减去时间间隔 | '2024-06-04' - INTERVAL 1 MONTH → 2024-05-04 |
| DATE_DIFF | 计算日期差值 | DATE_DIFF(DAY, '2024-06-01', '2024-06-04') → 3 |
| TIMESTAMP_DIFF | 计算时间戳差值 | TIMESTAMP_DIFF(HOUR, '2024-06-04 10:00:00', '2024-06-04 15:00:00') → 5 |
| MONTHS_BETWEEN | 计算月份差值 | MONTHS_BETWEEN('2024-06-04', '2024-01-04') → 5 |
| DATE_BETWEEN | 判断日期是否在指定范围内 | DATE_BETWEEN('2024-06-04', '2024-06-01', '2024-06-10') → true |
| AGE | 计算时间差 | AGE('2000-01-01'::TIMESTAMP, '1990-05-15'::TIMESTAMP) → 9 years 7 months 17 days |
| ADD_MONTHS | 添加月份（智能处理月末） | ADD_MONTHS('2025-04-30',1) → 2025-05-31 |
日期与时间截断函数
| 函数 | 描述 | 示例 |
|---|---|---|
| DATE_TRUNC | 按精度截断时间戳 | DATE_TRUNC('month', '2024-06-04') → 2024-06-01 |
| TIME_SLICE | 时间分片 | TIME_SLICE('2024-06-04', 4, 'MONTH', 'START') → 2024-05-01 |
| TO_START_OF_DAY | 获取当天开始时间 | TO_START_OF_DAY('2024-06-04 12:30:45') → 2024-06-04 00:00:00 |
| TO_START_OF_HOUR | 获取小时开始时间 | TO_START_OF_HOUR('2024-06-04 12:30:45') → 2024-06-04 12:00:00 |
| TO_START_OF_MINUTE | 获取分钟开始时间 | TO_START_OF_MINUTE('2024-06-04 12:30:45') → 2024-06-04 12:30:00 |
| TO_START_OF_MONTH | 获取月份第一天 | TO_START_OF_MONTH('2024-06-04') → 2024-06-01 |
| TO_START_OF_QUARTER | 获取季度第一天 | TO_START_OF_QUARTER('2024-06-04') → 2024-04-01 |
| TO_START_OF_YEAR | 获取年份第一天 | TO_START_OF_YEAR('2024-06-04') → 2024-01-01 |
| TO_START_OF_WEEK | 获取周第一天 | TO_START_OF_WEEK('2024-06-04') → 2024-06-03 |
日期与时间导航函数
| 函数 | 描述 | 示例 |
|---|---|---|
| LAST_DAY | 获取月末日期 | LAST_DAY('2024-06-04') → 2024-06-30 |
| NEXT_DAY | 获取下一个指定星期几 | NEXT_DAY('2024-06-04', 'SUNDAY') → 2024-06-09 |
| PREVIOUS_DAY | 获取上一个指定星期几 | PREVIOUS_DAY('2024-06-04', 'MONDAY') → 2024-06-03 |
其他日期与时间函数
| 函数 | 描述 | 示例 |
|---|---|---|
| TIMEZONE | 获取当前时区 | TIMEZONE() → 'UTC' |
| TIME_SLOT | 获取时间槽 | TIME_SLOT('2024-06-04 12:30:45', 15, 'MINUTE') → 2024-06-04 12:30:00 |
