@clickzetta/cz-cli-darwin-x64 0.3.1

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

@@ -0,0 +1,61 @@
+### ADD\_YEARS 函数
+
+```
+add_years(startDate, numYears)
+```
+
+#### 功能描述
+
+该函数用于计算并返回在给定的开始日期（startDate）基础上增加（或减少）指定年数（numYears）后的日期。如果计算结果超出了系统支持的日期范围，则会返回 null。
+
+#### 参数说明
+
+* `startDate`：类型为 `date`，表示计算开始的日期。
+* `numYears`：类型为 `int`，表示要增加或减少的年数，可以为正数或负数。
+
+#### 返回结果
+
+返回一个 `date` 类型的日期，表示计算后的结果。
+
+#### 使用示例
+
+1. 计算未来的日期：
+
+```sql
+SELECT add_years('2020-05-31', 3);
++----------------------------+
+| add_years('2020-05-31', 3) |
++----------------------------+
+| 2023-05-31                 |
++----------------------------+
+```
+
+2. 计算过去的日期：
+
+```sql
+SELECT add_years('2020-05-31', -5);
++-----------------------------+
+| add_years('2020-05-31', -5) |
++-----------------------------+
+| 2015-05-31                  |
++-----------------------------+
+```
+
+3. 当增加的年数导致结果超出系统日期范围时，返回 null：
+
+```sql
+SELECT add_years('1900-01-01', 200);
++------------------------------+
+| add_years('1900-01-01', 200) |
++------------------------------+
+| 2100-01-01                   |
++------------------------------+1
+```
+
+#### 注意事项
+
+* 确保输入的 `startDate` 参数为有效的日期格式，否则可能导致计算结果不准确。
+* 当 `numYears` 为负数时，表示从开始日期往过去推算相应的年数。
+* 如果计算结果超出系统支持的日期范围，函数将返回 null，请注意处理这种情况。
+
+^

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

@@ -0,0 +1,53 @@
+### ADD_DAYS 函数
+#### 功能描述
+`ADD_DAYS` 函数用于在给定的日期 `startDate` 上增加 `numDays` 天，返回一个新的日期。如果计算结果超出了系统所支持的日期范围，则返回 `null`。
+
+#### 函数语法
+```
+add_days(startDate, numDays)
+```
+#### 参数说明
+- `startDate`: 日期类型，表示开始日期。
+- `numDays`: 整数类型，表示要增加的天数。
+
+#### 返回结果
+返回一个新的日期，类型为 `date`。
+
+#### 使用示例
+1. 增加 5 天到指定日期：
+```
+SELECT add_days('2022-01-01', 5);
+```
+结果：
+```
+2022-01-06
+```
+2. 从指定日期减少 10 天：
+```
+SELECT add_days('2022-01-15', -10);
+```
+结果：
+```
+2022-01-05
+```
+3. 计算 100 天后的重要会议日期：
+```
+SELECT add_days('2022-03-01', 100);
+```
+结果：
+```
+2022-06-09
+```
+4. 计算从某项目启动日期起 200 天后的结束日期：
+```
+SELECT add_days('2022-01-20', 200);
+```
+结果：
+```
+2022-08-18
+```
+#### 注意事项
+- 确保 `startDate` 参数为有效的日期格式，否则会导致函数返回 `null`。
+- 当增加的天数导致日期超出系统支持范围时，函数将返回 `null`，请注意检查返回值。
+
+通过使用 `ADD_DAYS` 函数，您可以方便地计算未来或过去的日期，从而在处理日期相关问题时提供极大的便利。

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

@@ -0,0 +1,46 @@
+### 转换时区函数 CONVERT_TIMEZONE
+
+#### 功能描述
+`CONVERT_TIMEZONE` 函数用于将一个指定的时间戳从一个时区转换到另一个时区。该函数能够处理不同类型的时间格式输入，并在必要时自动进行类型转换。
+
+#### 语法
+```sql
+CONVERT_TIMEZONE(source_tz, target_tz, ts)
+CONVERT_TIMEZONE(target_tz, ts)
+```
+- `source_tz` string : 原始时区。如果只提供两个参数，则默认使用当前会话的时区作为原始时区。
+- `target_tz` string : 目标时区。
+- `ts` int 或 timestamp : 时间戳。如果是整数类型，函数会自动将其转换为时间戳类型。
+
+#### 返回值
+转换后的时间戳（timestamp）。
+
+#### 使用示例
+```sql
+-- 示例1：将时间戳从莫斯科时区转换到洛杉矶时区
+SELECT CONVERT_TIMEZONE('Europe/Moscow', 'America/Los_Angeles', '2022-01-01 00:00:00');
+
+-- 返回结果：2021-12-31 13:00:00
+
+-- 示例2：将当前布鲁塞尔时区的时间戳转换到目标时区
+SELECT CONVERT_TIMEZONE('Europe/Brussels', 'Asia/Shanghai', '2022-03-23 00:00:00');
+
+-- 返回结果： 2022-03-23 07:00:00
+
+-- 示例3：只提供目标时区，将当前会话时区的时间戳转换到东京时区
+SELECT CONVERT_TIMEZONE('Asia/Tokyo', 1674681600);
+
+-- 返回结果： 2023-01-26 06:20:00
+
+-- 示例4：将整数类型的时间戳从北京时间转换到UTC时间
+SELECT CONVERT_TIMEZONE('UTC','Asia/Shanghai', 1674681600);
+
+-- 返回结果：2023-01-26 13:20:00 
+```
+
+#### 注意事项
+- 请确保输入的时区名称有效，否则函数将返回错误。
+- 当输入的时间戳格式不正确或无法识别时，函数将自动尝试进行类型转换。
+- 如果输入的时间戳已经是目标时区的时间，函数将直接返回该时间戳。
+
+通过使用 `CONVERT_TIMEZONE` 函数，您可以轻松地在不同时区之间转换时间戳，从而确保数据的准确性和一致性。

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

@@ -0,0 +1,56 @@
+### CURRENT_DATE 函数
+```
+CURRENT_DATE()
+```
+#### 功能描述
+CURRENT_DATE 函数是一个非确定性函数，用于返回执行查询时的当前日期。需要注意的是，在整个查询过程中，多次调用 CURRENT_DATE() 将返回相同的结果。
+
+#### 参数
+该函数不需要任何参数。
+
+#### 返回结果
+返回值类型为日期（date）。
+
+#### 使用示例
+以下示例将帮助您更好地理解 CURRENT_DATE 函数的用法：
+
+1. 查询当前日期：
+   ```sql
+   SELECT CURRENT_DATE();
+   ```
+   结果：
+   ```
+   2022-01-01
+   ```
+
+2. 在更复杂的查询中使用当前日期：
+   ```sql
+   SELECT user_id, order_date, current_date() - INTERVAL 7 DAY AS week_ago_date
+   FROM orders;
+   ```
+   结果：
+   ```
+   +-----------+------------+-------------------+
+   | user_id  | order_date | week_ago_date    |
+   +-----------+------------+-------------------+
+   | 1         | 2022-01-05 | 2021-12-25         |
+   | 2         | 2022-01-03 | 2021-12-27         |
+   | 3         | 2021-12-29 | 2021-12-22         |
+   +-----------+------------+-------------------+
+   ```
+
+3. 筛选出在过去一周内下单的用户：
+   ```sql
+   SELECT user_id, order_date
+   FROM orders
+   WHERE order_date >= CURRENT_DATE() - INTERVAL 1 WEEK;
+   ```
+   结果：
+   ```
+   +-----------+------------+
+   | user_id  | order_date |
+   +-----------+------------+
+   | 1         | 2022-01-05 |
+   | 4         | 2022-01-02 |
+   +-----------+------------+
+   ```

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

@@ -0,0 +1,46 @@
+### CURRENT_TIMESTAMP 函数
+```
+current_timestamp()
+```
+#### 功能描述
+`CURRENT_TIMESTAMP` 函数是一个非确定性函数，用于返回当前查询开始执行时的时间戳。在同一个查询中，无论调用多少次 `CURRENT_TIMESTAMP` 函数，返回的时间戳都是相同的。该函数对于记录查询执行的起始时间非常有用，尤其是在需要对时间敏感的数据分析和事务处理中。
+
+#### 参数说明
+无需提供任何参数。
+
+#### 返回类型
+该函数返回一个 `timestamp_ltz` 类型的时间戳。
+
+#### 使用示例
+1. 查询当前时间戳：
+   ```sql
+   SELECT current_timestamp();
+   ```
+   执行结果：
+   ```
+   2022-01-01 15:17:22.098368
+   ```
+
+2. 在插入数据时记录当前时间戳：
+   ```sql
+   INSERT INTO my_table (id, name, created_at) VALUES (1, 'John Doe', current_timestamp());
+   ```
+   这条语句会在插入新记录时，将当前时间戳作为 `created_at` 字段的值。
+
+3. 比较查询前后的时间戳差异：
+   ```sql
+   SELECT current_timestamp() AS start_time;
+   -- 执行一些查询操作 --
+   SELECT current_timestamp() AS end_time;
+   ```
+   这将分别记录查询开始和结束的时间戳，可用于分析查询执行的耗时。
+
+4. 与时间间隔结合使用，计算未来或过去的时间点：
+   ```sql
+   SELECT current_timestamp() + INTERVAL '1 day' AS tomorrow_date;
+   ```
+   执行结果：
+   ```
+    2024-04-08 20:03:39.170094
+    ```
+

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

@@ -0,0 +1,42 @@
+### DATE 函数
+
+#### 功能描述
+
+DATE 函数用于将不同类型的日期表达式转换为日期类型，即 `DATE` 类型。它可以处理多种输入格式，包括字符串、时间、时间戳等。DATE 函数与 `CAST(expr AS DATE)` 的功能相同。
+
+#### 支持的参数
+
+* `expr`：可以是字符串、时间、时间戳等能够被转换成日期类型的表达式。
+
+#### 返回结果
+
+* 返回一个日期类型的结果，格式为 `YYYY-MM-DD`。
+
+#### 使用示例
+
+1.  字符串转日期：
+    ```sql
+   SELECT DATE('2022-01-01');
+   -- 结果：2022-01-01
+   ```
+    ```sql
+   SELECT DATE('2022/01/01');要求格式必须是YYYY-MM-DD格式
+   -- 结果：null
+   ```
+2.  时间转日期：
+    ```sql
+   SELECT DATE('22:12:30');要求格式必须是YYYY-MM-DD格式
+   -- 结果：null
+   ```
+    ```sql
+   SELECT DATE(TIMESTAMP "2022-01-01 22:12:30");
+   -- 结果：2022-01-01
+   ```
+
+#### 注意事项
+
+* 当输入的字符串无法识别为有效的日期时，DATE 函数将返回 `NULL`。
+* 在转换过程中，DATE 函数会自动忽略输入表达式中的时区信息，只保留日期部分。
+* 如果输入的时间超出了数据库支持的时间范围，可能会导致转换失败或返回意外的结果。
+
+

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

@@ -0,0 +1,35 @@
+### date_add 函数
+```sql
+date_add(startDate, numDays)
+```
+#### 功能描述
+该函数用于计算并返回在给定的日期 `startDate` 基础上增加 `numDays` 天后的日期。如果计算结果超出了系统所支持的日期范围，则会返回 `null`。
+
+#### 参数说明
+- `startDate` (date): 起始日期，需要符合日期格式。
+- `numDays` (int): 需要增加的天数，可以为正整数（增加天数）或负整数（减少天数）。
+
+#### 返回结果
+返回一个新的日期，该日期是 `startDate` 加上 `numDays` 天之后的结果，如果结果超出日期范围，则返回 `null`。
+
+#### 使用示例
+1. 增加天数：
+```sql
+SELECT date_add('2020-05-31', 10); -- 返回 2020-06-10
+```
+2. 减少天数：
+```sql
+SELECT date_add('2020-06-10', -3); -- 返回 2020-06-07
+```
+3. 跨年计算：
+```sql
+SELECT date_add('2020-12-31', 1); -- 返回 2021-01-01
+```
+4. 超出日期范围：
+```sql
+SELECT date_add('9999-12-31', 1); -- 返回 null
+```
+#### 注意事项
+- 确保 `startDate` 参数为有效的日期格式，否则可能导致函数返回 `null`。
+- 当 `numDays` 为负数时，表示从 `startDate` 往回推 `numDays` 天。
+- 请留意系统所支持的日期范围，超出范围的计算结果将返回 `null`。

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

@@ -0,0 +1,48 @@
+### DATE\_FORMAT 函数
+
+```sql
+DATE_FORMAT(expr, fmt)
+```
+
+#### 功能描述
+
+`DATE_FORMAT` 函数用于将不同类型的时间表达式（如字符串、时间戳等）按照指定的格式转换为日期字符串。
+
+#### 参数说明
+
+* **expr**: 可以是字符串、时间戳、时间戳带时区等类型的表达式。
+* **fmt**: 用于描述目标日期格式的字符串。具体格式可以参考 [DateTimePatterns](datetime_patterns.md) 页面。
+
+#### 返回类型
+
+返回一个日期字符串，表示按照指定格式转换后的日期。
+
+#### 使用示例
+
+1. 将字符串类型的时间表达式转换为日期字符串：
+
+```sql
+SELECT DATE_FORMAT('2022-05-01', 'yyyy-MM-dd');
+-- 输出结果：2022-05-01
+```
+
+2. 将当前时间戳转换为日期字符串：
+
+```sql
+SELECT DATE_FORMAT(TIMESTAMP "2022-05-01 12:00:00", 'yyyy-MM-dd HH:mm:ss');
+-- 输出结果：2022-05-01 12:00:00
+```
+
+3. 将当前时间戳转换为带有星期信息的日期字符串：
+
+```sql
+SELECT DATE_FORMAT(TIMESTAMP "2022-05-01 12:00:00", 'yyyy-MM-dd EE');
+-- 输出结果：2022-05-01 Sun 
+```
+
+#### 注意事项
+
+* 当输入的时间表达式格式与实际类型不匹配时，可能会导致转换失败。
+* 在使用 `DATE_FORMAT` 函数时，请确保 `fmt` 参数的格式正确无误，以避免出现错误的输出结果。
+
+通过以上示例和说明，您可以灵活地使用 `DATE_FORMAT` 函数对时间表达式进行格式化处理，以满足您在实际业务场景中的需求。

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

@@ -0,0 +1,58 @@
+### DATE_FORMAT_MYSQL 函数
+```
+date_format_mysql(expr, fmt)
+```
+#### 功能描述
+DATE_FORMAT_MYSQL 函数用于将不同类型的时间戳（包括 datetime、timestamp_ltz、string 等）按照指定的格式转换为字符串形式。该函数兼容 MySQL 数据库的日期和时间格式化规则。
+
+#### 参数说明
+- `expr`: 输入的时间戳，可以是 datetime、timestamp_ltz 或者字符串格式。
+- `fmt`: 描述日期时间格式的字符串，具体格式化选项请参考 MySQL 官方文档：[DATE_FORMAT()](https://dev.mysql.com/doc/refman/8.0/en/date-and-time-functions.html#function_date-format)
+
+格式化选项说明：
+
+| 选项 | 描述 |
+| ---- | ---- |
+| `%a` | 简写星期几名称（例如：Sun 到 Sat） |
+| `%b` | 简写月份名称（例如：Jan 到 Dec） |
+| `%c` | 月份数字（00 到 12） |
+| `%D` | 月份中的天数，带英文后缀（例如：1st, 2nd, 3rd, ...） |
+| `%d` | 月份中的天数，数字表示（00 到 31） |
+| `%e` | 月份中的天数，数字表示（0 到 31） |
+| `%f` | 微秒（000000 到 999999） |
+| `%H` | 小时（00 到 23） |
+| `%h` | 小时（01 到 12） |
+| `%I` | 小时（01 到 12） |
+| `%i` | 分钟（00 到 59） |
+| `%j` | 一年中的天数（001 到 366） |
+| `%k` | 小时（0 到 23） |
+| `%l` | 小时（1 到 12） |
+| `%M` | 月份名称（January 到 December） |
+| `%m` | 月份数字（00 到 12） |
+| `%p` | 上午或下午（AM 或 PM） |
+| `%S` | 秒（00 到 59） |
+| `%s` | 秒（00 到 59） |
+| `%T` | 24小时制时间（hh:mm:ss） |
+| `%v` | 周数（01 到 53），星期一作为每周的第一天；[WEEK()](https://dev.mysql.com/doc/refman/8.0/en/date-and-time-functions.html#function_week) 模式 3；与 `%x` 一起使用 |
+| `%W` | 星期名称（Sunday 到 Saturday） |
+| `%w` | 一周中的天数（0 表示星期日，6 表示星期六） |
+| `%x` | 以星期一为每周第一天的年份，数字表示，四位数字；与 `%v` 一起使用 |
+| `%Y` | 年份，数字表示，四位数字 |
+| `%y` | 年份，数字表示，两位数字 |
+| `%%` | 字面上的 `%` 字符 |
+
+#### 返回结果
+返回按照指定格式转换后的日期时间字符串。
+
+#### 使用示例
+1. 将当前时间转换为带有秒的字符串格式：
+```sql
+SELECT date_format_mysql(now(), '%Y-%m-%d %H:%i:%s');
+```
+
+2. 将时间戳转换为仅包含小时和分钟的格式：
+```sql
+SELECT date_format_mysql(timestamp '2023-03-22 13:45:00', '%H:%i');
+```
+
+通过以上示例，您可以看到 DATE_FORMAT_MYSQL 函数在不同场景下的应用。您可以根据需要调整 `fmt` 参数来获取您期望的日期时间格式。

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

@@ -0,0 +1,54 @@
+### DATE_FORMAT_pg 函数
+```
+date_format_pg(expr, fmt)
+```
+#### 功能描述
+`date_format_pg` 函数用于将不同类型的时间表达式按照指定的格式转换为字符串形式。该函数兼容 PostgreSQL 数据库的日期格式化功能。
+
+#### 参数说明
+| 参数 | 类型 | 描述 |
+| --- | --- | --- |
+| expr | date/timestamp_ltz/string | 输入的时间表达式，可以是字符串、时间戳、日期时间等格式。 |
+| fmt | string | 描述格式的字符串，具体格式参考 PostgreSQL 官方文档。 |
+
+#### 支持的格式
+以下是部分支持的格式及其说明：
+
+| 格式 | 描述 |
+| --- | --- |
+| `HH` | 小时（12小时制，01-12） |
+| `HH12` | 小时（12小时制，01-12） |
+| `HH24` | 小时（24小时制，00-23） |
+| `MI` | 分钟（00-59） |
+| `SS` | 秒（00-59） |
+| `MS` | 毫秒（000-999） |
+| `US` | 微秒（000000-999999） |
+| `YYYY` | 年份（4位或更多位数字） |
+| `MM` | 月份（01-12） |
+| `DD` | 月份中的天数（01-31） |
+| `D` | 星期几，星期日（1）到星期六（7） |
+
+#### 返回类型
+- string：格式化后的字符串。
+
+#### 使用示例
+```sql
+-- 将字符串类型的时间表达式转换为日期格式
+SELECT date_format_pg('2022-05-01', 'YYYY-MM-DD');
+
+-- 结果：'2022-05-01'
+
+-- 将当前时间戳转换为带有时分秒的字符串
+SELECT date_format_pg(TIMESTAMP "2022-05-01 12:34:56", 'YYYY-MM-DD HH24:MI:SS');
+
+-- 结果：'2022-05-01 12:34:56'
+
+-- 将当前时间转换为 ISO 8601 格式
+SELECT date_format_pg(TIMESTAMP "2022-05-01 12:34:56", 'YYYY-MM-DD"T"HH24:MI:SS.MS');
+
+-- 结果：'2022-05-01T12:34:56.MS'
+```
+#### 注意事项
+- 请确保 `fmt` 参数中的格式字符串正确无误，否则可能导致转换结果不符合预期。
+- 该函数在不同地区的设置下可能会有不同的表现，例如月份和星期的名称可能会根据本地化设置而变化。
+- 有关更多支持的格式和详细信息，请参考 [PostgreSQL 官方文档](https://www.postgresql.org/docs/current/functions-formatting.html)。

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

@@ -0,0 +1,58 @@
+DATE\_SUB 函数
+
+功能
+----
+
+DATE\_SUB 函数用于计算指定日期加上或减去一定天数后的日期。该函数返回一个新的日期值。如果计算结果超出系统日期范围，则返回 null。
+
+语法
+--
+
+```
+date_sub(date, int)
+```
+
+参数
+----
+
+* `date`: 需要进行日期计算的日期，类型为 date。
+* `int`: 需要加上或减去的天数，类型为整数。
+
+返回结果
+-------
+
+返回一个新的日期值，类型为 date。
+
+示例
+----
+
+以下示例展示了如何使用 DATE\_SUB 函数进行日期计算：
+
+1. 计算 2020 年 5 月 31 日 3 天前的日期：
+
+   ```
+   SELECT date_sub('2020-05-31', 3);
+   ```
+
+   结果：
+
+   ```
+   2020-05-28
+   ```
+
+
+2. 计算 2020 年 2 月 29 日前 1 天后的日期。
+
+   ```
+   SELECT date_sub('2020-02-29', 1);
+   ```
+
+   结果：
+
+   ```
+   2020-02-28
+   ```
+
+
+
+请注意，DATE\_SUB 函数仅适用于具有日期类型的列。如果输入的参数类型不正确，将返回错误。

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

@@ -0,0 +1,61 @@
+### DATE_TRUNC 函数
+```sql
+date_trunc(field, expr)
+```
+#### 功能描述
+DATE_TRUNC 函数用于将 timestamp 类型的数据按照指定的字段截断到特定的时间点。该函数能够根据不同的字段参数，将时间截断到年、季度、月、周、日、小时、分钟、秒、毫秒或微秒等不同级别。
+
+#### 参数说明
+* `field` (string 类型): 表示截断的时间单位，可选值有 'YEAR', 'QUARTER', 'MONTH', 'WEEK', 'DAY', 'HOUR', 'MINUTE', 'SECOND', 'MILLISECOND' 和 'MICROSECOND'，参数值不区分大小写。
+* `expr` (date/timestamp/timestamp_ltz/string 类型): 表示要进行截断操作的时间数据。
+
+#### 返回类型
+timestamp 类型。
+
+#### 使用示例
+1.  截断到指定年份的第一天（time 部分置零）：
+    ```sql
+   SELECT date_trunc('YEAR', '2022-03-26 16:24:52.656');
+   -- 返回结果：2022-01-01 00:00:00
+   ```
+2.  截断到指定季度的第一天（time 部分置零）：
+    ```sql
+   SELECT date_trunc('QUARTER', '2022-03-26 16:24:52.656');
+   -- 返回结果：2022-01-01 00:00:00
+   ```
+3.  截断到指定月份的第一天（time 部分置零）：
+    ```sql
+   SELECT date_trunc('MONTH', '2022-03-26 16:24:52.656');
+   -- 返回结果：2022-03-01 00:00:00
+   ```
+4.  截断到指定周的星期一（time 部分置零）：
+    ```sql
+   SELECT date_trunc('WEEK', '2022-03-26 16:24:52.656');
+   -- 返回结果：2022-03-21 00:00:00
+   ```
+5.  截断到指定日期（time 部分置零）：
+    ```sql
+   SELECT date_trunc('DAY', '2022-03-26 16:24:52.656');
+   -- 返回结果：2022-03-26 00:00:00
+   ```
+6.  截断到指定小时（minute、second 和毫秒部分置零）：
+    ```sql
+   SELECT date_trunc('HOUR', '2022-03-26 16:24:52.656');
+   -- 返回结果：2022-03-26 16:00:00
+   ```
+7.  截断到指定分钟（second 和毫秒部分置零）：
+    ```sql
+   SELECT date_trunc('MINUTE', '2022-03-26 16:24:52.656');
+   -- 返回结果：2022-03-26 16:24:00
+   ```
+8.  截断到指定秒（毫秒部分置零）：
+    ```sql
+   SELECT date_trunc('SECOND', '2022-03-26 16:24:52.656');
+   -- 返回结果：2022-03-26 16:24:52
+   ```
+
+
+
+#### 注意事项
+* 当 expr 参数为字符串类型时，确保字符串格式正确，否则可能导致函数执行失败。
+* 该函数对时间的截断操作不会改变原始时间数据，仅返回截断后的时间结果。

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

@@ -0,0 +1,60 @@
+### DATEADD 函数
+```
+timestampadd(unit, count, ts)
+dateadd(unit, count, ts)
+```
+#### 功能描述
+`TIMESTAMPADD` 的别名函数用于在给定的时间戳 `ts` 上增加或减少一定数量的指定时间单位 `unit`。如果 `count` 为正数，则表示增加；若为负数，则表示减少。
+
+可接受的时间单位 `unit` 包括（不区分大小写）：
+- MICROSECOND（微秒）
+- MILLISECOND（毫秒）
+- SECOND（秒）
+- MINUTE（分）
+- HOUR（时）
+- DAY（天）
+- DAYOFYEAR（一年中的第几天）
+- WEEK（周）
+- MONTH（月）
+- QUARTER（季度）
+- YEAR（年）
+
+#### 参数说明
+- `unit`: timestamp_ltz 类型，表示要添加的时间单位。
+- `count`: bigint 类型，表示要添加或减少的数量。
+- `ts`: timestamp_ltz 类型，表示当前时间戳。
+
+#### 返回类型
+返回一个新的 timestamp_ltz 类型的时间戳。
+
+#### 使用示例
+1. 增加 1 年：
+   ```sql
+   SELECT dateadd(YEAR, 1, '2020-10-10 01:02:03');
+   -- 结果：2021-10-10 01:02:03 
+   ```
+2. 减少 30 天：
+   ```sql
+   SELECT dateadd(DAY, -30, '2020-10-10 01:02:03');
+   -- 结果：2020-09-10 01:02:03
+   ```
+3. 增加 12 个小时：
+   ```sql
+   SELECT dateadd(HOUR, 12, '2020-10-10 01:02:03');
+   -- 结果：2020-10-10 13:02:03
+   ```
+4. 减少 3 个月：
+   ```sql
+   SELECT dateadd(MONTH, -3, '2020-10-10 01:02:03');
+   -- 结果：2020-07-10 01:02:03
+   ```
+5. 增加 2 毫秒：
+   ```sql
+   SELECT dateadd(MILLISECOND, 2, '2020-10-10 01:02:03.999');
+   -- 结果：2020-10-10 01:02:04.001
+   ```
+
+### 注意事项
+- 当处理时间戳时，确保传入的参数格式正确，否则可能导致函数执行失败。
+- 在进行时间单位转换时，注意闰年、月份天数等特殊情况，以免得到错误的结果。
+- 请根据实际需求选择合适的时间单位和增量，以避免不必要的时间误差。