跳到主要内容

日期和时间函数

本页面全面概述了 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'`

日期和时间算术函数

函数	描述	示例
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`
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`

当前日期和时间函数
日期和时间提取函数
日期和时间转换函数
日期和时间算术函数
日期和时间截断函数
日期和时间导航函数
其他日期和时间函数

开始使用 Databend Cloud

低成本

快速分析

多种数据源

弹性扩展