# 时间和日期函数概述 DWS的时间和日期函数用于在数据业务中加减日期，获取当前时间、格式化日期显示、提取年月日等操作，广泛应用于数据分析、日程管理、财务报表等领域，帮助用户提高数据处理效率和准确性。 表1时间和日期函数列表 | 类型 | 函数 | 功能 | |:---|:---|:---| | 时间和日期基本函数 | [day(date \| timestamp with time zone)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section5432141514561) | 获取给定日期时间中的日。 | | 时间和日期基本函数 | [weekday(date \| timestamp with time zone)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section14348956185810) | 获取给定日期时间对应的星期值，星期一作为一周的开始日。 | | 时间和日期基本函数 | [week(date\[, mode\])](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section32002275915) | 根据模式返回指定日期时间所处年份中对应的周数。 | | 时间和日期基本函数 | [month(date \| timestamp with time zone)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section198971510124012) | 获取给定日期时间的月份部分。 | | 时间和日期基本函数 | [quarter(date \| timestamp with time zone)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section93761962559) | 获取给定日期时间所属的季度。 | | 时间和日期基本函数 | [year(date \| timestamp with time zone)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section1071211507583) | 获取给定日期时间所处的年份。 | | 时间和日期基本函数 | [yearweek(date \| timestamp with time zone\[, mode\])](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section1719311261177) | 获取给定日期时间在本年中对应的年份和周数 | | 时间和日期基本函数 | [dayofweek(date \| timestamp with time zone)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section74827810567) | 获取给定日期时间对应的星期值，星期日作为一周的开始日。 | | 时间和日期基本函数 | [dayofmonth(date \| timestamp with time zone)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section12631211105616) | 获取给定日期时间所处月份中的天数。 | | 时间和日期基本函数 | [dayofyear(date \| timestamp with time zone)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section3547358566) | 获取给定日期在本年中是第几天。 | | 时间和日期基本函数 | [weekofyear(date \| timestamp with time zone)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section17442053155815) | 获取给定日期时间在本年中是第几周，等价于week(date, 3)。 | | 时间和日期基本函数 | [makedate(year, dayofyear)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section12161037205516) | 根据给定的年份和一年中的第几天生成对应的日期值。 | | 时间和日期基本函数 | [maketime(hour, minute, second)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section11544113475511) | 根据给定的小时、分钟和秒数生成时间值。 | | 时间和日期基本函数 | [hour(timestamp with time zone)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section199936371484) | 获取时间中的小时值。 | | 时间和日期基本函数 | [minute(timestamp with time zone)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section1468172718553) | 获取时间中的分钟值。 | | 时间和日期基本函数 | [second(timestamp with time zone)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section45322015483) | 获取时间的秒数值。 | | 时间和日期基本函数 | [microsecond(timestamp with time zone)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section2416103012559) | 获取时间中的微秒值。 | | 时间和日期基本函数 | [from_unixtime(unix_timestamp\[,format\])](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section1155016482545) | 格式串缺省时，将unix时间戳转换为日期时间类型输出。 | | 时间和日期基本函数 | [unix_timestamp(\[timestamp with time zone\])](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section373415443542) | 用于将日期时间值转换为 Unix时间戳（即自1970-01-01 00:00:00 UTC以来经过的秒数）。 | | 时间和日期基本函数 | [now(\[fsp\])](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section196965211550) | 当前事务开始的日期及时间。 | | 时间和日期基本函数 | [last_day(d)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section158077372545) | 获取日期或者日期时间中对应月份的最后一天。 | | 时间和日期基本函数 | [next_day(x,y)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section9551335205418) | 计算给定时间（x）之后第一个匹配目标星期几（y）的日期。 | | 时间和日期基本函数 | [from_days(days)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section18837331135418) | 根据给定的天数，返回对应的日期值。 | | 时间和日期基本函数 | [to_days(timestamp)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0311.html#ZH-CN_TOPIC_0000002541821149__section940512825411) | 根据指定日期，返回自0年开始的天数。 | | 时间和日期运算函数 | [age(timestamp, timestamp)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0312.html#ZH-CN_TOPIC_0000002510221158__section5554191145815) | 将两个参数相减，并以年、月、日作为返回值。 | | 时间和日期运算函数 | [age(timestamp)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0312.html#ZH-CN_TOPIC_0000002510221158__section1646778185817) | 将两个参数相减，并以年、月、日作为返回值。 | | 时间和日期运算函数 | [adddate(date, interval \| int)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0312.html#ZH-CN_TOPIC_0000002510221158__section5485357588) | 返回给定日期时间加上指定单位的时间间隔的结果。 | | 时间和日期运算函数 | [subdate(date, interval \| int)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0312.html#ZH-CN_TOPIC_0000002510221158__section2345185695713) | 返回给定日期时间减去指定单位的时间间隔的结果。 | | 时间和日期运算函数 | [addtime(timestamp \| time \| text, interval \| text)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0312.html#ZH-CN_TOPIC_0000002510221158__section1599418589575) | 返回给定日期/时间加上指定时间间隔的结果。 | | 时间和日期运算函数 | [subtime(timestamp \| time \| text, interval \| text)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0312.html#ZH-CN_TOPIC_0000002510221158__section6187184914578) | 返回给定日期/时间减去指定时间间隔的结果。 | | 时间和日期运算函数 | [date_add(date, interval)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0312.html#ZH-CN_TOPIC_0000002510221158__section1556074615572) | 返回给定日期时间加上指定单位的时间间隔的结果。 | | 时间和日期运算函数 | [date_sub(date, interval)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0312.html#ZH-CN_TOPIC_0000002510221158__section11590154335710) | 返回给定日期时间减去指定单位的时间间隔的结果。 | | 时间和日期运算函数 | [timestampadd(field, numeric, timestamp)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0312.html#ZH-CN_TOPIC_0000002510221158__section124754095716) | 将以单位field的整数时间间隔（秒数可以带小数）添加到日期时间表达式中。 | | 时间和日期运算函数 | [timestampdiff(field, timestamp1, timestamp2)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0312.html#ZH-CN_TOPIC_0000002510221158__section180353655719) | 将两个日期参数相减(timestamp2 - timestamp1)，并以单位field作为返回值。 | | 时间和日期运算函数 | [timediff(timestamp \| time \| text, timestamp \| time \| text)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0312.html#ZH-CN_TOPIC_0000002510221158__section169068337572) | 将两个日期参数相减。 | | 时间和日期运算函数 | [datediff(date1, date2)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0312.html#ZH-CN_TOPIC_0000002510221158__section1424572145716) | 返回给定日期之间相差的天数值。 | | 时间和日期运算函数 | [period_add(P, N)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0312.html#ZH-CN_TOPIC_0000002510221158__section14401912125515) | 返回给定时期加上N个月后的日期。 | | 时间和日期运算函数 | [period_diff(P1, P2)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0312.html#ZH-CN_TOPIC_0000002510221158__section9345199557) | 返回给定日期之间的月数差值。 | | 时间和日期运算函数 | [add_months(d,n)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0312.html#ZH-CN_TOPIC_0000002510221158__section10654241125415) | 用于计算时间点d再加上n个月的时间。 | | 时间和日期截取函数 | [date_part(text, timestamp \| interval)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0313.html#ZH-CN_TOPIC_0000002541901151__section16931241799) | 从一个日期时间表达式中提取指定的部分。 | | 时间和日期截取函数 | [date_trunc(text, timestamp with time zone \| timestamp without time zone \| interval)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0313.html#ZH-CN_TOPIC_0000002541901151__section102671275565) | 将时间日期数据截断到指定的精度。 | | 时间和日期截取函数 | [trunc(timestamp)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0313.html#ZH-CN_TOPIC_0000002541901151__section8731162365616) | 默认按天截取。 | | 时间和日期截取函数 | [extract(field from timestamp \| time \| interval)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0313.html#ZH-CN_TOPIC_0000002541901151__section181911910131614) | 从日期时间的表达式中提取指定的时间部分。 | | 获取当前时间和日期函数 | [clock_timestamp()](https://support.huaweicloud.com/sqlreference-dws/dws_06_0421.html#ZH-CN_TOPIC_0000002510381166__section16306173145714) | 实时时钟的当前时间戳。 | | 获取当前时间和日期函数 | [current_date](https://support.huaweicloud.com/sqlreference-dws/dws_06_0421.html#ZH-CN_TOPIC_0000002510381166__section346892875718) | 返回当前日期。 | | 获取当前时间和日期函数 | [curdate()](https://support.huaweicloud.com/sqlreference-dws/dws_06_0421.html#ZH-CN_TOPIC_0000002510381166__section7383172465718) | 返回当前日期。此函数为MySQL兼容性函数。 | | 获取当前时间和日期函数 | [current_time](https://support.huaweicloud.com/sqlreference-dws/dws_06_0421.html#ZH-CN_TOPIC_0000002510381166__section83901821145715) | 返回当前时间。 | | 获取当前时间和日期函数 | [curtime(\[fsp\])](https://support.huaweicloud.com/sqlreference-dws/dws_06_0421.html#ZH-CN_TOPIC_0000002510381166__section25941215155714) | 返回当前时间。 | | 获取当前时间和日期函数 | [current_timestamp](https://support.huaweicloud.com/sqlreference-dws/dws_06_0421.html#ZH-CN_TOPIC_0000002510381166__section1595531112571) | 返回当前日期和时间（当前事务的开始时间）。 | | 获取当前时间和日期函数 | [localtime](https://support.huaweicloud.com/sqlreference-dws/dws_06_0421.html#ZH-CN_TOPIC_0000002510381166__section19891164265518) | 返回当前时间。 | | 获取当前时间和日期函数 | [localtimestamp](https://support.huaweicloud.com/sqlreference-dws/dws_06_0421.html#ZH-CN_TOPIC_0000002510381166__section32161140195516) | 返回当前日期及时间。 | | 获取当前时间和日期函数 | [statement_timestamp()](https://support.huaweicloud.com/sqlreference-dws/dws_06_0421.html#ZH-CN_TOPIC_0000002510381166__section9466504557) | 返回当前日期及时间（当前语句的开始时间） | | 获取当前时间和日期函数 | [sysdate](https://support.huaweicloud.com/sqlreference-dws/dws_06_0421.html#ZH-CN_TOPIC_0000002510381166__section5689157185410) | 返回当前系统的日期及时间。 | | 获取当前时间和日期函数 | [timeofday()](https://support.huaweicloud.com/sqlreference-dws/dws_06_0421.html#ZH-CN_TOPIC_0000002510381166__section137791454205413) | 返回当前日期及时间。 | | 获取当前时间和日期函数 | [transaction_timestamp()](https://support.huaweicloud.com/sqlreference-dws/dws_06_0421.html#ZH-CN_TOPIC_0000002510381166__section541355185411) | 返回当前事务开始的系统日期及时间。 | | 时间和日期格式化函数 | [date_format(timestamp, fmt)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0422.html#ZH-CN_TOPIC_0000001764675318__section65590906) | 将日期参数按照fmt指定的格式转换为字符串。 | | 时间和日期格式化函数 | [time_format(time, fmt)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0422.html#ZH-CN_TOPIC_0000001764675318__section1467010148597) | 将日期参数按照fmt指定的格式转换为字符串。 | | 时间和日期格式化函数 | [str_to_date(str, format)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0422.html#ZH-CN_TOPIC_0000001764675318__section1560041035911) | 将日期时间格式的字符串，按照所提供的显示格式转换为日期类型的值。 | | 时间和日期格式化函数 | [str_to_time(str, format)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0422.html#ZH-CN_TOPIC_0000001764675318__section3143771599) | 将时间格式的字符串，按照所提供的显示格式转换为时间类型的值。 | | 其他时间和日期处理函数 | [justify_days(interval)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0423.html#ZH-CN_TOPIC_0000002510221160__section9353185020554) | 将时间间隔以30天为单位。 | | 其他时间和日期处理函数 | [justify_hours(interval)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0423.html#ZH-CN_TOPIC_0000002510221160__section9897647125518) | 将时间间隔以24小时为单位。 | | 其他时间和日期处理函数 | [justify_interval(interval)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0423.html#ZH-CN_TOPIC_0000002510221160__section123652457550) | 结合justify_days和justify_hours，调整时间间隔。 | | 其他时间和日期处理函数 | [numtodsinterval(num, text)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0423.html#ZH-CN_TOPIC_0000002510221160__section63941218165516) | 将数字加时间间隔单位转换为INTERVAL DAY TO SECOND类型的值。 | | 其他时间和日期处理函数 | [convert_tz(timestamp, from_tz, to_tz)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0423.html#ZH-CN_TOPIC_0000002510221160__section199981454573) | 将时间日期值timestamp从*from_tz* (text)给出的时区转到*to_tz*(text)给出的时区，返回转换后的时区时间。 | | 其他时间和日期处理函数 | [isfinite(date)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0423.html#ZH-CN_TOPIC_0000002510221160__section19578115919559) | 测试是否为有限日期。 | | 其他时间和日期处理函数 | [isfinite(timestamp)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0423.html#ZH-CN_TOPIC_0000002510221160__section5857195655513) | 测试判断是否为有限时间。 | | 其他时间和日期处理函数 | [isfinite(interval)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0423.html#ZH-CN_TOPIC_0000002510221160__section13251105395512) | 测试是否为有限区间。 | | 其他时间和日期处理函数 | [pg_sleep(seconds)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0423.html#ZH-CN_TOPIC_0000002510221160__section596101465516) | 服务器线程延迟时间。 |