文档

时间函数

更新时间:

时间函数如下表所示:

函数

功能

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。