时间函数如下表所示：
函数 | 功能 |
ADD_DAYS | 按照指定的幅度增加日期的天数。 |
ADD_MONTHS | 按照指定的幅度增加月份。 |
ADD_YEARS | 按照指定的幅度增加年份。 |
DATE_DIFF | 计算时间差值。 |
DATE_FORMAT | 将日期格式化成指定格式的字符串。 |
FROM_UNIXTIME | 将整型的时间戳（单位秒）转换为日期值。 |
GET_DAY_OF_MONTH | 返回一个时间日部分的值。 |
GET_HOUR | 获取一个时间小时部分的值。 |
GET_MINUTE | 获取一个时间分钟部分的值。 |
GET_MONTH | 获取一个时间月份部分的值。 |
GET_QUARTER | 获取一个时间对应的季度。 |
GET_SECOND | 获取一个日期时间秒数部分的值。 |
GET_WEEKDAY | 获取指定日期在当前周的第几天。 |
GET_WEEK_OF_YEAR | 获取指定日期所在的自然周处于在当年的第几周。 |
GET_YEAR | 获取一个时间年份部分的值。 |
NOW | 获取系统当前的时间。 |
SUB_DAYS | 按照指定的幅度减少日期的天数。 |
TO_DATE | 将一个指定格式的字符串转成日期时间。 |
UNIX_TIMESTAMP | 将一个日期时间转为整型的时间戳（单位秒）。 |
ADD_DAYS
函数说明
按照delta幅度增加startdate日期的天数。
参数说明
startdate：必填，时间类型。待增加天数的日期时间值。
delta：必填，整数类型。日期增幅，如果delta大于0，则增，否则减。
返回值说明
返回日期计算结果，精度截取到日期，格式为yyyy-MM-dd 00:00:00。当startdate或者delta值为NULL时返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
ADD_MONTHS
函数说明
按照delta幅度增加startdate日期的月份。
参数说明
startdate：必填，时间类型。待增加月份的日期时间值。
delta：必填，整数类型。月份增幅，如果delta大于0，则增，否则减。
返回值说明
返回日期计算结果，精度截取到日期，格式为yyyy-MM-dd 00:00:00。当startdate或者delta值为NULL时返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
ADD_YEARS
函数说明
按照delta幅度增加startdate日期的年份。
参数说明
startdate：必填，时间类型。待增加年份的日期时间值。
delta：必填，整数类型。年份增幅，如果delta大于0，则增，否则减。
返回值说明
返回日期计算结果，精度截取到日期，格式为yyyy-MM-dd 00:00:00。当startdate或者delta值为NULL时返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
DATE_DIFF
函数说明
计算从start到end两个时间之间的差值，结果以指定的时间单位dateUnit表示。
参数说明
start：必填，时间类型。起始时间。
end：必填，时间类型。结束时间。
dateUnit：必填，文本类型。时间单位，可选：YEAR、MONTH、DAY、HOUR、MINUTE、SECOND。
返回值说明
两个时间的差值，数据格式为整数类型，负数表示时间start在end之后。start或者end参数为NULL时，结果返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
DATE_FORMAT
函数说明
将日期格式化成指定格式的字符串。
参数说明
dateValue：必填，时间类型。日期时间值。
format：必填，文本类型。日期格式化的格式，可选值：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd、yyyyMMdd、yyyyMMddHHmmss。
返回值说明
返回格式化后的字符串。当dateValue值为NULL时返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
FROM_UNIXTIME
函数说明
将整型的时间戳（单位秒）转换为日期值。
参数说明
unixtime：必填，整数类型。整型的时间戳，单位为秒。
返回值说明
返回转换后的日期时间值。当unixtime值为NULL时返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
GET_DAY_OF_MONTH
函数说明
返回一个时间日部分的值。
参数说明
dateValue：必填，时间类型。日期时间值。
返回值说明
返回时间日部分对应的整数值（1~31）。当dateValue值为NULL时返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
GET_HOUR
函数说明
获取一个时间小时部分的值。
参数说明
dateValue：必填，时间类型。日期时间值。
返回值说明
返回时间小时部分对应的整数值（0~23）。当dateValue值为NULL时返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
GET_MINUTE
函数说明
获取一个时间分钟部分的值。
参数说明
dateValue：必填，时间类型。日期时间值。
返回值说明
返回时间分钟部分对应的整数值（0~59）。当dateValue值为NULL时返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
GET_MONTH
函数说明
获取一个时间月份部分的值。
参数说明
dateValue：必填，时间类型。日期时间值。
返回值说明
返回时间月份部分对应的整数值（1~12）。当dateValue值为NULL时返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
GET_QUARTER
函数说明
获取一个时间对应的季度。
参数说明
dateValue：必填，时间类型。日期时间值。
返回值说明
返回时间季度部分对应的整数值（1~4）。当dateValue值为NULL时返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
GET_SECOND
函数说明
获取一个日期时间秒数部分的值。
参数说明
dateValue：必填，时间类型。日期时间值。
返回值说明
返回时间秒数部分对应的整数值（0~59）。当dateValue值为NULL时返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
GET_WEEKDAY
函数说明
获取指定日期在当前周的第几天。
参数说明
dateValue：必填，时间类型。日期时间值。
返回值说明
周一作为一周的第一天，返回值为0。其他日期依次递增，周日返回6。当dateValue值为NULL时返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
GET_WEEK_OF_YEAR
函数说明
获取指定日期所在的自然周处于在当年的第几周。周一作为一周的第一天。跨年的周算上一年还是下一年，取决于这一周的大多数日期（4天以上）在哪一年。算在前一年就是前一年的最后一周，算在后一年就是后一年的第一周。
参数说明
dateValue：必填，时间类型。日期时间值。
返回值说明
返回日期所在周处于当年的第几周的整数值。当dateValue值为NULL时返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
GET_YEAR
函数说明
获取一个时间年份部分的值。
参数说明
dateValue：必填，时间类型。日期时间值。
返回值说明
返回时间年份部分对应的整数值。当dateValue值为NULL时返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
NOW
函数说明
获取系统当前的时间。
参数说明
无
返回值说明
返回系统当前时间。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
SUB_DAYS
函数说明
按照delta幅度减去startdate日期的天数。
参数说明
startdate：必填，时间类型。日期时间值
delta：必填，整数类型。减去的天数，如果delta大于0，则减，否则增。
返回值说明
返回日期计算结果，精度截取到日期，格式为yyyy-MM-dd 00:00:00。当startdate或者delta值为NULL时返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
TO_DATE
函数说明
将一个指定格式的字符串转成日期时间。
参数说明
dateString：必填，文本类型。需要转换的字符串
format：必填，文本类型。字符串对应的日期转换格式，可选值：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd、yyyyMMdd、yyyyMMddHHmmss。
返回值说明
返回转换后的日期时间。当dateString值为NULL时返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
UNIX_TIMESTAMP
函数说明
将一个日期时间转为整型的时间戳（单位为秒）。
参数说明
dateValue：必填，时间类型。日期时间值。
返回值说明
返回整型的时间戳，单位为秒。当dateValue值为NULL时返回NULL。
支持的计算引擎
MaxCompute(ODPS)、MYSQL、RDS、HIVE、AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL、SPARK。
- 本页导读 （0）