文档

日期与时间函数

更新时间:

SQL分析提供了常见的日期函数,您可以根据实际需要选择合适的日期函数,完成日期计算、日期转换。本文为您提供SQL分析支持的日期函数的命令格式、参数说明及示例,指导您使用日期函数完成开发。

函数

功能

ADD_MONTHS

计算日期值增加指定月数后的日期。

CURRENT_TIMESTAMP

返回当前TIMESTAMP类型的时间戳。

DATE_ADD

按照指定的幅度增减天数,与date_sub的增减逻辑相反。

DATE_SUB

按照指定的幅度增减天数,与date_add的增减逻辑相反。

DAY

返回日期值的天。

DAYOFMONTH

返回日期中日的值。

DAYOFWEEK

返回日期的星期值。

DAYOFYEAR

返回日期是当年中第几天。

EXTRACT

获取日期TIMESTAMP中指定单位的部分。

FROM_UNIXTIME

将数字型的UNIX值转换为日期值。

GETDATE

获取当前系统时间。

HOUR

返回日期小时部分的值。

INTERVAL_DAY_TIME

将STRING类型日期值转换为INTERVAL_DAY_TIME类型变量。

ISDATE

判断一个日期字符串能否根据指定的格式串转换为一个日期值。

LAST_DAY

返回日期值所在月份的最后一天日期。

LASTDAY

获取日期所在月的最后一天。

MINUTE

返回日期分钟部分的值。

MONTH

返回日期值所属月份。

MONTHS_BETWEEN

返回指定日期值间的月数。

NEXT_DAY

返回大于日期值且与指定周相匹配的第一个日期。

NOW

返回当前系统日期与时间。

QUARTER

返回日期值所属季度。

SECOND

返回日期秒数部分的值。

TO_CHAR

将日期按照指定格式转换为字符串。

TO_DATE

将指定格式的字符串转换为日期值。

UNIX_TIMESTAMP

将日期转换为整型的UNIX格式的日期值。

WEEKDAY

返回日期值是当前周的第几天。

WEEKOFYEAR

返回日期值位于当年的第几周。

YEAR

返回日期值的年。

ADD_MONTHS

  • 命令格式

    string add_months(date|datetime|timestamp|string <startdate>, int <num_months>)
  • 命令说明

    返回开始日期startdate增加num_months个月后的日期。

  • 参数说明

    • startdate:必填。DATE、DATETIME、TIMESTAMP或STRING类型,格式为yyyy-mm-ddyyyy-mm-dd hh:mi:ssyyyy-mm-dd hh:mi:ss.ff3。取值为STRING类型格式时,至少要包含yyyy-mm-dd且不含多余的字符串。

    • num_months:必填。INT型数值。

  • 返回值说明

    返回STRING类型的日期值,格式为yyyy-mm-dd。返回规则如下:

    • startdate非DATE、DATETIME、TIMESTAMP或STRING类型,或格式不符合要求时,返回NULL。

    • startdate值为NULL时,返回报错。

    • num_months值为NULL时,返回NULL。

  • 示例

  • --返回2017-05-14。
    select add_months('2017-02-14',3);
    
    --返回0017-05-14。
    select add_months('17-2-14',3);
    
    --返回2017-05-14。
    select add_months('2017-02-14 21:30:00',3);
    
    --返回NULL。
    select add_months('20170214',3);
    
    --返回NULL。
    select add_months('2017-02-14 21:30:00',null);

CURRENT_TIMESTAMP

  • 命令格式

    timestamp current_timestamp()
  • 命令说明

    返回当前TIMESTAMP类型的时间戳,值不固定。

  • 返回值说明

    返回TIMESTAMP类型。

  • 示例

    select current_timestamp(); 

DATE_ADD

  • 命令格式

    date date_add(date|timestamp|string <startdate>, bigint <delta>)
  • 命令说明

    按照delta幅度增减startdate日期的天数。如果您需要获取在当前时间基础上指定变动幅度的日期,请结合GETDATE函数使用。

    本命令与DATE_SUB的增减逻辑相反。

  • 参数说明

    • startdate:必填。起始日期值。支持DATE、DATETIME或STRING类型。

      如果参数为STRING类型,则会隐式转换为DATE类型后参与运算,且STRING参数格式至少要包含'yyyy-mm-dd'。例如'2019-12-27'

    • delta:必填。修改幅度。BIGINT类型。如果delta大于0,则delta小于0,则delta等于0,不增不减。

  • 返回值说明

    返回DATE类型,格式为yyyy-mm-dd。返回规则如下:

    • startdate非DATE、DATETIME或STRING类型时,返回报错。

    • startdate值为NULL时,返回报错。

    • delta值为NULL时,返回NULL。

  • 示例

  • --返回2005-03-01。加1天,结果超出当年2月份的最后1天,实际值为下个月的第1天。
    select date_add(datetime '2005-02-28 00:00:00', 1);
    
    --返回2005-02-27。减1天。
    select date_add(date '2005-02-28', -1);
    
    --返回2005-03-20。 
    select date_add('2005-02-28 00:00:00', 20);
    
    --假设当前时间为2020-11-17 16:31:44,返回2020-11-16。
    select date_add(getdate(),-1);
    
    --返回NULL。
    select date_add('2005-02-28 00:00:00', null);

DATE_SUB

  • 命令格式

    date date_sub(date|timestamp|string <startdate>, bigint <delta>)
  • 命令说明

    按照delta幅度增减startdate日期的天数。如果您需要获取在当前时间基础上指定变动幅度的日期,请结合GETDATE函数使用。

    本命令与DATE_ADD的增减逻辑相反。

  • 参数说明

    • startdate:必填。起始日期值。支持DATE、DATETIME或STRING类型。

      如果参数为STRING类型,则会隐式转换为DATE类型后参与运算,且STRING参数格式至少要包含'yyyy-mm-dd'。例如'2019-12-27'

    • delta:必填。修改幅度。BIGINT类型。如果delta大于0,则delta小于0,则delta等于0,不增不减。

  • 返回值说明

    返回DATE类型,格式为yyyy-mm-dd。返回规则如下:

    • startdate非DATE、DATETIME或STRING类型时,返回报错。

    • startdate值为NULL时,返回报错。

    • delta值为NULL时,返回NULL。

  • 示例

  • --返回2005-02-28。减1天,实际值为上个月的最后1天。
    select date_sub(datetime '2005-03-01 00:00:00', 1);
    
    --返回2005-03-01。增1天。
    select date_sub(date '2005-02-28', -1);
    
    --返回2005-02-27。减2天。 
    select date_sub('2005-03-01 00:00:00', 2);
    
    --假设当前时间为2021-09-10 16:31:44,返回2021-09-09。
    select date_sub(getdate(),1);
    
    --返回NULL。
    select date_sub('2005-03-01 00:00:00', null);

DAY

  • 命令格式

    int day(datetime|timestamp|date|string <date>)
  • 命令说明

    返回一个日期的天。

  • 参数说明

    date:必填。DATETIME、TIMESTAMP、DATE或STRING类型日期值,格式为yyyy-mm-ddyyyy-mm-dd hh:mi:ssyyyy-mm-dd hh:mi:ss.ff3。取值为STRING类型格式时,至少要包含yyyy-mm-dd且不含多余的字符串。

  • 返回值说明

    返回INT类型。返回规则如下:

    • date非DATETIME、TIMESTAMP、DATE或STRING类型,或格式不符合要求时,返回NULL。

    • date值为NULL时,返回NULL。

  • 示例

  • --返回1。
    select day('2014-09-01');
    
    --返回NULL。
    select day('20140901');
    
    
    --返回NULL。
    select day(null);

DAYOFMONTH

  • 命令格式

    int dayofmonth(datetime|timestamp|date|string <date>)
  • 命令说明

    返回日期中日的值。

  • 参数说明

    date:必填。DATETIME、TIMESTAMP、DATE或STRING类型日期值,格式为yyyy-mm-ddyyyy-mm-dd hh:mi:ssyyyy-mm-dd hh:mi:ss.ff3。取值为STRING类型格式时,至少要包含yyyy-mm-dd且不含多余的字符串。

  • 返回值说明

    返回INT类型。返回规则如下:

    • date非DATETIME、TIMESTAMP、DATE或STRING类型,或格式不符合要求时,返回NULL。

    • date值为NULL时,返回NULL。

  • 示例

  • --返回1。
    select dayofmonth('2014-09-01');
    
    --返回NULL。
    select dayofmonth('20140901');
    
    --返回NULL。
    select dayofmonth(null);

DAYOFWEEK

  • 命令格式

    int dayofweek(datetime|timestamp|date|string <date>)
  • 命令说明

    返回日期的星期值。

  • 参数说明

    date:必填。DATETIME、TIMESTAMP、DATE或STRING类型日期值,格式为yyyy-mm-ddyyyy-mm-dd hh:mi:ssyyyy-mm-dd hh:mi:ss.ff3。取值为STRING类型格式时,至少要包含yyyy-mm-dd且不含多余的字符串。

  • 返回值说明

    返回INT类型。返回规则如下:

    • date非DATETIME、TIMESTAMP、DATE或STRING类型,或格式不符合要求时,返回NULL。

    • date值为NULL时,返回NULL。

    • 返回值的取值范围为1~7,与星期的对应关系为1=Sunday, 2=Monday,...,7=Saturday。

  • 示例

    --返回5,即Thursday。
    SELECT dayofweek('2009-07-30');

DAYOFYEAR

  • 命令格式

    int dayofyear(datetime|timestamp|date|string <date>)
  • 命令说明

    返回日期是当年中的第几天。

  • 参数说明

    date:必填。DATETIME、TIMESTAMP、DATE或STRING类型日期值,格式为yyyy-mm-ddyyyy-mm-dd hh:mi:ssyyyy-mm-dd hh:mi:ss.ff3。取值为STRING类型格式时,至少要包含yyyy-mm-dd且不含多余的字符串。

  • 返回值说明

    返回INT类型。返回规则如下:

    • date非DATETIME、TIMESTAMP、DATE或STRING类型,或格式不符合要求时,返回NULL。

    • date值为NULL时,返回NULL。

  • 示例

    --返回100。
    SELECT dayofyear('2016-04-09');

EXTRACT

  • 命令格式

    int extract(<datepart> from date|datetime|timestamp <date>)
  • 命令说明

    提取日期date中指定单位datepart的部分。

  • 参数说明

    • datepart:必填。支持YEAR、MONTH、DAY、HOUR或MINUTE等时间取值。

    • date:必填。DATE、DATETIME、TIMESTAMP或STRING类型日期值,格式为yyyy-mm-ddyyyy-mm-dd hh:mi:ssyyyy-mm-dd hh:mi:ss.ff3。取值为STRING类型格式时,至少要包含yyyy-mm-dd且不含多余的字符串。

  • 返回值

    返回INT类型。返回规则如下:

    • datepart非YEAR、MONTH、DAY、HOUR或MINUTE等时间取值时,返回报错。

    • datepart值为NULL时,返回报错。

    • date非DATE、DATETIME、TIMESTAMP或STRING类型或为NULL时,返回NULL。

  • 示例

  • select  extract(year from '2019-05-01 11:21:00') year
             ,extract(month from '2019-05-01 11:21:00') month
             ,extract(day from '2019-05-01 11:21:00') day
             ,extract(hour from '2019-05-01 11:21:00') hour
             ,extract(minute from '2019-05-01 11:21:00') minute;
    --返回值如下。
    +------+-------+------+------+--------+
    | year | month | day  | hour | minute |
    +------+-------+------+------+--------+
    | 2019 | 5     | 1    | 11   | 21     |
    +------+-------+------+------+--------+
    --返回NULL。
    select  extract(year from null);

FROM_UNIXTIME

  • 命令格式

    datetime from_unixtime(bigint <unixtime>)
  • 命令说明

    将数字型的UNIX时间日期值unixtime转为日期值。

  • 参数说明

    unixtime:必填。BIGINT类型,秒数,UNIX格式的日期时间值。如果输入为STRING、DOUBLE或DECIMAL类型,则会隐式转换为BIGINT后参与运算。

  • 返回值说明

    返回DATETIME类型,格式为yyyy-mm-dd hh:mi:ssunixtime值为NULL时,返回NULL。

    说明

    Hive兼容模式下(set odps.sql.hive.compatible=true;),如果输入参数是STRING类型,返回值也是STRING类型。

  • 示例

  • --返回1973-11-30 05:33:09。
    select from_unixtime(123456789);

GETDATE

  • 命令格式

    datetime getdate()
  • 命令说明

    获取当前系统时间。使用东八区时间作为SQL分析标准时间。

  • 返回值说明

    返回当前日期和时间,DATETIME类型。

HOUR

  • 命令格式

    int hour(datetime|timestamp|string <date>)
  • 命令说明

    返回日期小时部分的值。

  • 参数说明

    date:必填。DATETIME、TIMESTAMP或STRING类型日期值,格式为yyyy-mm-dd hh:mi:ssyyyy-mm-dd hh:mi:ss.ff3。取值为STRING类型格式时,至少要包含yyyy-mm-dd且不含多余的字符串。

  • 返回值说明

    返回INT类型。返回规则如下:

    • date非DATETIME、TIMESTAMP或STRING类型,或格式不符合要求时,返回NULL。

    • date值为NULL时,返回NULL。

  • 示例

  • --返回12。
    select hour('2014-09-01 12:00:00');
    
    --返回12。
    select hour('12:00:00');
    
    --返回NULL。
    select hour('20140901120000');
    
    --返回NULL。
    select hour(null);

INTERVAL_DAY_TIME

  • 命令格式

    interval_day_time(string <date>)
  • 命令说明

    将给定日期date转换为INTERVAL_DAY_TIME类型的变量。

  • 参数说明

    date:必填。STRING类型日期值。格式为dd hh:mi:ss.ff3,至少需要包含dd hh:mm,否则会报错。

  • 返回值说明

    返回INTERVAL_DAY_TIME类型。如果输入参数为NULL,则返回NULL。

  • 示例

    --返回1 00:00:00.000000000。
    select interval_day_time("01 00:00:00");
    
    --返回1 11:22:00.000000000。
    select interval_day_time("01 11:22");
    
    --返回12 01:02:03.999000000。
    select interval_day_time("12 01:02:03.999");

ISDATE

  • 命令格式

    boolean isdate(string <date>, string <format>)
  • 命令说明

    判断一个日期字符串能否根据指定的格式串转换为一个日期值。如果能转换成功,返回True;否则返回False。

  • 参数说明

    • date:必填。STRING类型。如果输入为BIGINT、DOUBLE、DECIMAL或DATETIME类型,会隐式转换为STRING类型后参与运算。

    • format:必填。STRING类型常量,不支持日期扩展格式。如果format中出现多余的格式串,则只取第一个格式串对应的日期数值,其余的会被视为分隔符。例如isdate("1234-yyyy", "yyyy-yyyy"),会返回True。

  • 返回值说明

    返回BOOLEAN类型。dateformat值为NULL时,返回NULL。

  • 示例

  • --返回True。
    select isdate('2021-10-11','yyyy-mm-dd');
    
    --返回false。
    select isdate(1678952314,'yyyy-mm-dd');

LAST_DAY

  • 命令格式

    string last_day(date|datetime|timestamp|string <date>)
  • 命令说明

    返回该日期所在月份的最后一天日期。

  • 参数说明

    date:必填。DATE、DATETIME、TIMESTAMP或STRING类型日期值。取值为STRING类型格式时,至少要包含yyyy-mm-dd且不含多余的字符串。

  • 返回值说明

    返回STRING类型的日期值,格式为yyyy-mm-dd。返回规则如下:

    • date非DATE、DATETIME、TIMESTAMP或STRING类型,或格式不符合要求时,返回NULL。

    • date值为NULL时,返回报错。

  • 示例

  • --返回2017-03-31。
    select last_day('2017-03-04');
    
    --返回2017-07-31。
    select last_day('2017-07-04 11:40:00');
    
    --返回NULL。
    select last_day('20170304');

LASTDAY

  • 命令格式

    datetime lastday(datetime <date>)
  • 命令说明

    date所在月的最后一天,截取到天,时分秒部分为00:00:00

  • 参数说明

    date:DATETIME类型日期值,格式为yyyy-mm-dd hh:mi:ss

  • 返回值说明

    返回DATETIME类型,格式为yyyy-mm-dd hh:mi:ss。返回规则如下:

    • date非DATETIME或STRING类型,或格式不符合要求时,会返回报错。

    • date值为NULL时,返回NULL。

  • 示例

  • --返回2013-06-30 00:00:00。
    select lastday (datetime '2013-06-08 01:10:00');
    
    --返回2013-06-30 00:00:00。
    select lastday ('2013-06-08 01:10:00');
    
    --返回NULL。
    select lastday (null);

MINUTE

  • 命令格式

    int minute(datetime|timestamp|string <date>)
  • 命令说明

    返回日期分钟部分的值。

  • 参数说明

    date:必填。DATETIME、TIMESTAMP或STRING类型日期值,格式为yyyy-mm-dd hh:mi:ssyyyy-mm-dd hh:mi:ss.ff3

  • 返回值说明

    返回INT类型。返回规则如下:

    • date非DATETIME、TIMESTAMP或STRING类型,或格式不符合要求时,返回NULL。

    • date值为NULL时,返回NULL。

  • 示例

  • --返回30。
    select minute('2014-09-01 12:30:00'); 
    
    --返回30。
    select minute('12:30:00');
    
    --返回NULL。
    select minute('20140901120000');
    
    --返回NULL。
    select minute(null);

MONTH

  • 命令格式

    int month(datetime|timestamp|date|string <date>)
  • 命令说明

    返回一个日期的月份。

  • 参数说明

    date:必填。DATETIME、TIMESTAMP、DATE或STRING类型日期值,格式为yyyy-mm-ddyyyy-mm-dd hh:mi:ssyyyy-mm-dd hh:mi:ss.ff3。取值为STRING类型格式时,至少要包含yyyy-mm-dd且不含多余的字符串。

  • 返回值说明

    返回INT类型。返回规则如下:

    • date非DATETIME、TIMESTAMP、DATE或STRING类型,或格式不符合要求时,返回NULL。

    • date值为NULL时,返回NULL。

  • 示例

  • --返回9。
    select month('2014-09-01');
    
    --返回NULL。
    select month('20140901');
    
    --返回NULL。
    select month(null);

MONTHS_BETWEEN

  • 命令格式

    double months_between(datetime|timestamp|date|string <date1>, datetime|timestamp|date|string <date2>)
  • 命令说明

    返回日期date1date2之间的月数。

  • 参数说明

    date1date2:必填。DATETIME、TIMESTAMP、DATE或STRING类型,格式为yyyy-mm-ddyyyy-mm-dd hh:mi:ssyyyy-mm-dd hh:mi:ss.ff3。取值为STRING类型格式时,至少要包含yyyy-mm-dd且不含多余的字符串。

  • 返回值说明

    返回DOUBLE类型。返回规则如下:

    • date1晚于date2时,返回值为正。当date2晚于date1时,返回值为负。

    • date1date2分别对应两个月的最后一天,返回整数月;否则计算方式为date1减去date2的天数除以31天。

    • date1date2值为NULL时,返回NULL。

  • 示例

  • --返回3.9495967741935485。
    select months_between('1997-02-28 10:30:00', '1996-10-30');
    
    --返回-3.9495967741935485。
    select months_between('1996-10-30','1997-02-28 10:30:00' );
    
    --返回-3.0。
    select months_between('1996-09-30','1996-12-31');
    
    --返回NULL。
    select months_between('1996-09-30',null);

NEXT_DAY

  • 命令格式

    string next_day(timestamp|date|datetime|string <startdate>, string <week>)
  • 命令说明

    返回大于指定日期startdate并且与week相匹配的第一个日期,即下周几的具体日期。

  • 参数说明

    • startdate:必填。TIMESTAMP、DATE、DATETIME或STRING类型日期值,格式为yyyy-mm-ddyyyy-mm-dd hh:mi:ssyyyy-mm-dd hh:mi:ss.ff3。取值为STRING类型格式时,至少要包含yyyy-mm-dd且不含多余的字符串。

    • week:必填。STRING类型,一个星期前2个或3个字母,或者一个星期的全名。例如MO、TUE或FRIDAY。

  • 返回值说明

    返回STRING类型的日期值,格式为yyyy-mm-dd。返回规则如下:

    • date非TIMESTAMP、DATE、DATETIME或STRING类型,或格式不符合要求时,返回NULL。

    • date值为NULL时,返回报错。

    • week值为NULL时,返回NULL。

  • 示例

  • --返回2017-08-08。
    select next_day('2017-08-01','TU');
    
    --返回2017-08-08。
    select next_day('2017-08-01 23:34:00','TU');
    
    --返回NULL。
    select next_day('20170801','TU');
    
    --返回NULL。
    select next_day('2017-08-01 23:34:00',null);

NOW

  • 命令格式

    datetime NOW()
  • 命令说明

    返回当前系统日期与时间。

  • 返回值说明

    返回DATETIME类型,格式为yyyy-mm-dd hh:mi:ss.SSS

  • 示例

    • 不指定格式,返回毫秒位可能为1位、2位或者3位:

      select now();

      返回结果如下:

      +------+
      | _c0  |
      +------+
      | 2023-06-13 10:53:24.967 |
      +------+
    • 指定时间格式:

      select  date_format(now(),'yyyy-MM-dd hh:mm:ss.SSS') ;

      返回结果如下:

      +-----+
      | _c0 |
      +-----+
      | 2023-06-13 10:53:53.899 |
      +-----+

QUARTER

  • 命令格式

    int quarter (datetime|timestamp|date|string <date>)
  • 命令说明

    返回一个日期的季度,范围是1~4。

  • 参数说明

    date:必填。DATETIME、TIMESTAMP、DATE或STRING类型日期值,格式为yyyy-mm-ddyyyy-mm-dd hh:mi:ssyyyy-mm-dd hh:mi:ss.ff3。取值为STRING类型格式时,至少要包含yyyy-mm-dd且不含多余的字符串。

  • 返回值说明

    返回INT类型。返回规则如下:

    • date非DATETIME、TIMESTAMP、DATE或STRING类型,或格式不符合要求时,返回NULL。

    • date值为NULL时,返回NULL。

  • 示例

  • --返回4。
    select quarter('1970-11-12 10:00:00');
    
    --返回4。
    select quarter('1970-11-12');
    
    --返回NULL。
    select quarter(null);

SECOND

  • 命令格式

    int second(datetime|timestamp|string <date>)
  • 命令说明

    返回日期秒数部分的值。

  • 参数说明

    date:必填。DATETIME、TIMESTAMP或STRING类型日期值,格式为yyyy-mm-dd hh:mi:ssyyyy-mm-dd hh:mi:ss.ff3

  • 返回值说明

    返回INT类型。返回规则如下:

    • date非DATETIME、TIMESTAMP或STRING类型,或格式不符合要求时,返回NULL。

    • date值为NULL时,返回NULL。

  • 示例

  • --返回45。
    select second('2014-09-01 12:30:45');
    
    --返回45。
    select second('12:30:45');
    
    --返回NULL。
    select second('20140901123045');
    
    --返回NULL。
    select second(null);

TO_CHAR

  • 命令格式

    string to_char(datetime <date>, string <format>)
  • 命令说明

    将日期类型date按照format指定的格式转成字符串。

  • 参数说明

    • date:必填。DATETIME类型日期值,格式为yyyy-mm-dd hh:mi:ss。如果输入为STRING类型,会隐式转换为DATETIME类型后参与运算。

    • format:必填。STRING类型常量。format中的日期格式部分会被替换成相应的数据,其他字符直接输出。

  • 返回值说明

    返回STRING类型。返回规则如下:

    • date非DATETIME或STRING类型时,返回报错。

    • date值为NULL时,返回报错。

    • format值为NULL时,返回NULL。

  • 示例

  • --返回20080718。
    select to_char(datetime'2008-07-18 00:00:00', 'yyyymmdd');
    
    --返回20080718。
    select to_char('2008-07-18 00:00:00', 'yyyymmdd');
    
    --'阿里巴巴2010-12*3'无法转换为符合要求的格式,会引发异常,应该为'阿里巴巴2010-12*03'。
    select to_char(datetime'阿里巴巴2010-12*3', '阿里巴巴yyyy-mm*dd');
    
    --'20102401'不是标准日期值,引发异常,应该为'2010-01-24 00:00:00'。
    select to_char(datetime'20102401', 'yyyy');
    
    --'2008718'不是标准日期值,引发异常,应该为'2008-07-18 00:00:00'。
    select to_char(datetime'2008718', 'yyyymmdd');
    
    --返回NULL。
    select to_char(datetime'2010-12-03 00:00:00', null);

TO_DATE

  • 命令格式

    datetime to_date(string <date>, string <format>)
  • 命令说明

    date转换成符合format格式的日期值。

  • 参数说明

    • date:必填。STRING类型,要转换的字符串格式的日期值。如果输入为BIGINT、DOUBLE、DECIMAL或DATETIME类型,则会隐式转换为STRING类型后参与运算。该函数还支持ISO8601时间格式的字符串。

    • format:必填。STRING类型常量,日期格式。format不支持日期扩展格式,其他字符在解析时当作无用字符忽略。

      format:参数至少包含yyyy,否则会返回NULL。如果format中出现多余的格式串,则只取第一个格式串对应的日期数值,其余的会被视为分隔符。例如to_date("1234-2234", "yyyy-yyyy")会返回1234-01-01 00:00:00

      format格式:yyyy为4位数的年,mm为2位数的月,dd为2位数的日,hh为24小时制的时,mi为2位数的分钟,ss为2位数秒,ff3为3位精度毫秒。

  • 返回值说明

    返回DATETIME类型,格式为yyyy-mm-dd hh:mi:ssdateformat值为NULL时,返回NULL。

  • 示例

  • --返回2010-12-03 00:00:00。
    select to_date('阿里巴巴2010-12*03', '阿里巴巴yyyy-mm*dd');
    
    --返回2008-07-18 00:00:00。
    select to_date('20080718', 'yyyymmdd');
    
    --返回2008-07-18 20:30:00。
    select to_date('200807182030','yyyymmddhhmi');
    
    --'2008718'无法转为标准日期值,引发异常,应该为'20080718'。
    select to_date('2008718', 'yyyymmdd');
    
    --'阿里巴巴2010-12*3'无法转为标准日期值,引发异常,应该为'阿里巴巴2010-12*03'。
    select to_date('阿里巴巴2010-12*3', '阿里巴巴yyyy-mm*dd');
    
    --'2010-24-01'无法转为标准日期值,引发异常,应该为'2010-01-24'。
    select to_date('2010-24-01', 'yyyy');
    
    --返回2018-10-30 15:13:12。
    select to_date('20181030 15-13-12.345','yyyymmdd hh-mi-ss.ff3');
    
    --返回NULL。
    select to_date(null,'yyyymmdd hh-mi-ss.ff3');
    
    --返回NULL。
    select to_date('20181030 15-13-12.345',null);
    
    --ISO8601时间格式,返回2021-09-24 13:39:34。
    select to_date('2021-09-24T13:39:34.119Z', 'yyyy-MM-ddThh:mi:ss.ff3Z');

UNIX_TIMESTAMP

  • 命令格式

    bigint unix_timestamp(datetime|date|timestamp|string <date>)
  • 命令说明

    将日期date转化为整型的UNIX格式的日期时间值。

  • 参数说明

    date:必填。DATETIME、DATE、TIMESTAMP或STRING类型日期值,格式为yyyy-mm-ddyyyy-mm-dd hh:mi:ssyyyy-mm-dd hh:mi:ss.ff3。如果输入为STRING类型,则会隐式转换为DATETIME类型后参与运算。当打开新数据类型属性时,隐式转换会失败,此时需要通过cast函数转换或关闭新数据类型,例如unix_timestamp(cast(... as datetime))

  • 返回值说明

    返回BIGINT类型,表示UNIX格式日期值。返回规则如下:

    • date非DATETIME、DATE、TIMESTAMP或STRING类型,或格式不符合要求时,返回报错。

    • date值为NULL时,返回NULL。

  • 示例

  • --返回1237518660。
    select unix_timestamp(datetime'2009-03-20 11:11:00'); 
    
    --返回1237518660。
    select unix_timestamp('2009-03-20 11:11:00'); 
    
    --返回NULL。
    select unix_timestamp(null);

WEEKDAY

  • 命令格式

    bigint weekday (datetime <date>)
  • 命令说明

    返回date日期是当前周的第几天。

  • 参数说明

    date:必填。DATETIME类型日期值。格式为yyyy-mm-dd hh:mi:ss。如果输入为STRING类型,则会隐式转换为DATETIME类型后参与运算。

  • 返回值说明

    返回BIGINT类型。返回规则如下:

    • 周一作为一周的第一天,返回值为0。其他日期依次递增,周日返回6。

    • date非DATETIME或STRING类型,或格式不符合要求时,返回报错。

    • date值为NULL时,返回NULL。

  • 示例

  • --返回4。
    select weekday (datetime '2009-03-20 11:11:00');
    
    --返回4。
    select weekday ('2009-03-20 11:11:00');
    
    --返回NULL。
    select weekday (null);

WEEKOFYEAR

  • 命令格式

    bigint weekofyear (datetime <date>)
  • 命令说明

    返回日期date位于那一年的第几周。周一作为一周的第一天。

    说明

    这一周算上一年还是下一年,取决于这一周的大多数日期(4天以上)在哪一年。算在前一年,就是前一年的最后一周;算在后一年就是后一年的第一周。

  • 参数说明

    date:必填。DATETIME类型日期值。格式为yyyy-mm-dd hh:mi:ss。如果输入为STRING类型,则会隐式转换为DATETIME类型后参与运算。

  • 返回值说明

    返回BIGINT类型。返回规则如下:

    • date非DATETIME或STRING类型,或格式不符合要求时,返回NULL。

    • date值为NULL时,返回NULL。

  • 示例

  • --返回1。虽然20141229属于2014年,但是这一周的大多数日期是在2015年,因此返回结果为1,表示是2015年的第一周。
    select weekofyear(to_date("20141229", "yyyymmdd"));  
    
    --返回1。    
    select weekofyear(to_date("20141231", "yyyymmdd")); 
    
    --返回53。 
    select weekofyear(to_date("20151229", "yyyymmdd"));
    
    --返回48。
    select weekofyear('2021-11-29 00:01:00');
    
    --返回NULL。
    select weekofyear('20141231');
    
    --返回NULL。
    select weekofyear(null);

YEAR

  • 命令格式

    int year(datetime|timestamp|date|string <date>)
  • 命令说明

    返回日期date的年。

  • 参数说明

    date:必填。DATETIME、TIMESTAMP、DATE或STRING类型日期值,格式为yyyy-mm-ddyyyy-mm-dd hh:mi:ssyyyy-mm-dd hh:mi:ss.ff3。取值为STRING类型格式时,至少要包含yyyy-mm-dd且不含多余的字符串。

  • 返回值

    返回INT类型。返回规则如下:

    • date非DATETIME、TIMESTAMP、DATE或STRING类型,或格式不符合要求时,返回NULL。

    • date值为NULL时,返回NULL。

  • 示例

  • --返回1970。
    select year('1970-01-01 12:30:00');
    
    --返回1970。
    select year('1970-01-01');
    
    --返回70。
    select year('70-01-01');
    
    --返回NULL。
    select year('1970/03/09'); 
    
    --返回NULL。
    select year(null);