📣

TiDB Cloud Premium 开放公测中。为企业级工作负载提供无限扩展、即时弹性伸缩和高级安全保障。此页面由 AI 自动翻译，英文原文请见此处。

日期与时间函数

本页按功能分类，全面概述了 TiDB Cloud Lake 中的日期与时间函数，便于快速查阅。

当前日期与时间函数

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

日期与时间提取函数

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

日期与时间转换函数

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

日期与时间算术函数

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

日期与时间截断函数

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

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

其他日期与时间函数

Function	描述	示例
TIMEZONE	返回当前时区	`TIMEZONE()` → `'UTC'`
TIME_SLOT	返回时间槽	`TIME_SLOT('2024-06-04 12:30:45', 15, 'MINUTE')` → `2024-06-04 12:30:00`

文档内容是否有帮助？