日期和时间函数
📄️ add_months
将指定的月数添加到给定的日期(DATE 或 DATETIME)。monthsadd 函数提供类似的功能。
📄️ adddate,date_add
此函数是 dateadd 的同义词。
📄️ convert_tz
将 DATE 或 DATETIME 值从一个时区转换为另一个时区。
📄️ curdate,current_date
获取当前日期并返回 DATE 类型的值。
📄️ current_timestamp
获取当前日期,如果 DATETIME 类型,则返回值。
📄️ curtime,current_time
获取当前时间并返回 TIME 类型的值。
📄️ date
提取日期或日期时间表达式的日期部分。
📄️ date_add,adddate
将指定的时间间隔添加到日期。
📄️ date_diff
返回两个日期值之间指定单位的差值。此函数返回以单位表示的 expr1 - expr2 的值。
📄️ date_format
根据指定的格式将日期转换为字符串。当前,它支持最多 128 字节的字符串。如果返回值的长度超过 128,则返回 NULL。
📄️ date_slice
根据指定的时间粒度,将给定的时间转换为时间间隔的开始或结束时间。
📄️ date_sub,subdate
从日期中减去指定的时间间隔。
📄️ date_trunc
根据指定的日期部分(例如年、日、小时或分钟)截断时间值。
📄️ datediff
计算两个日期值(expr1 - expr2)之间的差,并返回以天为单位的结果。expr1 和 expr2 是有效的 DATE 或 DATETIME 表达式。
📄️ day
提取日期或日期时间表达式的日部分,并返回一个介于 1 到 31 之间的值。
📄️ dayofweek_iso
返回指定日期的 ISO 标准星期几,作为 1 到 7 范围内的整数。在此标准中,1 表示星期一,7 表示星期日。
📄️ dayname
返回日期对应的日。
📄️ dayofmonth
获取日期中的日部分,并返回一个介于 1 到 31 之间的值。
📄️ dayofweek
返回给定日期的星期几索引。例如,星期日的索引为 1,星期一的索引为 2,星期六的索引为 7。
📄️ dayofyear
返回给定日期的年中天数。
📄️ days_add
将指定的天数添加到给定的日期或日期时间。
📄️ days_diff
返回两个日期表达式(expr1 − expr2)之间的天数差,精确到天。
📄️ days_sub
从日期或日期时间中减去指定的天数以获取新的日期时间。
📄️ from_days
从 0000-01-01 返回日期。
📄️ from_unixtime
将 UNIX 时间戳转换为所需的时间格式。默认格式为 yyyy-MM-dd HHss。它还支持 dateformat 中的格式。
📄️ hour
返回给定日期的小时数。返回值范围为 0 到 23。
📄️ hours_add
将小时数添加到日期或日期时间。
📄️ hours_diff
返回两个日期表达式(expr1 − expr2)之间的小时差,精确到小时。
📄️ hours_sub
将指定的日期和时间减少指定的时数。
📄️ jodatime_format
将指定的日期转换为指定的 Joda DateTimeFormat 模式格式的字符串。
📄️ last_day
返回基于指定日期部分的输入 DATE 或 DATETIME 表达式的最后一天。例如,last_day('2023-05-10', 'month') 返回 '2023-05-10' 所在的月份的最后一天。
📄️ makedate
基于给定的年份和年中天数值创建并返回日期。
📄️ microseconds_add
将时间间隔添加到日期值。时间间隔以微秒为单位。
📄️ microseconds_sub
从日期值中减去时间间隔。时间间隔以微秒为单位。
📄️ milliseconds_diff
返回开始日期和结束日期之间以毫秒为单位的时间差。
📄️ minute
返回给定日期的分钟数。返回值范围为 0 到 59。
📄️ minutes_add
将指定的分钟数添加到日期,精确到分钟。
📄️ minutes_diff
返回两个日期表达式(expr1 − expr2)之间的分钟差,精确到分钟。
📄️ minutes_sub
从日期中减去指定的分钟数,精确到分钟。
📄️ month
返回给定日期的月份。返回值范围为 1 到 12。
📄️ monthname
返回给定日期的月份名称。
📄️ months_add
将指定的月数添加到日期,精确到月份。
📄️ months_diff
返回两个日期表达式(expr1 − expr2)之间的月份差,精确到月份。
📄️ months_sub
从日期中减去指定的月份。
📄️ next_day
返回输入日期(DATE 或 DATETIME)之后出现的第一个指定的星期几 (DOW) 的日期。例如,next_day('2023-04-06', 'Monday') 返回 '2023-04-06' 之后发生的下一个星期一的日期。
📄️ now, current_timestamp, localtime, localtimestamp
返回当前日期和时间。
📄️ previous_day
返回输入日期(DATE 或 DATETIME)之前发生的第一个指定的星期几 (DOW) 的日期。例如,previous_day('2023-04-06', 'Monday') 返回 '2023-04-06' 之前发生的上一个星期一的日期。
📄️ quarter
返回日期的季度部分,范围为 1 到 4。
📄️ second
返回给定日期的秒部分。返回值范围为 0 到 59。
📄️ seconds_add
描述
📄️ seconds_diff
返回两个日期表达式(expr1 − expr2)之间的秒差,精确到秒。
📄️ seconds_sub
从日期值中减去时间间隔。时间间隔以秒为单位。
📄️ str2date
根据指定的格式将字符串转换为 DATE 值。如果转换失败,则返回 NULL。
📄️ str_to_date
根据指定的格式将字符串转换为 DATETIME 值。如果转换失败,则返回 NULL。
📄️ str_to_jodatime
以指定的 Joda DateTime 格式(如 yyyy-MM-dd HHss)将 Joda 格式的字符串转换为 DATETIME 值。
📄️ time_format
以指定的格式格式化 TIME 类型的值。
📄️ time_slice
根据指定的时间粒度,将给定的时间转换为时间间隔的开始或结束时间。
📄️ time_to_sec
将时间值转换为秒数。用于转换的公式如下
📄️ timediff
返回两个 DATETIME 表达式之间的差。
📄️ timestamp
返回日期或日期时间表达式的 DATETIME 值。
📄️ timestampadd
将整数表达式间隔添加到日期或日期时间表达式 datetime_expr。
📄️ timestampdiff
返回从 datetimeexpr2 到 datetimeexpr1 的间隔。datetimeexpr1 和 datetimeexpr2 必须是 DATE 或 DATETIME 类型。
📄️ to_date
将 DATETIME 值转换为日期。
📄️ to_days
返回日期与 0000-01-01 之间的天数。
📄️ to_iso8601
将指定的日期转换为 ISO 8601 格式的字符串。
📄️ to_tera_date
根据指定的格式解析日期或时间字符串,并将字符串转换为 DATE 值。
📄️ to_tera_timestamp
根据指定的格式解析日期或时间字符串,并将字符串转换为 DATETIME 值。
📄️ unix_timestamp
将 DATE 或 DATETIME 值转换为 UNIX 时间戳。
📄️ utc_time
返回当前 UTC 时间,格式为“HHss”。
📄️ utc_timestamp
返回当前的 UTC 日期和时间,根据该函数的使用方式(例如,在字符串或数值上下文中),返回值格式为“YYYY-MM-DD HHss”或“YYYYMMDDHHMMSS”。
📄️ week
返回给定日期的星期数。此函数的工作方式与 MySQL 中的 WEEK 函数相同。
📄️ week_iso
返回指定日期的 ISO 标准年份周,作为 1 到 53 范围内的整数。
📄️ weekofyear
返回一年中给定日期的星期数。
📄️ weeks_add
返回将周数添加到日期后的值。
📄️ weeks_diff
返回两个日期表达式(expr1 − expr2)之间的周差,精确到周。
📄️ weeks_sub
从日期时间或日期值中减去指定的周数。
📄️ year
返回日期中的年份部分,并返回一个介于 1000 到 9999 之间的值。
📄️ years_add
描述
📄️ years_diff
返回两个日期表达式(expr1 − expr2)之间的年份差,精确到年份。
📄️ years_sub
从指定的日期时间或日期中减去指定的年数。
📄️ yearweek
返回给定日期的年份和星期数。此函数的工作方式与 MySQL 中的 yearweek() 函数相同。