华为云用户手册

week(date[, mode]) 描述：根据模式返回指定日期时间所处年份中对应的周数，默认模式为0。 返回值类型：integer 表1 week函数中mode模式的工作原理 模式 一周的第一天 周数范围 第一周的判断规则 0 星期日 0-53 元旦后的第一个星期日所在周 1 星期一 0-53 元旦后有四天或者更多天所在周 2 星期日 1-53 元旦后的第一个星期日所在周 3 星期一 1-53 元旦后有四天或者更多天所在周 4 星期日 0-53 元旦后有四天或者更多天所在周 5 星期一 0-53 元旦后的第一个星期一所在周 6 星期日 1-53 元旦后有四天或者更多天所在周 7 星期一 1-53 元旦后的第一个星期一所在周 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 SELECT week('2018-01-01'); week ------ 0 (1 row) SELECT week('2018-01-01', 0); week ------ 0 (1 row) SELECT week('2020-12-31', 1); week ------ 53 (1 row) SELECT week('2020-12-31', 5); week ------ 52 (1 row)

yearweek(date[, mode]) 描述：返回给定日期date在本年中对应的年份和周数，周数范围为[1, 53]。 返回值类型：integer 示例： 1 2 3 4 5 6 7 8 9 10 11 SELECT yearweek('2019-12-31'); yearweek ---------- 201952 (1 row) SELECT yearweek('2019-1-1'); yearweek ---------- 201852 (1 row)

str_to_date(str, format) 描述：将日期/时间格式的字符串（str），按照所提供的显示格式（format）转换为日期类型的值。 返回值类型：timestamp 示例： 1 2 3 4 5 6 7 8 9 10 SELECT str_to_date('01,5,2021','%d,%m,%Y'); str_to_date --------------------- 2021-05-01 00:00:00 (1 row) SELECT str_to_date('01,5,2021,09,30,17','%d,%m,%Y,%h,%i,%s'); str_to_date --------------------- 2021-05-01 09:30:17 (1 row) 适用于str_to_date的格式化输入的格式类型参考表1。这里仅支持“日期”格式、“日期+时间”格式的输入转换，对于仅“时间”格式的输入场景请使用str_to_time。

str_to_time(str, format) 描述：将时间格式的字符串（str），按照所提供的显示格式（format）转换为时间类型的值。 返回值类型：time 示例： 1 2 3 4 5 SELECT str_to_time('09:30:17','%h:%i:%s'); str_to_time ------------- 09:30:17 (1 row) 适用于str_to_time的格式化输入的格式类型参考表1，这里仅支持“时间”格式的输入转换，对于“日期”格式、“日期+时间”格式的输入场景请使用str_to_date。

time_format(time, fmt) 描述：time_format函数将日期参数按照fmt指定的格式转换为字符串。与date_format函数类似，但格式字符串只能包含小时、分钟、秒和微秒的格式说明符，如果包含其他说明符则会返回NULL值或0。 返回值类型：text 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 SELECT time_format('2009-10-04 22:23:00', '%M %D %W'); time_format -------------------- (1 row) SELECT time_format('2021-02-20 08:30:45', '%Y-%m-%d %H:%i:%S'); time_format --------------------- 0000-00-00 08:30:45 (1 row) SELECT time_format('2021-02-20 18:10:15', '%r-%T'); time_format ---------------------- 06:10:15 PM-18:10:15 (1 row) time_format仅支持时间相关的格式输出（%f、%H、%h、%I、%i、%k、%l、%p、%r、%S、%s、%T），不支持日期相关格式，其他情况处理为普通字符。

date_format(timestamp, fmt) date_format函数将日期参数按照fmt指定的格式转换为字符串。 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 SELECT date_format('2009-10-04 22:23:00', '%M %D %W'); date_format -------------------- October 4th Sunday (1 row) SELECT date_format('2021-02-20 08:30:45', '%Y-%m-%d %H:%i:%S'); date_format --------------------- 2021-02-20 08:30:45 (1 row) SELECT date_format('2021-02-20 18:10:15', '%r-%T'); date_format ---------------------- 06:10:15 PM-18:10:15 (1 row) 表 date_format支持的输出格式显示了可以用于将日期参数格式化输出的格式类型，这些格式类型适用于函数date_format、time_format、str_to_date、str_to_time和from_unixtime。 表1 date_format支持的输出格式 格式 说明 取值 %a 缩写星期名 Sun...Sat %b 缩写月份名 Jan...Dec %c 月份 0...12 %D 带英文后缀的月份日期 0th, 1st, 2nd, 3rd, … %d 一个月里的日，2位 00...31 %e 一个月里的日 0...31 %f 微秒 000000...999999 %H 小时，24小时制 00...23 %h 小时，12小时制 01...12 %I 小时，12小时制，同%h 01...12 %i 分钟 00...59 %j 一年里的日 001...366 %k 小时，24小时制，同%H 0...23 %l 小时，12小时制，同%h 1...12 %M 月份名 January...December %m 月份，两位 00...12 %p 上下午 AM PM %r 时间，12小时制 hh::mm::ss AM/PM %S 秒 00...59 %s 秒，同%S 00...59 %T 时间，24小时制 hh::mm::ss %U 周 (00-53) 星期日是一周的第一天 00...53 %u 周 (00-53) 星期一是一周的第一天 00...53 %V 周 (01-53) 星期日是一周的第一天，与%X搭配使用 01...53 %v 周 (01-53) 星期一是一周的第一天，与%x搭配使用 01...53 %W 星期名 Sunday...Saturday %w 一周的日，周日为0 0...6 %X 年份，其中的星期日是周的第一天，4 位，与%V搭配使用 - %x 年份，其中的星期一是周的第一天，4 位，与%v搭配使用 - %Y 年份，4位 - %y 年份，2位 - %% 字符'%' 字符'%' %x 'x'，上述未列出的任意字符 字符'x' date_format支持的输出格式中，%U、%u、%V、%v、%X、%x暂不支持。

date_part date_part函数是在传统的Ingres函数的基础上制作的（该函数等效于SQL标准函数extract）： 1 date_part('field', source) 这里的field参数必须是一个字符串，而不是一个名字。有效的field与extract一样，详细信息请参见EXTRACT。 示例： 1 2 3 4 5 SELECT date_part('day', TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 16 (1 row) 1 2 3 4 5 SELECT date_part('hour', interval '4 hours 3 minutes'); date_part ----------- 4 (1 row) 父主题： 时间、日期处理函数和操作符

day 如果source为timestamp，表示月份里的日期（1-31）。 1 2 3 4 5 SELECT EXTRACT(day FROM TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 16 (1 row) 如果source为interval，表示天数。 1 2 3 4 5 SELECT EXTRACT(day FROM INTERVAL '40 days 1 minute'); date_part ----------- 40 (1 row)

isoyear 日期中的ISO 8601标准年（不适用于间隔）。 每个带有星期一开始的周中包含1月4日的ISO年，所以在年初的1月或12月下旬的ISO年可能会不同于阳历的年。详细信息请参见后续的week描述。 1 2 3 4 5 SELECT EXTRACT(isoyear FROM DATE '2006-01-01'); date_part ----------- 2005 (1 row) 1 2 3 4 5 SELECT EXTRACT(isoyear FROM DATE '2006-01-02'); date_part ----------- 2006 (1 row)

century 世纪。 第一个世纪从0001-01-01 00:00:00 AD开始。这个定义适用于所有使用阳历的国家。没有0世纪，直接从公元前1世纪到公元1世纪。 示例： 1 2 3 4 5 SELECT EXTRACT(century FROM TIMESTAMP '2000-12-16 12:21:13'); date_part ----------- 20 (1 row)

epoch 如果source为timestamp with time zone，表示自1970-01-01 00:00:00-00 UTC以来的秒数（结果可能是负数）； 如果source为date和timestamp，表示自1970-01-01 00:00:00-00当地时间以来的秒数； 如果source为interval，表示时间间隔的总秒数。 1 2 3 4 5 SELECT EXTRACT(epoch FROM TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40.12-08'); date_part -------------- 982384720.12 (1 row) 1 2 3 4 5 SELECT EXTRACT(epoch FROM interval '5 days 3 hours'); date_part ----------- 442800 (1 row) 将epoch值转换为时间戳的方法。 1 2 3 4 5 SELECT TIMESTAMP WITH TIME ZONE 'epoch' + 982384720.12 * interval '1 second' AS RESULT; result --------------------------- 2001-02-17 12:38:40.12+08 (1 row)

month 如果source为timestamp，表示一年里的月份数（1-12）。 1 2 3 4 5 SELECT EXTRACT(month FROM TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 2 (1 row) 如果source为interval，表示月的数目，然后对12取模（0-11）。 1 2 3 4 5 SELECT EXTRACT(month FROM interval '2 years 13 months'); date_part ----------- 1 (1 row)

week 该天在所在的年份里是第几周。ISO 8601定义一年的第一周包含该年的一月四日（ISO-8601 的周从星期一开始）。换句话说，一年的第一个星期四在第一周。 在ISO定义里，一月的头几天可能是前一年的第52或者第53周，十二月的后几天可能是下一年第一周。比如，2005-01-01是2004年的第53周，而2006-01-01是2005年的第52周，2012-12-31是2013年的第一周。建议isoyear字段和week一起使用以得到一致的结果。 1 2 3 4 5 SELECT EXTRACT(week FROM TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 7 (1 row)

transaction_timestamp() 描述：当前日期及时间，与current_timestamp等效。 返回值类型：timestamp with time zone 示例： 1 2 3 4 5 SELECT transaction_timestamp(); transaction_timestamp ------------------------------- 2017-09-01 17:05:13.534454+08 (1 row)

unix_timestamp([timestamp with time zone]) 描述：获取从'1970-01-01 00:00:00'UTC到入参时间经历的秒数。无入参时，指定为当前时间。 返回值类型：bigint（无入参）/numeric（有入参） 示例： 1 2 3 4 5 SELECT unix_timestamp(); unix_timestamp ---------------- 1693906219 (1 row) 1 2 3 4 5 SELECT unix_timestamp('2018-09-08 12:11:13+06'); unix_timestamp ---------------- 1536387073.000000 (1 row)

last_day(d) 描述：用于计算时间点d本月最后一天的时间。 ORA和TD兼容模式下，返回值类型为timestamp。 MySQL兼容模式下，返回值类型为date。 示例： 1 2 3 4 5 SELECT last_day(to_date('2017-01-01', 'YYYY-MM-DD')) AS cal_result; cal_result --------------------- 2017-01-31 00:00:00 (1 row)

next_day(x,y) 描述：用于计算x时间开始的下一个星期y的时间。 ORA和TD兼容模式下，返回值类型为timestamp。 MySQL兼容模式下，返回值类型为date。 示例： 1 2 3 4 5 SELECT next_day(TIMESTAMP '2017-05-25 00:00:00','Sunday')AS cal_result; cal_result --------------------- 2017-05-28 00:00:00 (1 row)

from_unixtime(unix_timestamp[,format]) 描述：格式串缺省时，将unix时间戳转换为日期时间类型输出。格式串指定时，将unix时间戳转换为指定格式的字符串输出。 返回值类型：timestamp（格式串缺省）/ text（格式串指定） 示例： 1 2 3 4 5 6 7 8 9 10 SELECT from_unixtime(875996580); from_unixtime --------------------- 1997-10-04 20:23:00 (1 row) SELECT from_unixtime(875996580, '%Y %D %M %h:%i:%s'); from_unixtime --------------------------- 1997 4th October 08:23:00 (1 row)

extract(field from interval) 描述：获取field指定精度的值。如果大于12，则取与12的模。field的有效值参见EXTRACT。 返回值类型：double precision 示例： 1 2 3 4 5 SELECT extract(month FROM interval '2 years 3 months'); date_part ----------- 3 (1 row)

isfinite(date) 描述：测试是否为有限日期。 返回值类型：boolean 示例： 1 2 3 4 5 6 7 8 9 10 SELECT isfinite(date '2001-02-16'); isfinite ---------- t (1 row) SELECT isfinite(date 'infinity'); isfinite ---------- f (1 row)

numtodsinterval(num, interval_unit) 描述：将数字转换为interval类型。num为numeric类型数字，interval_unit为固定格式字符串（'DAY' | 'HOUR' | 'MINUTE' | 'SECOND'）。 可以通过设置参数IntervalStyle为oracle，兼容该函数在Oracle中的interval输出格式。 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 SELECT numtodsinterval(100, 'HOUR'); numtodsinterval ----------------- 100:00:00 (1 row) SET intervalstyle = oracle; SET SELECT numtodsinterval(100, 'HOUR'); numtodsinterval ------------------------------- +000000004 04:00:00.000000000 (1 row)

now([fsp]) 描述：当前事务开始的日期及时间，参数确定微秒输出精度，缺省时为6。 返回值类型：timestamp with time zone 示例： 1 2 3 4 5 SELECT now(); now ------------------------------- 2017-09-01 17:03:42.549426+08 (1 row) 1 2 3 4 5 SELECT now(3); now ---------------------------- 2021-09-08 10:59:00.427+08 (1 row)

statement_timestamp() 描述：当前日期及时间。 返回值类型：timestamp with time zone 示例： 1 2 3 4 5 SELECT statement_timestamp(); statement_timestamp ------------------------------- 2017-09-01 17:04:39.119267+08 (1 row)

timeofday() 描述：当前日期及时间（像clock_timestamp，但是返回时为text。） 返回值类型：text 示例： 1 2 3 4 5 SELECT timeofday(); timeofday ------------------------------------- Fri Sep 01 17:05:01.167506 2017 CS T (1 row)

isfinite(timestamp) 描述：测试判断是否为有限时间。 返回值类型：boolean 示例： 1 2 3 4 5 6 7 8 9 10 SELECT isfinite(timestamp '2001-02-16 21:28:30'); isfinite ---------- t (1 row) SELECT isfinite(timestamp 'infinity'); isfinite ---------- f (1 row)

justify_interval(interval) 描述：结合justify_days和justify_hours，调整interval。 返回值类型：interval 示例： 1 2 3 4 5 SELECT justify_interval(interval '1 MON -1 HOUR'); justify_interval ------------------ 29 days 23:00:00 (1 row)

maketime(hour, minute, second) 描述：根据所给的小时，分钟和秒数返回time类型的值。由于 GaussDB (DWS)中的time类型的取值范围为00:00:00到24:00:00，故不支持hour大于24时和hour小于0时的场景。 返回值类型：time 示例： 1 2 3 4 5 SELECT maketime(12, 15, 30.12); maketime ------------- 12:15:30.12 (1 row)

timestampdiff(field, timestamp1, timestamp2) 描述：将两个日期参数相减(timestamp2 - timestamp1)，并以单位field作为返回值。若相减值为负，则函数返回值为负。field支持的参数为year、month、quarter、day、week、hour、minute、second和microsecond。 返回值类型：bigint 示例： 1 2 3 4 5 SELECT timestampdiff(day, TIMESTAMP '2001-02-01', TIMESTAMP '2003-05-01 12:05:55'); timestampdiff --------------- 819 (1 row)

date_part(text, interval) 描述：获取参数text指定的精度。如果大于12，则取与12的模。 等效于extract(field from timestamp)。 返回值类型：double precision 示例： 1 2 3 4 5 SELECT date_part('month', interval '2 years 3 months'); date_part ----------- 3 (1 row)

date_part(text, timestamp) 描述：获取参数text指定的精度。 等效于extract(field from timestamp)。 返回值类型：double precision 示例： 1 2 3 4 5 SELECT date_part('hour', TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 20 (1 row)