@clickzetta/cz-cli-darwin-x64 0.3.1

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/timestampadd.md

@@ -0,0 +1,59 @@
+### TIMESTAMPADD 函数
+
+#### 概述
+TIMESTAMPADD 函数（别名：DATEADD）用于在给定的时间戳（ts）上增加或减少指定数量（count）的单位（unit）。如果 count 为正数，则在时间戳上增加相应的单位；如果 count 为负数，则在时间戳上减少相应的单位。
+
+#### 支持的时间单位
+时间单位（unit）可以取以下关键字（不区分大小写）：
+- MICROSECOND（微秒）
+- MILLISECOND（毫秒）
+- SECOND（秒）
+- MINUTE（分钟）
+- HOUR（小时）
+- DAY（天）
+- DAYOFYEAR（一年中的第几天）
+- WEEK（周）
+- MONTH（月）
+- QUARTER（季度）
+- YEAR（年）
+
+#### 函数参数
+- unit: timestamp_ltz 类型，表示要添加或减去的时间单位。
+- count: bigint 类型，表示要添加或减去的数量。
+- ts: timestamp_ltz 类型，表示当前时间戳。
+
+#### 返回值
+返回一个新的时间戳（timestamp_ltz）。
+
+#### 使用示例
+1. 在时间戳 '2020-10-10 01:02:03' 上增加 1 年：
+   ```sql
+   SELECT TIMESTAMPADD(YEAR, 1, '2020-10-10 01:02:03');
+   ```
+   结果：`2021-10-10 01:02:03`
+
+2. 在时间戳 '2020-10-10 01:02:03' 上减少 30 分钟：
+   ```sql
+   SELECT TIMESTAMPADD(MINUTE, -30, '2020-10-10 01:02:03');
+   ```
+   结果：`2020-10-10 00:32:03`
+
+3. 在时间戳 '2021-01-01 12:00:00' 上增加 100 天：
+   ```sql
+   SELECT TIMESTAMPADD(DAY, 100, '2021-01-01 12:00:00');
+   ```
+   结果：`2021-04-10 12:00:00`
+
+4. 在时间戳 '2020-10-10 01:02:03' 上增加 2 个月：
+   ```sql
+   SELECT TIMESTAMPADD(MONTH, 2, '2020-10-10 01:02:03');
+   ```
+   结果：`2020-12-10 01:02:03`
+
+5. 在时间戳 '2020-10-10 01:02:03' 上增加 1 季度：
+   ```sql
+   SELECT TIMESTAMPADD(QUARTER, 1, '2020-10-10 01:02:03');
+   ```
+   结果：`2021-01-10 01:02:03`
+
+通过使用 TIMESTAMPADD 函数，您可以轻松地对时间戳进行加减操作，以满足不同的业务需求。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/timestampdiff.md

@@ -0,0 +1,78 @@
+### TIMESTAMPDIFF 函数
+
+```sql
+TIMESTAMPDIFF(unit, startTimestamp, endTimestamp)
+```
+
+#### 功能描述
+
+TIMESTAMPDIFF 函数用于计算两个时间戳（startTimestamp 和 endTimestamp）之间的时间差，并以指定的单位（unit）返回结果。该函数支持多种时间单位，包括微秒（MICROSECOND）、毫秒（MILLISECOND）、秒（SECOND）、分钟（MINUTE）、小时（HOUR）、天（DAY）、周（WEEK）、月（MONTH）、季度（QUARTER）和年（YEAR）。
+
+#### 参数说明
+
+* `unit`：所需时间差的单位，可选值包括 `MICROSECOND`（微秒）、`MILLISECOND`（毫秒）、`SECOND`（秒）、`MINUTE`（分钟）、`HOUR`（小时）、`DAY`（天）、`WEEK`（周）、`MONTH`（月）、`QUARTER`（季度）和 `YEAR`（年）。
+* `startTimestamp`：开始时间戳，需为 timestamp 类型。
+* `endTimestamp`：结束时间戳，需为 timestamp 类型。
+
+#### 返回结果
+
+返回一个整型数值，表示从 `startTimestamp` 到 `endTimestamp` 之间的时间差，单位由参数 `unit` 决定。
+
+#### 使用示例
+
+1. 计算两个时间戳之间相差的微秒数：
+
+```sql
+SELECT TIMESTAMPDIFF(MICROSECOND, '2022-03-31 00:00:00', '2022-03-30 06:00:00') as res;
++--------------+
+|     res      |
++--------------+
+| -64800000000 |
++--------------+
+```
+
+2. 计算两个时间戳之间相差的小时数：
+
+```sql
+SELECT TIMESTAMPDIFF(HOUR, '2022-03-31 00:00:00', '2022-03-30 06:00:00') as res ;
++-----+
+| res |
++-----+
+| -18 |
++-----+
+```
+
+3. 计算两个时间戳之间相差的天数：
+
+```sql
+SELECT TIMESTAMPDIFF(DAY, '2022-03-31 00:00:00', '2022-03-30 06:00:00') as res;
++-----+
+| res |
++-----+
+| 0   |
++-----+
+```
+
+4. 计算两个时间戳之间相差的月份数：
+
+```sql
+SELECT TIMESTAMPDIFF(MONTH, '2022-03-31 00:00:00', '2022-02-28 06:00:00')as res;
++-----+
+| res |
++-----+
+| -1  |
++-----+
+```
+
+5. 计算两个时间戳之间相差的年数：
+
+```sql
+SELECT TIMESTAMPDIFF(YEAR, '2022-03-31 00:00:00', '2021-03-30 06:00:00') as res;
++-----+
+| res |
++-----+
+| -1  |
++-----+
+```
+
+

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/to_date.md

@@ -0,0 +1,43 @@
+### TO_DATE 函数
+
+```sql
+TO_DATE(expr [, fmt])
+```
+
+#### 功能描述
+TO_DATE 函数用于将字符串类型的表达式（expr）按照指定的格式（fmt）转换为日期类型。如果未提供 fmt 参数，则会根据系统默认的日期格式进行转换。如果表达式中包含非法的日期格式，则转换结果为 null。
+
+#### 参数说明
+- **expr** (string): 需要转换的字符串表达式。
+- **fmt** (string, 可选): 字符串表达式中日期的格式。如果不提供该参数，则按照系统默认的日期格式进行转换。
+
+#### 返回结果
+返回转换后的日期类型结果。
+
+#### 使用示例
+1. 将字符串转换为日期（默认格式）：
+   ```sql
+   SELECT TO_DATE('2022-02-01');
+   -- 返回结果：2022-02-01
+   ```
+2. 按照指定的格式转换字符串为日期：
+   ```sql
+   SELECT TO_DATE('01/02/2022', 'dd/MM/yyyy');
+   -- 返回结果：2022-02-01
+   ```
+3. 使用不同国家的日期格式进行转换：
+   ```sql
+   SELECT TO_DATE('02/01/2022', 'MM/dd/yyyy');
+   -- 返回结果：2022-02-01（在美国格式中，月和日颠倒）
+   ```
+4. 在转换过程中处理非法日期格式：
+   ```sql
+   SELECT TO_DATE('2022/13/01', 'yyyy/MM/dd');
+   -- 返回结果：null（因为13月不是有效的月份）
+   ```
+
+
+#### 注意事项
+- 确保输入的字符串表达式符合指定的日期格式，否则转换结果可能为 null。
+- 在处理用户输入的日期时，建议对输入值进行验证，以避免潜在的安全风险。
+- TO_DATE 函数在不同数据库系统中的实现可能略有不同，请根据具体使用的数据库系统查阅相关文档。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/to_start_of_interval.md

@@ -0,0 +1,25 @@
+### TO_START_OF_INTERVAL
+```sql
+to_start_of_interval(ts， interval)
+```
+#### 功能
+将时间 ts 按照 interval 截断。注意当 interval 为分钟时，需要保证其能被 1 天整除。
+
+#### 参数
+* `ts` timestamp
+* `interval` interval_day_time/interval_year_month
+#### 返回结果
+timestamp
+#### 举例
+```sql
+> select
+  to_start_of_interval(ts, interval 5 minute),
+  to_start_of_interval(ts, interval 1 day)
+  from values
+   (timestamp '1933-06-22 04:44:08.999'),
+   (timestamp '1970-12-31 04:59:59.999'),
+   (timestamp '1996-03-31 07:03:33.123') t(ts);
+1933-06-22 04:40:00     1933-06-22 00:00:00
+1970-12-31 04:55:00     1970-12-31 00:00:00
+1996-03-31 07:00:00     1996-03-31 00:00:00
+```

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/to_timestamp.md

@@ -0,0 +1,66 @@
+### TO\_TIMESTAMP 函数
+
+```sql
+to_timestamp(expr [, fmt])
+```
+
+#### 功能描述
+
+TO_TIMESTAMP 函数用于将不同类型的日期时间表达式（expr）转换为时间戳（timestamp）类型。如果提供了 fmt 参数，函数将根据指定的格式进行解析；若未提供 fmt，则按照默认格式进行转换。如果 expr 中的日期时间格式不正确，函数将返回 NULL。
+
+#### 参数说明
+
+* expr (string): 需要转换的字符串表达式。
+* fmt (string, 可选): 指定字符串表达式中日期时间的格式。
+
+#### 返回结果
+
+转换后的时间戳（timestamp）。
+
+#### 使用示例
+
+1. 将字符串转换为时间戳（不指定 fmt 参数）：
+
+   ```sql
+   SELECT to_timestamp('2022-02-01 10:23:32.121') as res;
+   +-------------------------+
+   |           res           |
+   +-------------------------+
+   | 2022-02-01 10:23:32.121 |
+   +-------------------------+
+   ```
+
+2. 根据指定的格式将字符串转换为时间戳：
+
+   ```sql
+   SELECT to_timestamp('2022/02/01 10:23:32.121', 'yyyy/MM/dd HH:mm:ss.SSS') as res;
+   +-------------------------+
+   |           res           |
+   +-------------------------+
+   | 2022-02-01 10:23:32.121 |
+   +-------------------------+
+   ```
+
+3. 将不同类型的日期时间字符串转换为时间戳：
+
+   ```sql
+   SELECT to_timestamp('01-02 10:23:32', 'dd-MM HH:mm:ss') as res;
+   +---------------------+
+   |         res         |
+   +---------------------+
+   | 1970-02-01 10:23:32 |
+   +---------------------+
+   ```
+
+4. 转换非法日期时间字符串：
+
+   ```sql
+   SELECT to_timestamp('2022-02-30 10:23:32.121') as res;
+   +-----+
+   | res |
+   +-----+
+   |     |
+   +-----+
+   ```
+
+请注意，TO_TIMESTAMP 函数在处理非法日期时间字符串时会返回 NULL。因此，在使用该函数时，请确保输入的字符串格式正确。同时，可以通过 fmt 参数灵活地处理不同格式的日期时间字符串。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/to_timestamp_ntz.md

@@ -0,0 +1,52 @@
+### TO_TIMESTAMP_NTZ 函数
+
+```sql
+to_timestamp_ntz(expr [, fmt])
+```
+### 功能描述
+
+TO_TIMESTAMP_NTZ 函数用于将不同类型的日期时间表达式（expr）转换为时间戳（timestamp_ntz）类型。如果提供了 fmt 参数，函数将根据指定的格式进行解析；若未提供 fmt，则按照默认格式进行转换。如果 expr 中的日期时间格式不正确，函数将返回 null。
+
+### 参数说明
+
+* expr (string): 需要转换的字符串表达式。
+* fmt (string, 可选): 指定字符串表达式中日期时间的格式。
+
+### 返回结果
+
+转换后的时间戳（timestamp_ntz）。
+
+### 案例
+
+1. 根据指定的格式将字符串转换为时间戳：
+
+```SQL
+SELECT to_timestamp_ntz('2022/02/01 10:23:32.121', 'yyyy/MM/dd HH:mm:ss.SSS') as ntz;
++-------------------------+
+|           ntz           |
++-------------------------+
+| 2022-02-01 10:23:32.121 |
++-------------------------+
+```
+
+2. 如果字符串符合时间格式 `yyyy-MM-dd HH:mm:ss.SSS`，则无需指定格式参数。
+
+```SQL
+SELECT to_timestamp_ntz('2022-02-01 10:23:32.121') ntz;
++-------------------------+
+|           ntz           |
++-------------------------+
+| 2022-02-01 10:23:32.121 |
++-------------------------+
+```
+
+3. 将不同类型的日期时间字符串转换为时间戳：
+
+```SQL
+SELECT to_timestamp_ntz('01-02 10:23:32', 'dd-MM HH:mm:ss') ntz;
++---------------------+
+|         ntz         |
++---------------------+
+| 1970-02-01 10:23:32 |
++---------------------+
+```

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/to_unix_timestamp.md

@@ -0,0 +1,59 @@
+### 函数名称
+
+`TO_UNIX_TIMESTAMP`
+
+### 功能描述
+
+`TO_UNIX_TIMESTAMP` 函数用于将不同类型的日期时间表达式转换为 Unix 时间戳（UTC）。Unix 时间戳是从 '1970-01-01 00:00:00' UTC 到指定时间所经过的总秒数。如果提供了 `fmt` 参数，则按照该格式解析 `expr`；否则，按照默认的 'yyyy-MM-dd HH:mm:ss' 格式解析。如果 `expr` 中的日期时间非法或无法解析，函数将返回 null。
+
+### 参数说明
+
+* `expr` (string): 需要转换的日期时间字符串。
+* `fmt` (string, 可选): 日期时间字符串的格式。默认为 'yyyy-MM-dd HH:mm:ss'。
+
+### 返回结果
+
+返回一个 bigint 类型的 Unix 时间戳。
+
+### 使用示例
+
+1. 将默认格式的字符串转换为 Unix 时间戳：
+
+```sql
+SELECT TO_UNIX_TIMESTAMP('2022-02-01 10:23:32') as res;
++------------+
+|    res     |
++------------+
+| 1643682212 |
++------------+
+```
+
+2. 将自定义格式的字符串转换为 Unix 时间戳：
+
+```sql
+SELECT TO_UNIX_TIMESTAMP('2022/02/01 10:23:32.121', 'yyyy/MM/dd HH:mm:ss.SSS') as res;
++------------+
+|    res     |
++------------+
+| 1643682212 |
++------------+
+```
+
+3. 转换非法日期时间字符串：
+
+```sql
+SELECT TO_UNIX_TIMESTAMP('2022-02-30 10:23:32');
++------+
+| res  |
++------+
+| null |
++------+
+```
+
+### 注意事项
+
+* 当 `fmt` 参数未提供或其格式不正确时，将使用默认格式进行解析。
+* 如果输入的日期时间字符串无法解析或非法，函数将返回 null。
+* 请确保 `expr` 参数中的日期时间字符串与 `fmt` 参数（如有）的格式相匹配，以获得正确的转换结果。
+
+

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/to_unix_timestamp_ms.md

@@ -0,0 +1,45 @@
+### TO_UNIX_TIMESTAMP_MS 函数
+
+#### 功能描述
+`TO_UNIX_TIMESTAMP_MS` 函数用于将不同类型的时间表达式转换为 Unix 时间戳（毫秒）。Unix 时间戳是从 1970 年 1 月 1 日 00:00:00 UTC 到指定时间的总毫秒数。这个函数可以处理多种输入格式，包括字符串、时间戳等。
+
+#### 参数说明
+* `expr`：输入的时间表达式，可以是字符串、时间戳等。
+
+#### 返回结果
+返回一个 `bigint` 类型的值，表示输入时间表达式转换后的 Unix 时间戳（毫秒）。
+
+#### 使用示例
+
+1. 从字符串转换为 Unix 时间戳（毫秒）：
+   ```sql
+   SELECT TO_UNIX_TIMESTAMP_MS('2022-02-01 10:23:32.123');
+   -- 结果：1643682212123
+   ```
+   这个例子中，将字符串 `'2022-02-01 10:23:32.123'` 转换为 Unix 时间戳（毫秒）。
+
+2. 从当前时间获取 Unix 时间戳（毫秒）：
+   ```sql
+   SELECT TO_UNIX_TIMESTAMP_MS(NOW());
+   -- 结果：根据不同时间，结果会有所不同
+   ```
+   这个例子中，使用 `NOW()` 函数获取当前时间，并将其转换为 Unix 时间戳（毫秒）。
+
+3. 从字符串转换为 Unix 时间戳（毫秒），并考虑时区差异：
+   ```sql
+   SELECT TO_UNIX_TIMESTAMP_MS('2022-02-01 10:23:32.123');
+   -- 结果：1643682212123
+   ```
+   这个例子中，将字符串 `'2022-02-01 10:23:32.123'` 转换为 Unix 时间戳（毫秒），并考虑了时区差异。
+
+4. 从时间戳转换为 Unix 时间戳（毫秒）：
+   ```sql
+   SELECT TO_UNIX_TIMESTAMP_MS(TIMESTAMP "2022-02-01 10:23:32.123");
+   -- 结果：1643682212123
+   ```
+   这个例子中，将时间戳 `TIMESTAMP "2022-02-01 10:23:32.123"` 转换为 Unix 时间戳（毫秒）。
+
+#### 注意事项
+- 输入的时间表达式需要符合支持的格式，否则可能会导致转换失败。
+- 时区差异需要在转换时考虑，以确保结果的准确性。
+- 请确保在使用此函数时，输入参数与预期的数据类型相匹配。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/to_unix_timestamp_us.md

@@ -0,0 +1,40 @@
+### TO_UNIX_TIMESTAMP_US 函数
+
+```
+to_unix_timestamp_us(expr)
+```
+
+#### 功能描述
+`TO_UNIX_TIMESTAMP_US` 函数用于将不同类型的时间表达式转换为 Unix 时间戳（微秒），即自 1970 年 1 月 1 日 00:00:00 UTC 至指定时间的总微秒数。
+
+#### 参数说明
+* `expr`：时间戳表达式，可以是字符串、时间戳等。
+
+#### 返回类型
+返回类型为 `BIGINT`。
+
+#### 使用示例
+1. 从字符串转换为 Unix 时间戳（微秒）：
+   ```sql
+   SELECT TO_UNIX_TIMESTAMP_US('2022-02-01 10:23:32.123456');
+   -- 结果：1643682212123456
+   ```
+2. 从当前时间获取 Unix 时间戳（微秒）：
+   ```sql
+   SELECT TO_UNIX_TIMESTAMP_US(NOW());
+   -- 结果：当前时间的 Unix 时间戳（微秒）
+   ```
+3. 从时间戳转换为 Unix 时间戳（微秒）：
+   ```sql
+   SELECT TO_UNIX_TIMESTAMP_US(TIMESTAMP "2022-02-01 10:23:32.123456");
+   -- 结果：1643682212123456
+   ```
+4. 从当前时间戳转换为 Unix 时间戳（微秒）并添加偏移量：
+   ```sql
+   SELECT TO_UNIX_TIMESTAMP_US(TIMESTAMP "2022-02-01 10:23:32.123456") + 3600000000;
+   -- 结果：在当前时间戳的基础上增加 1 小时（3600000000 微秒）
+   ```
+
+#### 注意事项
+- 请确保输入的时间表达式格式正确，否则可能导致转换失败。
+- 该函数返回的 Unix 时间戳（微秒）可用于计算时间差、时间戳比较等操作。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/to_utc_timestamp.md

@@ -0,0 +1,62 @@
+### TO\_UTC\_TIMESTAMP 函数
+
+```
+to_utc_timestamp(expr, tz)
+```
+
+#### 功能描述
+
+TO_UTC_TIMESTAMP 函数用于将指定时区的时间转换为 UTC 时间。该函数接受两个参数：一个时间戳表达式（expr）和一个时区字符串（tz）。函数返回一个时间戳，表示转换后的 UTC 时间。
+
+#### 参数说明
+
+* **expr**: 时间戳类型，表示要转换的时间。
+* **tz**: 字符串类型，表示输入时间所在的时区。
+
+#### 返回结果
+
+* 返回一个时间戳，表示转换后的 UTC 时间。
+
+#### 使用示例
+
+1. 将北京时间转换为 UTC 时间：
+   ```sql
+   SELECT TO_UTC_TIMESTAMP('2017-07-14 02:01:00', 'Asia/Shanghai') as res;
+   +---------------------+
+   |         res         |
+   +---------------------+
+   | 2017-07-13 18:01:00 |
+   +---------------------+
+   ```
+
+2. 将纽约时间转换为 UTC 时间：
+   ```sql
+   SELECT TO_UTC_TIMESTAMP('2017-07-14 10:30:00', 'America/New_York')as res;
+   +---------------------+
+   |         res         |
+   +---------------------+
+   | 2017-07-14 14:30:00 |
+   +---------------------+
+   ```
+
+3. 将洛杉矶时间转换为 UTC 时间：
+   ```sql
+   SELECT TO_UTC_TIMESTAMP('2017-07-14 07:45:00', 'America/Los_Angeles') as res;
+   +---------------------+
+   |         res         |
+   +---------------------+
+   | 2017-07-14 14:45:00 |
+   +---------------------+
+   ```
+
+4. 将伦敦时间转换为 UTC 时间：
+   ```sql
+   SELECT TO_UTC_TIMESTAMP('2017-07-14 12:00:00', 'Europe/London') as res;
+   +---------------------+
+   |         res         |
+   +---------------------+
+   | 2017-07-14 11:00:00 |
+   +---------------------+
+   ```
+
+通过以上示例，可以看到 TO_UTC_TIMESTAMP 函数可以方便地将不同地区的本地时间转换为 UTC 时间，便于进行跨时区的时间比较和计算。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/toyyyymmdd.md

@@ -0,0 +1,69 @@
+# TOYYYYMMDD 函数
+
+## 概述
+
+`TOYYYYMMDD` 函数用于将不同类型的时间表达式转换为日期格式，即 `YYYYMMDD`。该函数接受 `date` 或 `timestamp` 类型的参数，并返回一个整数类型的结果。
+
+## 语法
+
+```
+TOYYYYMMDD(expr)
+```
+
+## 参数
+
+* `expr`: `date` 或 `timestamp` 类型的时间表达式。
+
+## 返回结果
+
+返回一个整数，表示输入时间表达式对应的 `YYYYMMDD` 格式的数字。
+
+## 示例
+
+1. 使用当前时间戳：
+
+   ```sql
+   SELECT TOYYYYMMDD(now());
+   ```
+
+   假设当前时间戳为 `2022-01-01 15:00:00`，返回结果为 `20220101`。
+
+2. 使用字符串形式的日期：
+
+   ```sql
+   SELECT TOYYYYMMDD('2023-04-15') as res;
+   +----------+
+   |   res    |
+   +----------+
+   | 20230415 |
+   +----------+
+   ```
+3. 使用时间戳转换为日期：
+
+   ```sql
+   SELECT TOYYYYMMDD(TIMESTAMP "2024-05-25 03:21:00") as res;
+   +----------+
+   |   res    |
+   +----------+
+   | 20240525 |
+   +----------+
+   ```
+4. 使用当前时间戳并格式化为日期：
+
+   ```sql
+   SELECT TOYYYYMMDD(CURRENT_TIMESTAMP() - INTERVAL '1 day') as res ;
+   +----------+
+   |   res    |
+   +----------+
+   | 20250120 |
+   +----------+
+   ```
+
+## 注意事项
+
+* 当输入的时间表达式无法转换为日期时，函数将返回 `NULL`。
+* 请确保输入的时间表达式格式正确，否则可能导致错误的结果。
+
+## 总结
+
+`TOYYYYMMDD` 函数提供了一种简便的方法，将不同类型的时间表达式转换为日期格式。通过使用此函数，用户可以轻松地获取日期的整数表示，从而方便地进行日期计算和比较。

package/bin/skills/lakehouse-doc/references/sql_functions/scalar_functions/datetime_functions/trunc.md

@@ -0,0 +1,38 @@
+### TRUNC 函数
+```
+trunc(expr, fmt)
+```
+#### 功能描述
+TRUNC 函数根据指定的 fmt 格式截断日期表达式 expr，返回一个新的日期。
+#### 参数说明
+* **expr** (date): 需要进行截断操作的日期表达式。
+* **fmt** (string): 用于指定截断精度的字符串，大小写不敏感。有效取值如下：
+	+ 'YEAR', 'YYYY', 'YY': 截断到 expr 所在年份的第一天（1月1日）。
+	+ 'QUARTER': 截断到 expr 所在季度的第一天。
+	+ 'MONTH', 'MM', 'MON': 截断到 expr 所在月份的第一天。
+	+ 'WEEK': 截断到 expr 所在星期的星期一。
+#### 返回结果
+返回一个日期类型的值，表示按照指定 fmt 截断后的日期。
+#### 使用示例
+```sql
+-- 将日期截断到所在年份的第一天
+SELECT trunc('2022-02-03', 'YEAR'); -- 结果为 2022-01-01
+
+-- 将日期截断到所在季度的第一天
+SELECT trunc('2022-02-03', 'QUARTER'); -- 结果为 2022-01-01
+
+-- 将日期截断到所在月份的第一天
+SELECT trunc('2022-02-03', 'MONTH'); -- 结果为 2022-02-01
+
+-- 将日期截断到所在星期的星期一
+SELECT trunc('2022-02-03', 'WEEK'); -- 结果为 2022-01-31
+
+-- 将日期截断到所在季度的第一天，并返回字符串格式的结果
+SELECT trunc('2022-02-03', 'QUARTER') AS quarter_start; -- 结果为 "2022-01-01"
+
+-- 将日期截断到所在月份的第一天，并转换为时间格式
+SELECT trunc('2022-02-03', 'MONTH') AS month_start_time; -- 结果为 "2022-02-01 00:00:00"
+```
+#### 注意事项
+* 当 expr 不是有效的日期表达式时，TRUNC 函数将返回 NULL。
+* 当 fmt 参数取值不正确时，TRUNC 函数将返回错误。请确保使用有效的 fmt 值。