@clickzetta/cz-cli-darwin-arm64 0.3.76 → 0.3.80

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

@@ -1,59 +0,0 @@
-### 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

@@ -1,78 +0,0 @@
-### 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

@@ -1,43 +0,0 @@
-### 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

@@ -1,25 +0,0 @@
-### 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

@@ -1,66 +0,0 @@
-### 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

@@ -1,52 +0,0 @@
-### 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

@@ -1,59 +0,0 @@
-### 函数名称
-
-`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

@@ -1,45 +0,0 @@
-### 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

@@ -1,40 +0,0 @@
-### 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

@@ -1,62 +0,0 @@
-### 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

@@ -1,69 +0,0 @@
-# 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

@@ -1,38 +0,0 @@
-### 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 值。