CURRENT_DATE

CURRENT_DATE函数用于获取指定时区time_zone的当前日期,并以DATE类型返回。

命令格式

DATE CURRENT_DATE([STRING <time_zone>])

-- 标准示例。
-- 返回2025-09-24。
SELECT CURRENT_DATE('Asia/Shanghai');

参数说明

time_zone:可选。指定时区,STRING类型。例如Asia/ShanghaiUTC+08:00+8。若未指定时区,则默认为当前Session/Project的时区。

说明

若未修改过项目时区,则默认为东八区(UTC+08:00)。

返回值说明

返回DATE类型。若输入参数为NULL,则返回NULL。

使用示例

下述示例中,当前项目时区设置为Asia/Shanghai,时间为2025-09-24 17:08:32.274。

  • 示例1:默认time_zone,获取当前Session/Project时区的时间值。

    -- 返回当前Session/Project时区的日期。
    -- 返回2025-09-24。
    SELECT CURRENT_DATE();
  • 示例2:获取夏威夷时区(UTC-10:00)的当前日期。

    -- 返回2025-09-23。
    SELECT CURRENT_DATE('Pacific/Honolulu');
    
    -- 等价于上面写法,返回2025-09-23。
    SELECT CURRENT_DATE('UTC-10:00');
    
    -- 等价于上面写法,返回2025-09-23。
    SELECT CURRENT_DATE('-10');
  • 示例3:若输入参数为NULL,则返回NULL。

    -- 返回NULL。
    SELECT CURRENT_DATE(NULL);

相关函数

CURRENT_DATE函数属于日期函数,更多日期计算、日期转换的相关函数请参见日期函数