类别：: 日期和时间函数

TRUNCATE、TRUNC¶

将 DATE、TIME 或 TIMESTAMP 值截断为指定的精度。例如，将时间戳截断到季度时，将返回对应于原始时间戳季度第一天午夜的时间戳。

该函数通过反转两个实参，为 DATE_TRUNC 提供了另一种语法。

TRUNCATE 和 TRUNC 函数为同义函数。

截断与提取不同。例如：

使用此函数将时间戳截断为季度，会返回与输入时间戳所在季度第一天的午夜相对应的时间戳。
使用 EXTRACT 函数从时间戳中提取季度日期部分，会返回时间戳中年份的季度编号。

备注

TRUNC 过载。它也可以与数值配合使用，来减少有效数字位的数量，例如将小数值截断为整数。数字 TRUNC 有一个必要参数和一个可选参数。日期/时间 TRUNC 有两个必要参数。

选择：: DATE_TRUNC
另请参阅：: DATE_PART、EXTRACT

语法¶

TRUNC( <date_or_time_expr>, <date_or_time_part> )

实参¶

date_or_time_expr: 此实参的值必须是日期、时间或时间戳。
date_or_time_part: 此实参必须是支持的日期和时间部分中列出的值之一。

返回¶

返回值与输入值的类型相同。

例如，如果输入值为 TIMESTAMP，则返回值为 TIMESTAMP。

使用说明¶

当 date_or_time_part 为 week （或其任何变体）时，输出由 WEEK_START 会话参数控制。有关更多详细信息（包括示例），请参阅日历周和工作日。
对于 TIME 值，您不能指定超出 TIME 类型范围的 date_or_time_part。例如，您可以将 TIMESTAMP 值截断为 day、week、year 等，因为 TIMESTAMP 类型使用所需精度对日期/时间进行编码。然而，尝试将 TIME 值截断为 day、week、year 等都会导致出错。

示例¶

以下示例演示了针对日期/时间值的 TRUNC 或 TRUNCATE 函数。有关截断数值的示例，请参阅 TRUNC 的数字形式。

函数示例使用了下表中的数据：

CREATE OR REPLACE TABLE test_date_trunc (
 mydate DATE,
 mytime TIME,
 mytimestamp TIMESTAMP);

INSERT INTO test_date_trunc VALUES (
  '2024-05-09',
  '08:50:48',
  '2024-05-09 08:50:57.891 -0700');

SELECT * FROM test_date_trunc;

+------------+----------+-------------------------+
| MYDATE     | MYTIME   | MYTIMESTAMP             |
|------------+----------+-------------------------|
| 2024-05-09 | 08:50:48 | 2024-05-09 08:50:57.891 |
+------------+----------+-------------------------+

以下示例显示了日期截断。在所有情况下，返回值的数据类型与输入值相同，但被截断的部分（如小数秒）为零。

将 DATE 值截断为年、月、日：

SELECT mydate AS "DATE",
       TRUNC(mydate, 'year') AS "TRUNCATED TO YEAR",
       TRUNC(mydate, 'month') AS "TRUNCATED TO MONTH",
       TRUNC(mydate, 'day') AS "TRUNCATED TO DAY"
  FROM test_date_trunc;

+------------+-------------------+--------------------+------------------+
| DATE       | TRUNCATED TO YEAR | TRUNCATED TO MONTH | TRUNCATED TO DAY |
|------------+-------------------+--------------------+------------------|
| 2024-05-09 | 2024-01-01        | 2024-05-01         | 2024-05-09       |
+------------+-------------------+--------------------+------------------+

将 TIME 值截断为分钟：

SELECT mytime AS "TIME",
       TRUNCATE(mytime, 'minute') AS "TRUNCATED TO MINUTE"
  FROM test_date_trunc;

+----------+---------------------+
| TIME     | TRUNCATED TO MINUTE |
|----------+---------------------|
| 08:50:48 | 08:50:00            |
+----------+---------------------+

将 TIMESTAMP 值截断为小时、分钟和秒。

SELECT mytimestamp AS "TIMESTAMP",
       TRUNCATE(mytimestamp, 'hour') AS "TRUNCATED TO HOUR",
       TRUNCATE(mytimestamp, 'minute') AS "TRUNCATED TO MINUTE",
       TRUNCATE(mytimestamp, 'second') AS "TRUNCATED TO SECOND"
  FROM test_date_trunc;

+-------------------------+-------------------------+-------------------------+-------------------------+
| TIMESTAMP               | TRUNCATED TO HOUR       | TRUNCATED TO MINUTE     | TRUNCATED TO SECOND     |
|-------------------------+-------------------------+-------------------------+-------------------------|
| 2024-05-09 08:50:57.891 | 2024-05-09 08:00:00.000 | 2024-05-09 08:50:00.000 | 2024-05-09 08:50:57.000 |
+-------------------------+-------------------------+-------------------------+-------------------------+

TRUNC 函数与 EXTRACT 函数形成鲜明对比：

SELECT TRUNC(mytimestamp, 'quarter') AS "TRUNCATED",
       EXTRACT('quarter', mytimestamp) AS "EXTRACTED"
  FROM test_date_trunc;

+-------------------------+-----------+
| TRUNCATED               | EXTRACTED |
|-------------------------+-----------|
| 2024-04-01 00:00:00.000 |         2 |
+-------------------------+-----------+