时间和日期处理函数和操作符
时间/日期函数
相比于原始的MogDB，dolphin对于时间/日期函数的修改主要为:
- 新增
dayofmonth/dayofweek/dayofyear/hour/microsecond/minute/quarter/second/weekday/weekofyear/year/current_date函数。 - 新增
curdate/current_time/curtime/current_timestamp/localtime/localtimestamp/now/sysdate函数。 - 新增
makedate/maketime/period_add/period_diff/sec_to_time/subdate函数。 - 新增
subtime/timediff/time/time_format/timestamp/timestamppadd函数。 - 新增
to_days/to_seconds/unix_timestamp/utc_date/utc_time/utc_timestamp函数。 - 新增
date_bool/time_bool函数。 - 新增
dayname/monthname/time_to_sec/month/day/date/week/yearweek函数，修改了last_day函数。 - 新增
datediff/from_days/convert_tz/date_add/date_sub/adddate/addtime函数，修改了timestampdiff函数。
-
curdate()
描述：返回语句开始执行的日期。
返回值类型：date
示例：
MogDB=# select curdate(); curdate ------------ 2022-07-21 (1 row) -
current_time
描述：返回语句开始执行的时间。
返回值类型：time
示例：
MogDB=# select current_time; current_time -------------- 16:56:02 (1 row) -
current_time(n)
描述：返回语句开始执行的时间，n为精度，最大值取6。
返回值类型：time
示例：
MogDB=# select current_time(3); current_time(3) ----------------- 16:57:23.255 (1 row) MogDB=# select current_time(); current_time() ---------------- 17:05:01 (1 row) -
curtime(n)
描述：返回语句开始执行的时间，n为精度，最大值取6。
返回值类型：time
示例：
MogDB=# select curtime(3); curtime(3) -------------- 17:45:33.844 (1 row) MogDB=# select curtime(); curtime() ----------- 17:45:54 (1 row) -
current_timestamp
描述：返回语句开始执行的时间戳。
返回值类型：datetime
示例：
MogDB=# select current_timestamp; current_timestamp --------------------- 2022-07-21 16:59:38 (1 row) -
current_timestamp(n)
描述：返回语句开始执行的时间戳，n为精度，最大值取6。
返回值类型：datetime
示例：
MogDB=# select current_timestamp(3); current_timestamp(3) ------------------------- 2022-07-21 17:00:41.251 (1 row) MogDB=# select current_timestamp(); current_timestamp() --------------------- 2022-07-21 17:06:06 (1 row) -
dayofmonth(timestamp)
描述：获取日期/时间值中天数的值。
返回值类型：double precision
示例：
MogDB=# SELECT dayofmonth(timestamp '2001-02-16 20:38:40'); date_part ----------- 16 (1 row) -
dayofweek(timestamp)
描述：获取日期/时间值中星期的标号（1代表星期日，2代表星期一，以此类推，7代表星期六）。
返回值类型：double precision
示例：
MogDB=# SELECT dayofweek(timestamp '2001-02-16 20:38:40'); ?column? ---------- 6 (1 row) -
dayofyear(timestamp)
描述：获取日期/时间值中一年的第几天。
返回值类型：double precision
示例：
MogDB=# SELECT dayofyear(timestamp '2001-02-16 20:38:40'); date_part ----------- 47 (1 row) -
hour(timestamp)
描述：获取日期/时间值中小时的值。
返回值类型：double precision
示例：
MogDB=# SELECT hour(timestamp '2001-02-16 20:38:40'); date_part ----------- 20 (1 row) -
localtime
描述：返回语句开始执行的时间戳。
返回值类型：datetime
示例：
MogDB=# select localtime; localtime --------------------- 2022-07-21 17:02:04 (1 row) -
localtime(n)
描述：返回语句开始执行的时间戳，n为精度，最大值取6。
返回值类型：datetime
示例：
MogDB=# select localtime(3); localtime --------------------- 2022-07-21 17:02:04 (1 row) MogDB=# select localtime(); localtime() --------------------- 2022-07-21 17:14:22 (1 row) -
localtimestamp
描述：返回语句开始执行的时间戳。
返回值类型：datetime
示例：
MogDB=# select localtimestamp; localtimestamp --------------------- 2022-07-21 17:17:20 (1 row) -
localtimestamp(n)
描述：返回语句开始执行的时间戳，n为精度，最大值取6。
返回值类型：datetime
示例：
MogDB=# select localtimestamp(3); localtimestamp(3) ------------------------- 2022-07-21 17:28:02.013 (1 row) MogDB=# select localtimestamp(); localtimestamp() --------------------- 2022-07-21 17:28:49 (1 row) -
MAKEDATE()
函数原型:
DATE MAKEDATE(int64 year, int64 dayofyear)功能描述：给定年份和天数，返回该年份在此年份天数下日期值。
备注:
- 任一为NULL，函数返回NULL。
dayofyear必须大于0否则返回NULL。- 0 <= year < 70时：将year视作20XX年处理。 70 <= year < 100时：将year视作19XX年处理。
- 返回结果限制在[0, 9999-12-31],超出范围返回NULL。
示例:
MogDB=# SELECT MAKEDATE(2022,31), MAKEDATE(2022,32); makedate | makedate ------------+------------ 2022-01-31 | 2022-02-01 (1 row) -- 0<= year < 70 以及 70 <= year < 100 MogDB=# SELECT MAKEDATE(0,31), MAKEDATE(70,32); makedate | makedate ------------+------------ 2000-01-31 | 1970-02-01 (1 row) -- dayofyear <= 0 以及 超出范围 的情况 MogDB=# SELECT MAKEDATE(2022,0), MAKEDATE(9999,366); makedate | makedate ----------+---------- | (1 row) -
MAKETIME()
函数原型:
TIME MAKETIME(int64 hour, int64 minue, Numeric second)功能描述：
给定小时、分钟和秒参数，返回TIME类型值。
备注:
- 当参数满足如下任一条件时，函数返回NULL:
- minue < 0 or minue >= 60
- second < 0 or second >= 60
- 任一参数为NULL
- 返回的Time结果保留6位小数，若second超出六位小数，则按照四舍五入进位。
- 返回TIME类型值要求在[-838:59:59, 838:59:59]中。若超出范围，则根据hour的正负类型，来返回指定的边界值。
示例：
MogDB=# SELECT MAKETIME(15, 15, 15.5); maketime ------------ 15:15:15.5 (1 row) -- 四舍五入进位 MogDB=# SELECT MAKETIME(10, 15, 20.5000005); maketime ----------------- 10:15:20.500001 (1 row) -- 四舍五入进位 MogDB=# SELECT MAKETIME(839,0,0); maketime ----------- 838:59:59 (1 row) - 当参数满足如下任一条件时，函数返回NULL:
-
microsecond(timestamp)
描述：获取日期/时间值中微秒的值。
返回值类型：double precision
示例：
MogDB=# SELECT microsecond(timestamp '2001-02-16 20:38:40.123'); date_part ----------- 123000 (1 row) -
minute(timestamp)
描述：获取日期/时间值中分钟的值。
返回值类型：double precision
示例：
MogDB=# SELECT minute(timestamp '2001-02-16 20:38:40.123'); date_part ----------- 38 (1 row) -
now(n)
描述：返回语句开始执行的时间戳，n为精度，最大值取6。
返回值类型：datetime
示例：
MogDB=# select now(3); now(3) ------------------------- 2022-07-21 17:30:18.037 (1 row) MogDB=# select now(); now() --------------------- 2022-07-21 17:30:51 (1 row) -
PERIOD_ADD()
函数原型:
int64 PERIOD_ADD(int64 P, int64 N)功能描述：
返回时期
P(格式为YYYYMM或YYMM)加上N个月后的时期值，格式为YYYYMM。备注:
- 当任一参数为NULL时，函数返回NULL。
P= 0时，返回0。- 参数的时期
P与返回结果的时期中的年份小于100时，会以70为边界，将年份转为20XX年或19XX年。
示例：
MogDB=# SELECT PERIOD_ADD(202201, 2); period_add ------------ 202203 (1 row) -- p = 0 MogDB=# SELECT PERIOD_ADD(0, 2); period_add ------------ 0 (1 row) -- 时期的年份处于[0,70) 或 [70, 100)范围内 MogDB=# SELECT PERIOD_ADD(0101, 2), PERIOD_ADD(7001, 2); period_add | period_add ------------+------------ 200103 | 197003 (1 row) -
PERIOD_DIFF()
函数原型:
int64 PERIOD_DIFF(int64 P1, int64 P2)功能描述：
返回两个时期参数
P1与P2的月份数差值。备注:
- 当任一参数为NULL时，函数返回NULL。
- 时期参数
P1和P2中的年份小于100时，会以70为边界，将年份转为20XX年或19XX年。
示例:
MogDB=# SELECT PERIOD_DIFF(202201,202003); period_diff ------------- 22 (1 row) MogDB=# SELECT PERIOD_DIFF(0101,7001); period_diff ------------- 372 (1 row) -
quarter(timestamp)
描述：获取日期/时间值中的季度数，从1到4。
返回值类型：double precision
示例：
MogDB=# SELECT quarter(timestamp '2001-02-16 20:38:40.123'); date_part ----------- 1 (1 row) -
second(timestamp)
描述：获取日期/时间值中的秒数。
返回值类型：double precision
示例：
MogDB=# SELECT second(timestamp '2001-02-16 20:38:40.123'); date_part ----------- 40 (1 row) -
SEC_TO_TIME()
函数原型:
TIME SEC_TO_TIME(Numeric second)功能描述：
给定秒数，将其转为小时、分钟与秒，返回TIME类型值。
备注:
- 当任一参数为NULL，函数返回NULL。
- 返回TIME类型值只保留小数点后6位，超出部分按照四舍五入规则进位。
- 返回TIME类型值要求在[-838:59:59, 838:59:59]中。若超出范围，则根据second的正负类型，来返回指定的边界值。
示例:
MogDB=# SELECT SEC_TO_TIME(4396); sec_to_time ------------- 01:13:16 (1 row) -- 四舍五入进位 MogDB=# SELECT SEC_TO_TIME(2378.2222225); sec_to_time ----------------- 00:39:38.222223 (1 row) -- 返回结果超出范围 MogDB=# SELECT SEC_TO_TIME(3888888); sec_to_time ------------- 838:59:59 (1 row) -
SUBDATE(expr, interval)
函数原型:
CString SUBDATE(text date, INTERVAL expr unit) CString SUBDATE(text date, int64 days)功能描述：
该函数执行日期运算。参数
date指定开始DATE或DATETIME类型值。指定要从开始日期减去的INTERVAL值，返回相减后的结果日期值。若第二参数为整数，则将其视为减去的天数值。备注:
- 函数返回格式为DATE或DATETIME。一般情况下，返回类型与第一参数的类型相同。当第一参数的类型为DATE时且INTERVAL的单位包含HOUR、MINUTE、SECOND部分，则返回结果为DATETIME。
- 参数满足如下任一条件时，函数返回NULL：
- 参数date的日期超出范围[0, 9999-12-31]。
- 任一参数为NULL。
- 返回结果的日期必须在范围[0001-1-1, 9999-12-31]内。若越界，则返回NULL。
示例:
MogDB=# SELECT SUBDATE('2022-01-01', INTERVAL 31 DAY), SUBDATE('2022-01-01', 31); subdate | subdate ------------+------------ 2021-12-01 | 2021-12-01 (1 row) -- 第一参数为DATE MogDB=# SELECT SUBDATE('2022-01-01 01:01:01', INTERVAL 1 YEAR); subdate --------------------- 2021-01-01 01:01:01 (1 row) -- 第一参数为DATETIME MogDB=# SELECT SUBDATE('2022-01-01 01:01:01', INTERVAL 1 YEAR); subdate --------------------- 2021-01-01 01:01:01 (1 row) -- 第一参数为DATE但是INTERVAL的单位包含TIME部分 MogDB=# SELECT SUBDATE('2022-01-01', INTERVAL 1 SECOND); subdate --------------------- 2021-12-31 23:59:59 (1 row) -
SUBDATE(TIME, interval)
函数原型:
TIME SUBDATE(TIME time, INTERVAL expr unit) TIME SUBDATE(TIME time, int64 days)功能描述：
该函数是为兼容MySql中subdate函数的第一参数类型可以为TIME的情况。该情况下，第一参数的输入必须为原始的TIME数据，而非由字符串的隐式转换而来。 参数
time指定开始TIME类型的时间值，第二参数指定要从开始时间减去的INTERVAL值，返回相减后的结果日期值。若第二参数为整数，则将其视为减去的天数值。备注:
- 第一参数必须为原始的TIME类型，而非由字符串的隐式转换而来。如SUBDATE(‘1:1:1’, 1)并不会进入此函数。需改为SUBDATE(time’1:1:1’, 1)。
- 第二参数的INTERVAL单位不能包含年或月部分，否则返回NULL。
- 返回值必须在[-838:59:59, 838:59:59]内，否则返回NULL。
示例:
MogDB=# SELECT SUBDATE(time'10:15:20', INTERVAL '1' DAY), SUBDATE(time'10:15:20', 1); subdate | subdate -----------+----------- -13:44:40 | -13:44:40 (1 row) -- 第二参数的INTERVAL单位不能包含年或月部分 MogDB=# SELECT SUBDATE(time'838:00:00', INTERVAL '1' MONTH); subdate --------- (1 row) -- 结果超出范围 MogDB=# SELECT SUBDATE(time'838:59:59', INTERVAL '-1' SECOND); subdate --------- (1 row) -
SUBTIME()
函数原型:
TEXT SUBTIME(TIME time1, TIME time2) TEXT SUBTIME(DATETIME time1, TIME time2)功能描述：
该函数执行日期运算，返回DATETIME或TIME表达式
time1减去TIME表达式time2的结果。返回参数类型与time1传入类型保持一致。备注:
time1需要是正确合法的TIME格式或者DATETIME格式，否则报错。time2需要是正确合法的TIME格式，否则报错。- 如返回值超出[-838:59:59, 838:59:59]，则会根据符号返回极值。
示例:
MogDB=# select subtime('11:22:33','10:20:30'); subtime ------ 01:02:03 (1 row) MogDB=# select SUBTIME('2020-03-04 11:22:33', '-10:20:30'); subtime ------ 2020-03-04 21:43:03 (1 row) -
sysdate(n)
描述：返回系统实时时间戳，n为精度，最大值取6。
返回值类型：datetime
示例：
MogDB=# select sysdate(3); sysdate(3) ------------------------- 2022-07-21 17:38:23.442 (1 row) MogDB=# select sysdate(); sysdate() --------------------- 2022-07-21 17:39:02 (1 row) -
time()
函数原型:
Text TIME(TEXT expr)功能描述：
兼容mysql的time()函数。参数指定一个TIME或DATETIME表达式，提取其中的time表达式并返回为字符串。
备注:
- 返回的时间表达式中最多保留六位小数，超出部分按照四舍五入进位。
- 对于异常的日期或时间格式或是域溢出的日期或时间(如1:60:60、2022-12-32 等)，本函数兼容mysql中该函数于insert语句中的表现，即报错。
- date格式字符串将会报错，而date类型参数将会返回"00:00:00"。
示例:
MogDB=# select time('2022-1-1 1:1:1.1111116'), time('25:25:25'); time | time -----------------+---------- 01:01:01.111112 | 25:25:25 (1 row) MogDB=# select time(date'2022-1-1'); time ---------- 00:00:00 (1 row) -
TIMEDIFF()
函数原型:
TIME TIMEDIFF(TIME time1, TIME time2) DATETIME TIMEDIFF(DATETIME time1, DATETIME time2)功能描述：
该函数执行日期运算，返回
time1减去time2的结果。返回参数类型与传入类型保持一致。备注:
time1, time2类型需要一致且均合法，否则返回NULL。- 如
time1, time2均为TIME类型且返回值超出[-838:59:59, 838:59:59]，函数将会报错。
示例:
MogDB=# select TIMEDIFF(time'23:59:59',time'01:01:01'), TIMEDIFF(datetime'2008-12-31 23:59:59',datetime'2008-12-30 01:01:01'); timediff | timediff ----------+---------- 22:58:58 | 46:58:58 (1 row) -- 超出范围时返回极值。 MogDB=# SELECT TIMEDIFF(time'-830:00:00', time'10:20:30'), TIMEDIFF(time'830:00:00', time'-10:20:30'); timediff | timediff ------------+----------- -838:59:59 | 838:59:59 (1 row) -
TIMESTAMP()
函数原型:
DATETIME TIMESTAMP(TEXT expr) DATETIME TIMESTAMP(TEXT expr, TIME time)功能描述：
只有一个参数时，函数将DATE或DATETIME表达式
expr转为DATETIME值返回。有两个参数时，函数计算DATE或DATETIME表达式
expr加上TIME类型time的结果并返回。备注:
expr为不存在的date或datetime表达式时。如’2000-12-32’，'2000-1-1 24:00:00’等，函数报错。- 包含两个参数且第二参数
time为非TIME格式字符串时，函数报错。
示例:
MogDB=# select TIMESTAMP('2022-01-01'), TIMESTAMP('20220101'); timestamp | timestamp ---------------------+--------------------- 2022-01-01 00:00:00 | 2022-01-01 00:00:00 (1 row) MogDB=# select TIMESTAMP('2022-01-31 12:00:00.123456'), TIMESTAMP('20000229120000.1234567'); timestamp | timestamp ----------------------------+---------------------------- 2022-01-31 12:00:00.123456 | 2000-02-29 12:00:00.123457 (1 row) MogDB=# select TIMESTAMP('2022-01-31','12:00:00.123456'), TIMESTAMP('2022-01-31 12:00:00','-32:00:00'); timestamp | timestamp ----------------------------+--------------------- 2022-01-31 12:00:00.123456 | 2022-01-30 04:00:00 (1 row) MogDB=# select TIMESTAMP('20000229','100:00:00'), TIMESTAMP('20000229120000.123','100:00:00'); timestamp | timestamp ---------------------+------------------------- 2000-03-04 04:00:00 | 2000-03-04 16:00:00.123 (1 row) -
timestamp_add()
函数原型：
TEXT TIMESTAMP_ADD(text unit, interval span, text datetime)功能描述：
将一段时间加到已知的时间点上。其中第一个参数
unit是时间单位，第二个参数span是具体数值，第三个参数datetime是已知时间点。备注：
-
unit支持的单位如下：单位 对应的输入 年 year 季度 qtr 月 month 周 week 日 day 时 hour 分 minute 秒 second 微秒 microsecon -
span支持小数。当unit为秒时，span根据第七位小数，四舍五入到六位小数；否则span四舍五入到整数。 -
datetime的输入类型可以是字符串、date、datetime、time。 -
datetime的输入范围和函数的计算结果均需落在区间[0001-01-01 00:00:00.000000, 9999-12-31 23:59:59.999999]内，否则报错(兼容mysql中该函数于insert语句的表现)。 -
对于异常的日期或时间格式或是域溢出的日期或时间(如1:60:60、2022-12-32 等)，本函数兼容mysql中该函数于insert语句中的表现，即报错。
示例：
MogDB=# select timestampadd(day, 1, '2022-09-01'); timestampadd -------------- 2022-09-02 (1 row) MogDB=# select timestampadd(hour, 1, '2022-09-01 08:00:00'); timestampadd --------------------- 2022-09-01 09:00:00 (1 row) -
-
time_format()
函数原型:
TEXT TIME_FORMAT(text time, text format)。功能描述：
第一参数
time为time或datetime表达式，函数基于第二参数format格式化time值并返回为字符串。备注:
-
format支持的格式如下:格式 描述 ％f 微秒（000000至999999） ％H 小时（00到23） ％h 小时（00到12） ％I 小时（00到12） ％i 分钟（00至59） ％p AM or PM ％r 时间为12小时AM或PM格式（hh：mm：ss AM / PM） ％S 秒（00到59） ％s 秒（00到59） ％T 24小时格式的时间（hh：mm：ss） %k 小时数 -
对于非时分秒相关的格式，会返回0或NULL，包括：
格式 返回结果 %a、%b、%D、%j、%M、%U、%u、%V、%v、%W、%w、%X、%x NULL %c 、%e 0 %d、%m、%y 00 %Y 0000
提取的时间值最多保留六位小数，超出部分按照四舍五入进位。
示例:
MogDB=# select TIME_FORMAT('83:59:59.0000009', '%T|%r|%H|%h|%I|%i|%S|%f|%p|%k'); time_format -------------------------------------------------- 83:59:59|11:59:59 AM|83|11|11|59|59|000001|AM|83 (1 row) MogDB=# select TIME_FORMAT('2022-1-1 23:59:59.0000009', '%T|%r|%H|%h|%I|%i|%S|%f|%p|%k'); time_format -------------------------------------------------- 23:59:59|11:59:59 PM|23|11|11|59|59|000001|PM|23 -
-
weekday(timestamp)
描述：获取日期/时间值中是一周中的星期几（0代表星期一，1代表星期二，以此类推，6代表星期日）。
返回值类型：double precision
示例：
MogDB=# SELECT weekday(timestamp '2001-02-16 20:38:40.123'); ?column? ---------- 4 (1 row) -
weekofyear(timestamp)
描述：获取日期/时间值中是一年的第几周。
返回值类型：double precision
示例：
MogDB=# SELECT weekofyear(timestamp '2001-02-16 20:38:40.123'); date_part ----------- 7 (1 row) -
year(timestamp)
描述：获取日期/时间值中的年数。
返回值类型：double precision
示例：
MogDB=# SELECT year(timestamp '2001-02-16 20:38:40.123'); year ------ 2001 (1 row) -
current_date()
描述：当前日期。
返回值类型：date
示例：
MogDB=# SELECT current_date; date ------------ 2017-09-01 (1 row) -
to_days()
函数原型：
int8 TO_DAYS(DATETIME date)功能描述：接受一个date或datetime表达式作为参数，返回参数所指定的日期到0000年所经过的天数
备注:
- 若入参类型为time类型，将用于计算的日期将为当前日期加上time指定时间后得到的日期。
- 若输入日期超出[0000-01-01, 9999-12-31]的范围或入参为非法的date或datetime表达式，函数报错。
示例：
MogDB=# select to_days('0000-01-01'); to_days --------- 1 (1 row) MogDB=# select to_days('2022-09-05 23:59:59.5'); to_days --------- 738768 (1 row) -- 当前日期为: 2022-09-05 MogDB=# select to_days(time'25:00:00'); to_days --------- 738769 (1 row) -
to_seconds()
函数原型：
NUMERIC TO_SECONDS(text datetime)功能描述：输入一个时间点
datetime，返回0000-01-01 00:00:00到该时间点所经过的秒数备注：
- 参数
datetime支持的类型有：字符串、数值、date、datetime、time等。当输入参数为time类型时，日期会被自动设置为当前日期。 - 返回的结果只保留整秒数，小数部分直接舍弃。
示例：
MogDB=# select to_seconds('2022-09-01'); to_seconds ------------- 63829209600 (1 row) MogDB=# select to_seconds('2022-09-01 12:30:30.888'); to_seconds ------------- 63829254630 (1 row) MogDB=# select to_seconds(20220901123030); to_seconds ------------- 63829254630 (1 row) - 参数
-
unix_timestamp()
函数原型：
NUMERIC UNIX_TIMESTAMP() NUMERIC UNIX_TIMESTAMP(text datetime)功能描述：
- 不输入任何参数，直接执行该函数，返回
1970-01-01 00:00:00 UTC到当前时间点所经过的秒数 - 输入一个时间点
datetime，返回1970-01-01 00:00:00 UTC到datetime所经过的秒数
备注：
- 参数
datetime支持的类型有：字符串、数值、date、datetime、time等。当输入参数为time类型时，日期会被自动设置为当前日期。 - 参数
datetime的有效范围为[1970-01-01 00:00:00.000000 UTC, 2038-01-19 03:14:07.999999 UTC]。 - 参数的输入范围会受到时区的影响，但最终计算结果不受时区影响。
- 计算结果最多只保留六位小数。
示例：
MogDB=# select unix_timestamp('2022-09-01'); unix_timestamp ---------------- 1661961600 (1 row) MogDB=# select unix_timestamp('2022-09-01 12:30:30.888'); unix_timestamp ---------------- 1662006630.888 (1 row) MogDB=# select unix_timestamp(20220901123030.6); unix_timestamp ---------------- 1662006630.6 (1 row) - 不输入任何参数，直接执行该函数，返回
-
utc_date()
函数原型：
DATE UTC_DATE()功能描述：返回当前的UTC日期，类型为DATE。
备注：
- UTC_DATE能够以关键词的形式识别，此时无需包含括号。
示例：
MogDB=# select UTC_DATE(); utc_date ------------ 2022-09-06 (1 row) MogDB=# select UTC_DATE; utc_date ------------ 2022-09-06 (1 row) -
utc_time()
函数原型：
TIME UTC_TIME()TIME UTC_TIME(int fsp)功能描述：返回当前的UTC时间，类型为TIME。若给定一个整数参数作为精度，则能够指定结果保留的小数数量，支持精度范围为[0-6]
备注：
- UTC_TIME能够以关键词的形式识别，此时无需包含括号。效果等同于无参数的UTC_TIME()函数。
示例：
MogDB=# select UTC_TIME(); utc_time ---------- 15:13:54 (1 row) MogDB=# select UTC_TIME(6); utc_time ---------------- 15:13:56.59698 (1 row) MogDB=# select UTC_TIME; utc_time ---------- 15:14:01 (1 row) -
utc_timestamp()
函数原型：
DATETIME UTC_TIMESTAMP()DATETIME UTC_TIMESTAMP(int fsp)
功能描述：返回当前的UTC日期时间值，类型为DATETIME。若给定一个整数参数作为精度，则能够指定结果保留的小数数量，支持精度范围为[0-6]。
备注:
- UTC_TIMESTAMP能够以关键词的形式识别，此时无需包含括号。效果等同于无参数的UTC_TIMESTAMP()函数。
示例：
MogDB=# select UTC_TIMESTAMP(); utc_timestamp --------------------- 2022-09-06 15:16:28 (1 row) MogDB=# select UTC_TIMESTAMP(6); utc_timestamp ---------------------------- 2022-09-06 15:16:34.691118 (1 row) MogDB=# select UTC_TIMESTAMP; utc_timestamp --------------------- 2022-09-06 15:16:39 -
date_bool(date)
描述：根据日期值中的年数返回布尔型（为零时返回false，否则返回true）。
返回值类型：boolean
示例：
MogDB=# select time_bool('18:50:00'); time_bool ----------- t (1 row) MogDB=# select time_bool('00:50:00'); time_bool ----------- f (1 row) -
time_bool(time)
描述：根据时间值中的小时数返回布尔型（为零时返回false，否则返回true）。
返回值类型：boolean
示例：
MogDB=# select date_bool('2022-08-20'); date_bool ----------- t (1 row) MogDB=# select date_bool('0000-08-20'); date_bool ----------- f (1 row) -
dayname(date)
描述：返回日期对应的工作日，返回内容所在语言集受GUC参数lc_time_names控制。
返回值类型：text
备注：此函数兼容MySQL插表时参数及结果约束。
示例：
MogDB=# select dayname('2000-1-1'); dayname ---------- Saturday (1 row) MogDB=# alter system set lc_time_names = 'zh_CN'; ALTER SYSTEM SET MogDB=# select dayname('2000-1-1'); dayname --------- 星期六 (1 row) -
monthname(date)
描述：返回日期对应月份的全称，返回内容所在语言集受GUC参数lc_time_names控制。
返回值类型：text
备注：此函数兼容MySQL插表时参数及结果约束。
示例：
MogDB=# select monthname('2000-1-1'); monthname ----------- January (1 row) MogDB=# alter system set lc_time_names = 'zh_CN'; ALTER SYSTEM SET MogDB=# select monthname('2000-1-1'); monthname ----------- 一月 (1 row) -
time_to_sec(time)
描述：将时间转换为秒数。
返回值类型：integer
备注：此函数兼容MySQL插表时参数及结果约束。
示例：
MogDB=# select time_to_sec('838:59:59'); time_to_sec ------------- 3020399 (1 row) MogDB=# select time_to_sec('-838:59:59'); time_to_sec ------------- -3020399 (1 row) -
month(date)
描述：返回日期中的月份。
返回值类型：integer
备注：此函数兼容MySQL插表时参数及结果约束。
示例：
MogDB=# select month('2021-11-12'); month ------- 11 (1 row) MogDB=# select month('2021-11-0'); month ------- 11 (1 row) -
day(date)
描述：返回日期中的天数。
返回值类型：integer
备注：此函数兼容MySQL插表时参数及结果约束。
示例：
MogDB=# select day('2021-11-12'); day ----- 12 (1 row) MogDB=# select day('2021-0-0'); day ----- 0 (1 row) -
date(expr)
描述：expr识别为date或者datetime表达式，从expr中提取出日期部分。
返回值类型：text
备注：此函数兼容MySQL插表时参数及结果约束。
示例：
MogDB=# select date('2021-11-12'); date ------------ 2021-11-12 (1 row) MogDB=# select date('2021-11-12 23:59:59.9999999'); date ------------ 2021-11-13 (1 row) MogDB=# select date('2021-11-0'); date ------------ 2021-11-00 (1 row) MogDB=# select date('2021-0-3'); date ------------ 2021-00-03 (1 row) -
last_day(expr)
描述：expr识别为date或者datetime，返回该月对应的最后一天的日期。
返回值类型：date
备注：此函数兼容MySQL插表时参数及结果约束。在B模式数据库中，当GUC参数b_compatibility_mode为true时，此函数代替MogDB原有last_day函数。
示例：
MogDB=# set b_compatibility_mode = true; SET MogDB=# select last_day('2021-1-30'); last_day ------------ 2021-01-31 (1 row) MogDB=# select last_day('2021-1-0'); last_day ------------ 2021-01-31 (1 row) -
week(date[,mode])
描述：返回date参数代表的日期在一年中的第几周。mode参数为可选整型参数，范围为[0,7]。无mode参数传入时，GUC参数default_week_format会作为默认mode参数。
mode参数的各种取值及其意义如下：
mode 意义 0 Sunday为一周的第一天；week的取值范围为[0-53]；一年的第一周必须包含Sunday 1 Monday为一周的第一天；week的取值范围为[0-53]；一年的第一周必须有大于等于4天在此年内 2 Sunday为一周的第一天；week的取值范围为[1-53]；一年的第一周必须包含Sunday 3 Monday为一周的第一天；week的取值范围为[1-53]；一年的第一周必须有大于等于4天在此年内 4 Sunday为一周的第一天；week的取值范围为[0-53]；一年的第一周必须有大于等于4天在此年内 5 Monday为一周的第一天；week的取值范围为[0-53]；一年的第一周必须包含Monday 6 Sunday为一周的第一天；week的取值范围为[1-53]；一年的第一周必须有大于等于4天在此年内 7 Monday为一周的第一天；week的取值范围为[1-53]；一年的第一周必须包含Monday 对于一周的第一天，week取值范围，判定一年第一周的条件的说明：
-
一周的第一天指一周开始的那一天，Monday或者Sunday可能为一周的第一天。
-
week取值范围指WEEK函数返回值的取值范围，有[0-53]和[1-53]两种取值范围。其中[0-53]中的0代表给定日期实际位于其所在年份上一年的最后一周内，但为了将返回结果与给定日期所在年份联系起来，故认为给定日期位于其所在年份的第零周（也即还未开始第一周）。若希望给定日期所在周数与其所在年份关系更紧密，则应该使用0、1、4或者5作为mode值，这样，当给定日期位于其所在年份上一年的最后一周时，WEEK函数会返回0。
-
判定一年第一周的条件
指判定所给日期位于当前年的第一周的条件，一般而言只有日期位于年份的边界才会进行判定。此判定有两种方式，由mode参数决定使用哪种方式。
- 方式一：若Monday或者Sunday是一周的第一天，并且Monday或者Sunday在给定日期所在年内，则此周为日期所在年份的第一周。对应mode取值为0、2、5和7。
- 方式二：若给定日期所在的周有大于等于4天位于日期所在年内，则此周为日期所在年份的第一周；否则此周为上一年的最后一周。对应mode取值为1、3、4和6。
返回值类型：integer
备注：此函数兼容MySQL插表时参数及结果约束。
示例：
MogDB=# show default_week_format; default_week_format --------------------- 0 (1 row) -- 给定日期位于前一年的最后一周内，mode为0 MogDB=# select week('2000-1-1'); week ------ 0 (1 row) MogDB=# alter system set default_week_format = 2; ALTER SYSTEM SET -- 给定日期位于前一年的最后一周内，mode为2 MogDB=# select week('2000-1-1'); week ------ 52 (1 row) MogDB=# select week('2000-1-1', 2); week ------ 52 (1 row) -
-
yearweek(date[,mode])
描述：返回date参数代表的日期所在的年份和周。mode为可选整型参数，取值范围为[0,7]。无mode参数传入时，0会作为默认mode参数，GUC参数default_week_format不会影响yearweek函数。mode参数详细意义参见week函数。
yearweek函数不会返回0周，即week取值范围始终为[1-53]，不受mode参数影响。
返回值类型：bigint
备注：此函数兼容MySQL插表时参数及结果约束。
示例：
MogDB=# select week('1987-01-01', 0); week ------ 0 (1 row) MogDB=# select yearweek('1987-01-01', 0); yearweek ---------- 198652 (1 row) -
datediff(expr1,expr2)
描述：expr1和expr2可以是date或者datetime，计算expr1-expr2代表的天数，只有expr1和expr2的日期部分参与计算。当输入参数不合法时，该函数返回NULL。
返回值类型：integer（代表日期差值，单位是天)
示例：
MogDB=# select datediff('2001-01-01','321-02-02'); datediff ---------- 613576 (1 row) -
from_days(N)
描述：返回数值N代表的天数对应日期。
返回值类型：date
示例：
MogDB=# select from_days(365); from_days ------------ 0000-00-00 (1 row) MogDB=# select from_days(366); from_days ------------ 0001-01-01 (1 row) -
timestampdiff(unit,datetime expr1,datetime expr2)
描述：函数返回两个日期参数expr2 - expr1的值，这两个参数都有可能是datetime或者是date，如果参数是date，则认为时间部分为0。计算差值之后，将计算结果转换成指定单位显示。unit有以下值：MICROSECOND , SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, QUARTER, 或者是 YEAR。当输入参数不合法时，此函数返回NULL。
返回值类型：bigint（代表以指定单位显示的差值）
备注：在B模式数据库中，此函数在GUC参数b_compatibility_mode为true时代替MogDB原有timestampdiff函数。
示例：
MogDB=# set b_compatibility_mode = true; SET MogDB=# select timestampdiff(SECOND,'2001-01-01 12:12:12','2001-01-01 12:12:11'); timestampdiff --------------- -1 (1 row) MogDB=# select timestampdiff(MONTH,'2001-01-01 12:12:12','2001-02-01 12:12:12'); timestampdiff --------------- 1 (1 row) -
convert_tz(datetime, from_tz, to_tz)
描述：将datetime从from_tz指定的时区转换到to_tz指定的时区。如果datetime从from_tz转换到UTC时区时范围超过[1970-01-01 00:00:01.000000, 2038-01-19 03:14:07.999999],则不进行转换。参数无效时，函数返回NULL。
返回值：datetime
示例：
MogDB=# SELECT CONVERT_TZ('2004-01-01 12:00:00','GMT','MET'); convert_tz --------------------- 2004-01-01 13:00:00 (1 row) -
DATE_ADD(date/datetime/time, interval expr unit)
函数原型：
text DATE_ADD(text expr1, INTERVAL expr2 unit) time DATE_ADD(time expr1, INTERVAL expr2 unit)描述：该函数执行日期时间加法运算，返回exrp1加expr2的结果。expr1可以为date/datetime/time类型的数据，expr2代表interval值。expr1为time类型的数据时，只能在显示声明参数类型为time时才能实现对time的加法。
返回值类型：与第一参数类型保持一致。
备注：
- 一般情况下，返回类型与第一参数的类型相同。当第一参数的类型为DATE时且INTERVAL的单位包含HOUR、MINUTE、SECOND部分，则返回结果为DATETIME。
- 参数限制：MySQL插表时参数限制。
- expr1为date/datetime格式时，若超出[0000-1-1 00:00:00.000000, 9999-12-31 23:59:59.999999]，则报错。
- expr1为time类型的数据时，只能在显示声明参数类型为time时才能实现对time的加法。如date_add(‘1:1:1’,interval 1 second)并不会进入此函数，需改为date_add(time’1:1:1’, interval 1 second)。
- 结果限制：MySQL插表时结果限制。
- expr1为date/datetime格式时，若结果超出[0000-1-1 00:00:00.000000, 9999-12-31 23:59:59.999999]，则报错；若结果在此范围内，但小于’0001-1-1 00:00:00.000000’，MySQL中将结果定为’0000-00-00’或者’0000-00-00 xx:xx:xx’，其中时间部分结果视具体计算结果而定。鉴于这样的结果没有意义，故在MogDB中报错。
- 对第一参数为time类型的数据，如果计算结果超出time类型范围[-838:59:59, 838:59:59]，报错。
示例：
MogDB=# SELECT DATE_ADD('2022-01-01', INTERVAL 31 DAY); date_add ------------ 2022-02-01 (1 row) MogDB=# SELECT DATE_ADD('2022-01-01 01:01:01', INTERVAL 1 YEAR); date_add --------------------- 2023-01-01 01:01:01 (1 row) MogDB=# SELECT DATE_ADD('2022-01-01', INTERVAL 1 SECOND); date_add --------------------- 2022-01-01 00:00:01 (1 row) -
DATE_SUB(date/datetime/time, interval expr unit)
函数原型：
text DATE_SUB(text expr1, INTERVAL expr2 unit) time DATE_SUB(time expr1, INTERVAL expr2 unit)描述：该函数执行日期时间减法运算，返回exrp1减expr2的结果。expr1可以为date/datetime/time类型的数据，expr2代表interval值。expr1为time类型的数据时，只能在显示声明参数类型为time时才能实现对time的减法。
返回值类型：与第一参数类型保持一致。
备注：
- 一般情况下，返回类型与第一参数的类型相同。当第一参数的类型为DATE时且INTERVAL的单位包含HOUR、MINUTE、SECOND部分，则返回结果为DATETIME。
- 参数限制：MySQL插表时参数限制。
- expr1为date/datetime格式时，若超出[0000-1-1 00:00:00.000000, 9999-12-31 23:59:59.999999]，则报错。
- expr1为time类型的数据时，只能在显示声明参数类型为time时才能实现对time的减法。如date_sub(‘1:1:1’,interval 1 second)并不会进入此函数，需改为date_sub(time’1:1:1’, interval 1 second)。
- 结果限制：MySQL插表时结果限制。
- expr1为date/datetime格式时，若结果超出[0000-1-1 00:00:00.000000, 9999-12-31 23:59:59.999999]，则报错；若结果在此范围内，但小于’0001-1-1 00:00:00.000000’，MySQL中将结果定为’0000-00-00’或者’0000-00-00 xx:xx:xx’，其中时间部分结果视具体计算结果而定。鉴于这样的结果没有意义，故在MogDB中报错。
- 对第一参数为time类型的数据，如果计算结果超出time类型范围[-838:59:59, 838:59:59]，报错。
示例：
MogDB=# SELECT DATE_SUB('2022-01-01', INTERVAL 31 DAY); date_sub ------------ 2021-12-01 (1 row) MogDB=# SELECT DATE_SUB('2022-01-01 01:01:01', INTERVAL 1 YEAR); date_sub --------------------- 2021-01-01 01:01:01 (1 row) MogDB=# SELECT DATE_SUB('2022-01-01', INTERVAL 1 SECOND); date_sub --------------------- 2021-12-31 23:59:59 (1 row) -
ADDDATE(date/datetime/time, interval/days)
描述：该函数执行日期或时间加法运算。当第二参数为interval时，该函数表现与DATE_ADD函数相同，详细描述参见DATE_ADD。当第二参数为整数时，此整数会被当作天数加在第一参数上。
示例：
MogDB=# SELECT ADDDATE('2021-11-12', INTERVAL 1 SECOND); adddate --------------------- 2021-11-12 00:00:01 (1 row) MogDB=# SELECT ADDDATE(time'12:12:12', INTERVAL 1 DAY); adddate ---------- 36:12:12 (1 row) MogDB=# SELECT ADDDATE('2021-11-12', 1); adddate ------------ 2021-11-13 (1 row) MogDB=# SELECT ADDDATE(time'12:12:12', 1); adddate ---------- 36:12:12 (1 row) -
ADDTIME(datetime/time,time)
函数原型：
time ADDTIME(text expr1, time expr2)描述：该函数执行时间加法运算，返回expr1加上expr2的结果。expr1可以为datetime或者time格式，expr2只能为time格式。
返回值类型：与第一参数类型保持一致。
备注：
- 参数限制：MySQL插表时参数限制。
- 第一参数为datetime格式时，若超出[0000-1-1 00:00:00.000000 , 9999-12-31 23:59:59.999999]，则报错。
- 第一参数为time格式时，若超过time类型范围，则报错。
- 第二参数只能为time格式。
- 结果限制：MySQL插表时结果限制。
- 结果为datetime格式时，若超出[0000-1-1 00:00:00.000000, 9999-12-31 23:59:59.999999]，则报错；若结果在此范围内，但小于’0001-1-1 00:00:00.000000’，则函数返回NULL。
- 结果为time格式时，若超出[-838:59:59, 838:59:59]则报错。
示例：
MogDB=# SELECT ADDTIME('11:22:33','10:20:30'); addtime ---------- 21:43:03 (1 row) MogDB=# SELECT ADDTIME('2020-03-04 11:22:33', '-10:20:30'); addtime --------------------- 2020-03-04 01:02:03 (1 row) - 参数限制：MySQL插表时参数限制。
MogDB 是云和恩墨基于opengauss 企业级数据库
