DATE_TRUNC

将日期和时间值截断为指定的精度。返回值与输入值的数据类型相同。所有小于指定精度的字段均设置为 0，或设置为 1 表示日和月。

行为类型

语法

DATE_TRUNC( precision, trunc‑target )

参数

precision: 一个字符串常量，指定截断值的精度。请参阅下文的精度字段值。精度必须对 trunc-target 日期或时间有效。
trunc‑target: 有效日期/时间表达式。

精度字段值

MILLENNIUM

千年序号。

CENTURY

世纪序号。

一世纪始于 0001-01-01 00:00:00 AD。此定义适用于所有采用公历的国家/地区。

DECADE

年份字段除以 10。

YEAR

年份字段。请记住，不存在 0 AD，因此将 AD 年份相应地从 BC 年份中减去。

QUARTER

指定日期的日历季度，为整数，其中一月至三月的季度为 1。

MONTH

对于 timestamp 值，为年份第几月 (1–12)；对于 interval 值，为月份数，模数 12 (0-11)。

WEEK

日期所处的年周序号。

按照 ISO-8601 标准，一周的开始时间是星期一，一年的第一周包含 1 月 4 日。因此，一月初的日期有时可能会位于上一个历年的第 52 周或第 53 周。例如：

=> SELECT YEAR_ISO('01-01-2016'::DATE), WEEK_ISO('01-01-2016'), DAYOFWEEK_ISO('01-01-2016');
 YEAR_ISO | WEEK_ISO | DAYOFWEEK_ISO
----------+----------+---------------
     2015 |       53 |             5
(1 row)

DAY

（月份）第几日字段 (1–31)。

HOUR

小时字段 (0–23)。

MINUTE

分钟字段 (0–59)。

SECOND

秒字段，包括小数部分 (0–59)（如果操作系统实施闰秒，则为 60）。

MILLISECONDS

秒数字段，包括小数部分，而且乘以了 1000。请注意，这包括完整的秒数。

MICROSECONDS

秒数字段，包括小数部分，而且乘以了 1,000,000。这包括完整的秒数。

示例

以下示例将字段值设置为小时并返回小时，截断分钟和秒：

=> SELECT DATE_TRUNC('HOUR', TIMESTAMP '2012-02-24 13:38:40') AS HOUR;
        HOUR
---------------------
 2012-02-24 13:00:00
(1 row)

以下示例从输入 timestamptz '2012-02-24 13:38:40' 返回年份。函数还将月份和日期默认为 1 月 1 日，截断时间戳的时：分：秒，并附加时区（-05）：

=> SELECT DATE_TRUNC('YEAR', TIMESTAMPTZ '2012-02-24 13:38:40') AS YEAR;
          YEAR
------------------------
 2012-01-01 00:00:00-05
(1 row)

以下示例返回年份和月份，将默认月份日期设置为 1，截断字符串的其余部分：

=> SELECT DATE_TRUNC('MONTH', TIMESTAMP '2012-02-24 13:38:40') AS MONTH;
        MONTH
---------------------
 2012-02-01 00:00:00
(1 row)