时间日期函数
📄️ add_months
在给定的日期(DATE、DATETIME)上增加一个整数月,返回结果日期。
📄️ adddate,date_add
dateadd 的同名函数。
📄️ convert_tz
将给定的时间转化为另一个时区的时间。
📄️ curdate,current_date
获取当前的日期,以 DATE 类型返回。
📄️ current_timestamp
获取当前时间,以 DATETIME 类型返回。
📄️ curtime,current_time
获取当前的时间,以 TIME 类型返回。
📄️ date
从日期或时间日期表达式中截取日期部分。
📄️ date_add,adddate
向日期添加指定的时间间隔。
📄️ date_diff
根据指定的时间单位返回两个日期的差值。该函数按照 unit 指定的时间单位返回 expr1 - expr2 的差值。比如 date_diff('second', '2010-11-30 2359', '2010-11-30 2059',) 以秒为单位返回这两个日期的差值。
📄️ date_format
将日期类型按照 format 的类型转化为字符串。
📄️ date_slice
根据指定的时间粒度周期,将给定的时间转化到其所在的时间粒度周期的起始或结束时刻。
📄️ date_sub,subdate
从日期中减去指定的时间间隔。
📄️ date_trunc
根据指定的精度级别 fmt,将一个日期时间截断。
📄️ datediff
计算两个日期的差值,结果精确到天。
📄️ day
返回指定日期中的天信息。
📄️ dayofweek_iso
根据 ISO 标准,计算某一个日期对应的是一周内的星期几,并返回一个整数值,范围在 1 到 7 之间。其中,1 代表星期一,7 代表星期日。
📄️ dayname
返回指定日期对应的星期名称。
📄️ dayofmonth
获得日期中的天信息,返回值范围 1~31。
📄️ dayofweek
返回指定日期的工作日索引值,即星期日为 1,星期一为 2,星期六为 7。
📄️ dayofyear
计算指定日期为对应年中的哪一天。
📄️ days_add
向日期时间或日期加上指定的天数。
📄️ days_diff
计算开始时间和结束时间相差几天 (expr1 - expr2),结果精确到天。此函数与 datediff 的区别是:
📄️ days_sub
从给定日期或者日期时间中减去指定的天数,获得新的 DATETIME 结果。
📄️ from_days
通过计算当前时间距离 0000-01-01 的天数计算出是哪一天。
📄️ from_unixtime
将 UNIX 时间戳转化为对应的时间格式。返回的时间格式由 stringformat 指定,默认为 yyyy-MM-dd HHss,也支持 dateformat 中的格式。
📄️ hour
获得指定日期中的小时信息。
📄️ hours_add
给指定的日期时间或日期增加指定的小时数。
📄️ hours_diff
计算开始时间和结束时间相差多少个小时 (expr1 − expr2)。
📄️ hours_sub
从指定的日期时间中减少指定的小时数。
📄️ jodatime_format
将某一个日期转换成指定的 Joda DateTimeFormat 格式的字符串。
📄️ last_day
根据指定的时间单位,返回输入的日期对应的最后一天。比如 last_day('2023-05-10', 'month') 返回 '2023-05-10' 所在月份的最后一天。
📄️ makedate
根据给定的年份和天数值,构造一个日期值。
📄️ microseconds_add
向 expr1 添加指定的时间间隔,单位为微秒。
📄️ microseconds_sub
从 expr1 中减去指定的时间间隔,单位为微秒。
📄️ milliseconds_diff
计算开始时间和结束时间相差多少毫秒 (milliseconds)。
📄️ minute
获得日期中的分钟的信息,返回值范围为 0~59。
📄️ minutes_add
给指定的日期时间或日期增加指定的分钟数。
📄️ minutes_diff
计算开始时间和结束时间相差多少分钟 (expr1 − expr2)。
📄️ minutes_sub
从指定的日期时间或日期中减去指定的分钟数。
📄️ month
返回指定日期中的月份。
📄️ monthname
返回指定日期对应的月份。参数为 DATE 或 DATETIME 类型。
📄️ months_add
给日期添加指定的月数,精确到月。
📄️ months_diff
计算开始时间和结束时间相差几个月(expr1 - expr2),结果精确到月。
📄️ months_sub
从日期中减去指定的月数。
📄️ next_day
根据输入的日期值,返回它之后的那个星期几所对应的日期。比如 next_day('2023-04-06', 'Monday') 返回 '2023-04-06' 之后的那个星期一所对应的日期。
📄️ now, current_timestamp, localtime, localtimestamp
获取当前的时间,以 DATETIME 类型返回。
📄️ previous_day
根据输入的日期值,返回它之前的那个星期几所对应的日期。比如 previous_day('2023-04-06', 'Monday') 返回 '2023-04-06' 之前的那个星期一所对应的日期。
📄️ quarter
返回给定的日期值对应的季度,范围 1~4。
📄️ second
获得日期中的秒的信息,返回值范围 0~59。
📄️ seconds_add
向 expr1 添加指定的时间间隔,单位为秒。
📄️ seconds_diff
计算开始时间和结束时间相差多少秒 (expr1 − expr2)。
📄️ seconds_sub
给指定的日期时间或日期减去指定的秒数。
📄️ str2date
按照 format 指定的格式将 str 转换为 DATE 类型的值。如果转换结果不对,返回 NULL。
📄️ str_to_date
按照 format 指定的格式将 str 转换为 DATETIME 类型的值。如果转换结果有误,则返回 NULL。该函数与 dateformat 函数功能相反。
📄️ str_to_jodatime
将某一个 Joda 格式的字符串转换为指定的 Joda DateTime 格式(如 yyyy-MM-dd HHss)的 DATETIME 值。
📄️ time_format
按指定格式格式化 TIME 类型时间值。
📄️ time_slice
根据指定的时间粒度周期,将给定的时间转化为其所在的时间粒度周期的起始或结束时刻。
📄️ time_to_sec
将 time 时间值转换为秒数,转换公式为:
📄️ timediff
返回两个 DATETIME 类型值之间的差值。
📄️ timestamp
将时间表达式 expr 转换为 DATETIME 值。
📄️ timestampadd
将整数表达式间隔添加到日期或日期时间表达式 datetime_expr 中。
📄️ timestampdiff
返回 datetimeexpr2 和 datetimeexpr1 的差值,其中 datetimeexpr1 和datetimeexpr2 是日期或日期时间表达式。
📄️ to_date
返回 DATETIME 类型值中的日期部分。
📄️ to_days
返回指定日期距离 0000-01-01 的天数。
📄️ to_iso8601
将某一个日期转换为 ISO 8601 标准格式的字符串。
📄️ to_tera_date
根据指定的格式解析输入的时间日期字符串,并转换为日期。
📄️ to_tera_timestamp
根据指定的格式解析输入的时间日期字符串,并转换为 DATETIME 类型的值。
📄️ unix_timestamp
将 DATE 或 DATETIME 类型的值转化为 UNIX 时间戳。
📄️ utc_time
Returns the current UTC time as a value in 'HHSS'.
📄️ utc_timestamp
返回当前 UTC 日期时间。
📄️ week
计算指定日期属于一年中的第几周。该函数与 MySQL 中的 WEEK 函数语义相同。该函数从 2.3 版本开始支持。
📄️ week_iso
根据 ISO 标准,计算某一个日期对应的是一年内的第几个周,并返回一个整数值,范围在 1 到 53 之间。
📄️ weekofyear
计算指定时间为一年中的第几周。
📄️ weeks_add
返回原始的日期加上指定周数后的日期。
📄️ weeks_diff
计算开始时间和结束时间相差几周(expr1 - expr2),结果精确到周。
📄️ weeks_sub
返回原始的日期减去若干周后的日期。
📄️ year
返回指定日期中的年份。
📄️ years_add
向 expr1 添加指定的时间间隔,单位为年。
📄️ years_diff
计算开始时间和结束时间相差几年 (expr1 - expr2),结果精确到年。
📄️ years_sub
从指定日期时间或日期减去指定年数。
📄️ yearweek
返回给定日期对应的年份和周数。该函数和 MySQL yearweek() 函数原理相同。