MaxCompute SQL提供了针对Datetime类型的操作函数。

DATEADD

命令格式如下： 
datetime dateadd(datetime date, bigint delta, string datepart)

命令说明如下：

按照指定的单位datepart和幅度delta修改date的值。

参数说明：

  • date：Datetime类型，日期值。若输入为String类型会隐式转换为Datetime类型后参与运算，其它类型抛异常。
  • delta：Bigint类型，修改幅度。若输入为String类型或Double型会隐式转换到Bigint类型后参与运算，其他类型会引发异常。若delta大于0，则增，否则减。
  • datepart：String类型常量。此字段的取值遵循String与Datetime类型转换的约定，即yyyy表示年，mm表示月。

    关于类型转换的规则，请参见String类型与Datetime类型之间的转换。此外也支持扩展的日期格式：年-year，月-month或mon，日-day，小时-hour。非常量、不支持的格式或其它类型会抛异常。

返回值：

返回Datetime类型。若任一输入参数为NULL，返回NULL。

说明
  • 按照指定的单位增减delta时，导致的对更高单位的进位或退位，年、月、时、分、秒分别按照10进制、12进制、24进制、60进制、60进制进行计算。
  • 当delta的单位是月时，计算规则如下：

    若Datetime的月部分在增加delta值之后不造成day溢出，则保持day值不变，否则把day值设置为结果月份的最后一天。

  • datepart的取值遵循String与Datetime类型转换的约定，即yyyy表示年，mm表示月，Datetime相关的内建函数如无特殊说明均遵守此约定。同时如果没有特殊说明，所有Datetime相关的内建函数的part部分也同样支持扩展的日期格式：年-year，月-month或mon，日-day，小时-hour。
示例如下： 
若trans_date = 2005-02-28 00:00:00：
dateadd(trans_date, 1, 'dd') = 2005-03-01 00:00:00
-- 加一天，结果超出当年2月份的最后一天，实际值为下个月的第一天
dateadd(trans_date, -1, 'dd') = 2005-02-27 00:00:00
-- 减一天
dateadd(trans_date, 20, 'mm') = 2006-10-28 00:00:00
-- 加20个月，月份溢出，年份加1
若trans_date = 2005-02-28 00:00:00, dateadd(transdate, 1, 'mm') = 2005-03-28 00:00:00
若trans_date = 2005-01-29 00:00:00, dateadd(transdate, 1, 'mm') = 2005-02-28 00:00:00
-- 2005年2月没有29日，日期截取至当月最后一天
若trans_date = 2005-03-30 00:00:00, dateadd(transdate, -1, 'mm') = 2005-02-28 00:00:00
说明
此处对trans_date的数值表示仅作示例使用，在文档中有关Datetime的介绍会经常使用到这种简易的表达方式。
在MaxCompute SQL中，Datetime类型没有直接的常数表示方式，如下使用方式是错误的： 
select dateadd(2005-03-30 00:00:00, -1, 'mm') from tbl1;
如果一定要描述Datetime类型常量，请尝试如下方法： 
select dateadd(cast("2005-03-30 00:00:00" as datetime), -1, 'mm') from tbl1;
-- 将String类型常量显式转换为Datetime类型

DATEDIFF

命令格式如下： 
bigint datediff(datetime date1, datetime date2, string datepart)

命令说明如下：

计算两个时间date1、date2在指定时间单位datepart的差值。

参数说明：
  • datet1、date2：Datetime类型，被减数和减数，若输入为String类型会隐式转换为Datetime类型后参与运算，其它类型抛异常。
  • datepart：String类型常量。支持扩展的日期格式。若datepart不符合指定格式或者其它类型则会发生异常。

返回值：

返回Bigint类型。任一输入参数是NULL，返回NULL。如果date1小于date2，返回值可以为负数。

说明
计算时会按照datepart切掉低单位部分，然后再计算结果。
示例如下： 
若start = 2005-12-31 23:59:59，end = 2006-01-01 00:00:00:
    datediff(end, start, 'dd') = 1
    datediff(end, start, 'mm') = 1
    datediff(end, start, 'yyyy') = 1
    datediff(end, start, 'hh') = 1
    datediff(end, start, 'mi') = 1
    datediff(end, start, 'ss') = 1
    datediff('2013-05-31 13:00:00', '2013-05-31 12:30:00', 'ss') = 1800
    datediff('2013-05-31 13:00:00', '2013-05-31 12:30:00', 'mi') = 30
若start = 2018-06-04 19:33:23.234，end = 2018-06-04 19:33:23.250 含毫秒的日期不属于标准Datetime式样，不能直接隐式转换，此处需进行显示转换：
 datediff(to_date('2018-06-04 19:33:23.250', 'yyyy-MM-dd hh:mi:ss.ff3'),to_date('2018-06-04 19:33:23.234', 'yyyy-MM-dd hh:mi:ss.ff3') , 'ff3') = 16

DATEPART

命令格式如下所示： 
bigint datepart(datetime date, string datepart)

命令说明如下：

提取日期date中指定的时间单位datepart的值。

参数说明：

返回值：
  • date：Datetime类型，若输入为String类型会隐式转换为Datetime类型后参与运算，其它类型抛异常。
  • datepart：String类型常量，支持扩展的日期格式。若datepart不符合指定格式或者其它类型则会发生异常。

返回Bigint类型。若任一输入参数为NULL，返回NULL。

示例如下： 
datepart('2013-06-08 01:10:00', 'yyyy')  =  2013
datepart('2013-06-08 01:10:00', 'mm')  =  6

DATETRUNC

命令格式如下： 
datetime datetrunc (datetime date, string datepart)

命令说明如下：

返回日期date被截取指定时间单位datepart后的日期值。

参数说明：
  • date：Datetime类型，若输入为String类型会隐式转换为Datetime类型后参与运算，其它类型抛异常。
  • datepart：String类型常量，支持扩展的日期格式。若datepart不符合指定格式或者其它类型则会发生异常。

返回值：

Datetime类型。任意一个参数为NULL时，返回NULL。

示例如下： 
datetrunc('2011-12-07 16:28:46', 'yyyy') = 2011-01-01 00:00:00
datetrunc('2011-12-07 16:28:46', 'month') = 2011-12-01 00:00:00
datetrunc('2011-12-07 16:28:46', 'DD') = 2011-12-07 00:00:00

FROM_UNIXTIME

命令格式如下： 
datetime from_unixtime(bigint unixtime)

命令说明如下：

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

参数说明：

unixtime：Bigint类型，秒数，unix格式的日期时间值，若输入为String、Double、Decimal类型会隐式转换为Bigint后参与运算。

返回值：

返回Datetime类型的日期值，unixtime为NULL时，返回NULL。

示例如下： 
from_unixtime(123456789) = 1973-11-30 05:33:09

GETDATE

命令格式如下： 
datetime getdate()

命令说明如下：

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

返回值：

返回当前日期和时间，Datetime类型。

说明
在一个MaxCompute SQL任务中（以分布式方式执行），getdate总是返回一个固定的值。返回结果会是MaxCompute SQL执行期间的任意时间，时间精度精确到秒（2.0版本会精确到毫秒）。

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类型，如任意参数为NULL，返回NULL。

LASTDAY

命令格式如下： 
datetime lastday(datetime date)

命令说明如下：

取date当月的最后一天，截取到天，时分秒部分为00:00:00。

参数说明：

date：Datetime类型，若输入为String 类型，会隐式转换为Datetime类型后参与运算，其它类型报异常。

返回值：

返回Datetime类型，如输入为NULL，返回NULL。

TO_DATE

命令格式如下： 
datetime to_date(string date, string format)

命令说明如下：

将一个format格式的字符串date转成日期值。

参数说明：
  • date：String类型，要转换的字符串格式的日期值，若输入为Bigint、Double、Decimal或者Datetime类型，会隐式转换为String类型后参与运算，为其它类型则抛异常，为空串时抛异常。
  • format：String类型常量，日期格式。非常量或其他类型会引发异常。format不支持日期扩展格式，其他字符作为无用字符在解析时忽略。

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

返回值：

返回Datetime类型，格式为yyyy-mm-dd hh:mi:ss 。若任意一个输入的参数为NULL，则返回NULL值。

示例如下： 
to_date('阿里巴巴2010-12*03', '阿里巴巴yyyy-mm*dd') = 2010-12-03 00:00:00
to_date('20080718', 'yyyymmdd') = 2008-07-18 00:00:00
to_date('200807182030','yyyymmddhhmi') = 2008-07-18 20:30:00
to_date('2008718', 'yyyymmdd')
-- 格式不符合，引发异常
to_date('阿里巴巴2010-12*3', '阿里巴巴yyyy-mm*dd')
-- 格式不符合，引发异常
to_date('2010-24-01', 'yyyy')
-- 格式不符合，引发异常

TO_CHAR

命令格式如下： 
string to_char(datetime date, string format)

命令说明如下：

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

参数类型：
  • date：Datetime类型，要转换的日期值，若输入为String类型，会隐式转换为Datetime类型后参与运算，其它类型抛异常。
  • format：String类型常量。非常量或其他类型会引发异常。format中的日期格式部分会被替换成相应的数据，其它字符直接输出。

返回值：

返回String类型。若任意一个输入的参数为NULL，则返回NULL值。

示例如下： 
to_char('2010-12-03 00:00:00', '阿里金融yyyy-mm*dd') = '阿里金融2010-12*03'
to_char('2008-07-18 00:00:00', 'yyyymmdd') = '20080718' 
to_char('阿里巴巴2010-12*3', '阿里巴巴yyyy-mm*dd') -- 引发异常
to_char('2010-24-01', 'yyyy') -- 会引发异常
to_char('2008718', 'yyyymmdd') -- 会引发异常

关于其他类型向String类型转换的详情请参见字符串函数>TO_CHAR。

UNIX_TIMESTAMP

命令格式如下： 
bigint unix_timestamp(datetime date)

命令说明如下：

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

参数说明：

date：Datetime类型日期值，若输入为String类型，会隐式转换为Datetime类型后参与运算，其它类型抛异常。

返回值：

返回Bigint类型，表示unix格式日期值，date为NULL时，返回NULL值。

WEEKDAY

命令格式如下： 
bigint weekday (datetime date)

命令说明如下：

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

参数说明：

date：Datetime类型，若输入为String类型，会隐式转换为Datetime类型后参与运算，其它类型抛异常。

返回值：

返回Bigint类型，若输入参数为NULL，返回NULL值。周一作为一周的第一天，返回值为0。其他日期依次递增，周日返回6。

WEEKOFYEAR

命令格式如下： 
bigint weekofyear(datetime date)

命令说明如下：

返回日期date位于那一年的第几周。周一作为一周的第一天。
说明
关于这一周算上一年， 还是下一年，主要是看这一周大多数日期（4天以上）在哪一年多。 算在前一年，就是前一年的最后一周，算在后一年就是后一年的第一周。

参数说明:

date：Datetime类型日期值，若输入为String类型，会隐式转换为Datetime类型后参与运算，其它类型抛异常。

返回值：

返回Bigint类型。若输入为NULL，返回NULL值。

示例如下： 
select weekofyear(to_date("20141229", "yyyymmdd")) from dual;  
返回结果：  
+------------+
| _c0        |
+------------+
| 1          |
+------------+
 -虽然20141229属于2014年，但是这一周的大多数日期是在2015年，因此返回结果为1，表示是2015年的第一周。    
 select weekofyear(to_date("20141231", "yyyymmdd")) from dual；--返回结果为1。  
 select weekofyear(to_date("20151229", "yyyymmdd")) from dual；--返回结果为53。

MaxCompute2.0扩展函数

升级到MaxCompute2.0后，产品扩展了部分日期函数。如果您用到的函数涉及新数据类型，在使用新函数的SQL前，需要加一个set语句： 
set odps.sql.type.system.odps2 = true;--开启新类型
若想同时提交，执行以下语句： 
set odps.sql.type.system.odps2 = true;
select year('1970-01-01 12:30:00') = 1970 from dual;

下文将为您介绍新扩展的函数的详情。

YEAR

命令格式如下： 
INT year(string date)
说明
请在用到该函数的SQL语句前加set odps.sql.type.system.odps2 = true;，并与SQL一起提交运行，以便正常使用新数据类型。

命令说明如下：

返回一个日期的年。

参数说明：

date：String类型日期值，格式至少包含yyyy-mm-dd且不含多余的字符串，否则返回null值。

返回值：

返回INT类型。

示例如下： 
year('1970-01-01 12:30:00') = 1970
year('1970-01-01') = 1970
year('70-01-01') = 70
year(1970-01-01) = null
year('1970/03/09') = null
year(null) --返回异常

QUARTER

命令格式如下： 
INT quarter(datetime/timestamp/string date )
说明
请在用到该函数的SQL语句前加set odps.sql.type.system.odps2 = true;，并与SQL一起提交运行，以便正常使用新数据类型。

命令说明如下：

返回一个日期的季度，范围是1-4。

参数说明：

date：Datetime/Timestamp/String类型日期值，日期格式至少包含yyyy-mm-dd，其他会返回null值。

返回值：

返回INT类型，输入null，则返回null值。

示例如下： 
quarter('1970-11-12 10:00:00') = 4
quarter('1970-11-12') = 4

MONTH

命令格式如下： 
INT month(string date)
说明
请在用到该函数的SQL语句前加set odps.sql.type.system.odps2 = true;，并与SQL一起提交运行，以便正常使用新数据类型。

命令说明如下：

返回一个日期的月份。

参数说明：

date：String类型日期值，其他类型将返回异常。

返回值：

返回INT类型。

示例如下： 
month('2014-09-01') = 9
month('20140901') = null

DAY

命令格式如下： 
INT day(string date)
说明
请在用到该函数的SQL语句前加set odps.sql.type.system.odps2 = true;，并与SQL一起提交运行，以便正常使用新数据类型。

命令说明如下：

返回一个日期的天。

参数说明：

date：String类型日期值（格式为yyyy-mm-dd、yyyy-mm-dd hh:mi:ss）其他类型将返回异常。

返回值：

返回INT类型。

示例如下： 
day('2014-09-01') = 1
day('20140901') = null

DAYOFMONTH

命令格式如下： 
INT dayofmonth(date)
说明
请在用到该函数的SQL语句前加set odps.sql.type.system.odps2 = true;，并与SQL一起提交运行，以便正常使用新数据类型。

命令说明如下：

返回年/月/日中的具体日期。

例如2017年10月13日，执行命令int dayofmonth(2017-10-13)返回结果为13。

参数说明：

date：String类型日期值，其他类型将返回异常。

返回值：

返回INT类型。

示例如下： 
dayofmonth('2014-09-01') = 1
dayofmonth('20140901') = null

HOUR

命令格式如下： 
INT hour(string date)
说明
请在用到该函数的SQL语句前加set odps.sql.type.system.odps2 = true;，并与SQL一起提交运行，以便正常使用新数据类型。

命令说明如下：

返回一个日期的小时。

参数说明：

date：String类型日期值，其他类型将返回异常。

返回值：

返回INT类型。

示例如下： 
hour('2014-09-01 12:00:00') = 12
hour('12:00:00') = 12
hour('20140901120000') = null

MINUTE

命令格式如下： 
INT minute(string date)
说明
请在用到该函数的SQL语句前加set odps.sql.type.system.odps2 = true;，并与SQL一起提交运行，以便正常使用新数据类型。

命令说明如下：

返回一个日期的分钟。

参数说明：

date：String类型日期值，其他类型将返回异常。

返回值：

返回INT类型。

示例如下： 
minute('2014-09-01 12:30:00') = 30
minute('12:30:00') = 30
minute('20140901120000') = null

SECOND

命令格式如下： 
INT second(string date)
说明
请在用到该函数的SQL语句前加set odps.sql.type.system.odps2 = true;，并与SQL一起提交运行，以便正常使用新数据类型。

命令说明如下：

返回一个日期的秒钟。

参数说明：

date：String类型日期值，其他类型将返回异常。

返回值：

返回INT类型。

示例如下： 
second('2014-09-01 12:30:45') = 45
second('12:30:45') = 45
second('20140901123045') = null

CURRENT_TIMESTAMP

命令格式如下： 
timestamp current_timestamp()
说明
请在用到该函数的SQL语句前加set odps.sql.type.system.odps2 = true;，并与SQL一起提交运行，以便正常使用新数据类型。

命令说明如下：

返回当前timestamp类型的时间戳，值不固定。

返回值：

返回timestamp类型。

示例如下： 
select current_timestamp() from dual;--返回'2017-08-03 11:50:30.661'

ADD_MONTHS

命令格式如下： 
string add_months(string startdate, int nummonths)
说明
请在用到该函数的SQL语句前加set odps.sql.type.system.odps2 = true;，并与SQL一起提交运行，以便正常使用新数据类型。

命令说明如下：

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

参数说明：
  • startdate：String类型，格式至少包含年-月-日的日期，否则返回null值。
  • num_months：Int型数值。

返回值：

返回String类型的日期，格式为yyyy-mm-dd。

示例如下： 
add_months('2017-02-14',3) = '2017-05-14'
add_months('17-2-14',3) = '0017-05-14'
add_months('2017-02-14 21:30:00',3) = '2017-05-14'
add_months('20170214',3) = null

LAST_DAY

命令格式如下： 
string last_day(string date)
说明
请在用到该函数的SQL语句前加set odps.sql.type.system.odps2 = true;，并与SQL一起提交运行，以便正常使用新数据类型。

命令说明如下：

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

参数说明：

date：String类型，格式为yyyy-MM-dd HH:mi:ss或yyyy-MM-dd。

返回值：

返回String类型的日期，格式为yyyy-mm-dd。

示例如下： 
last_day('2017-03-04') = '2017-03-31'
last_day('2017-07-04 11:40:00') = '2017-07-31'
last_day('20170304') = null

NEXT_DAY

命令格式如下： 
string next_day(string startdate, string week)
说明
请在用到该函数的SQL语句前加set odps.sql.type.system.odps2 = true;，并与SQL一起提交运行，以便正常使用新数据类型。

命令说明如下：

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

参数说明：
  • startdate：String类型，格式为yyyy-MM-dd HH:mi:ss或yyyy-MM-dd。
  • week：String类型，一个星期前2个或3个字母，或者一个星期的全名，如Mo、TUE、FRIDAY。

返回值：

返回String类型的日期，格式为yyyy-mm-dd。

示例如下： 
next_day('2017-08-01','TU') = '2017-08-08'
next_day('2017-08-01 23:34:00','TU') = '2017-08-08'
next_day('20170801','TU') = null

MONTHS_BETWEEN

命令格式如下： 
double months_between(datetime/timestamp/string date1, datetime/timestamp/string date2)
说明
请在用到该函数的SQL语句前加set odps.sql.type.system.odps2 = true;，并与SQL一起提交运行，以便正常使用新数据类型。

命令说明如下：

返回日期date1和date2之间的月数。

参数说明：
  • date1：Datetime/Timestamp/String类型，格式为yyyy-MM-dd HH:mi:ss或yyyy-MM-dd。
  • date2：Datetime/Timestamp/String类型，格式为yyyy-MM-dd HH:mi:ss或yyyy-MM-dd。

返回值：

返回Double类型。
  • 当date1晚于date2，返回值为正。当date2晚于date1，返回值为负。
  • 当date1和date2分别对应两个月的最后一天，返回整数月，否则计算方式为date1-date2的天数除以31天。
示例如下： 
months_between('1997-02-28 10:30:00', '1996-10-30') = 3.9495967741935485
months_between('1996-10-30','1997-02-28 10:30:00' ) = -3.9495967741935485
months_between('1996-09-30','1996-12-31') = -3.0