|
|
时间函数如下表所示：
|
函数 |
功能 |
|
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。