@clickzetta/cz-cli-darwin-x64 0.3.1

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

@@ -0,0 +1,50 @@
+### DATEDIFF 函数
+
+#### 功能描述
+DATEDIFF 函数用于计算两个日期之间的时间差值。该函数支持多种时间单位，包括微秒（MICROSECOND）、毫秒（MILLISECOND）、秒（SECOND）、分（MINUTE）、小时（HOUR）、天（DAY）、周（WEEK）、月（MONTH）、季度（QUARTER）和年（YEAR）。
+
+#### 语法
+```
+DATEDIFF(unit, startTimestamp, endTimestamp)
+```
+或
+```
+DATEDIFF(endDate, startDate)
+```
+
+#### 参数说明
+- `unit` (字符串): 指定计算时间差值的单位，可选值包括：MICROSECOND, MILLISECOND, SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, QUARTER, YEAR。
+- `startTimestamp` (时间戳): 计算开始的时间戳。
+- `endTimestamp` (时间戳): 计算结束的时间戳。
+- `endDate` (日期): 计算结束的日期。
+- `startDate` (日期): 计算开始的日期。
+
+#### 返回结果
+返回一个整数，表示两个时间戳或日期之间的时间差值。
+
+#### 使用示例
+1. 计算两个日期之间的天数差：
+```sql
+SELECT DATEDIFF('2022-03-31', '2022-03-30'); -- 返回结果为 1
+```
+2. 计算两个时间戳之间的小时数差：
+```sql
+SELECT DATEDIFF(HOUR, '2022-03-31 00:00:00', '2022-03-30 06:00:00'); -- 返回结果为 -18
+```
+3. 计算两个时间戳之间的毫秒数差：
+```sql
+SELECT DATEDIFF(MILLISECOND, '2022-03-30 10:30:00', '2022-03-30 10:30:10'); -- 返回结果为 10000
+```
+4. 计算两个日期之间的季度数差：
+```sql
+SELECT DATEDIFF(QUARTER, '2022-01-15', '2022-10-20'); -- 返回结果为 3
+```
+5. 计算两个时间戳之间的分钟数差：
+```sql
+SELECT DATEDIFF(MINUTE, '2022-03-30 08:45:00', '2022-03-30 09:30:00'); -- 返回结果为 45
+```
+
+#### 注意事项
+- 当使用 DATEDIFF 函数计算时间戳之间的时间差时，请注意时间戳的格式必须正确。
+- 当使用日期参数时，请确保日期格式正确，否则可能导致计算结果不准确。
+- 在计算时间差时，请注意负数结果表示 `startTimestamp` 或 `startDate` 晚于 `endTimestamp` 或 `endDate`。

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

@@ -0,0 +1,61 @@
+### DATETIME PATTERNS
+
+#### 符号
+
+
+|符号|含义|格式|距离|
+|---|---|---|---|
+|**G**|era|text|AD; Anno Domini|
+|**y**|year|year|2020; 20|
+|**D**|day-of-year|number(3)|189|
+|**M**|month-of-year|month|7; 07; Jul; July|
+|**d**|day-of-month|number(2)|28|
+|**Q**|quarter-of-year|number/text|3; 03; Q3; 3rd quarter|
+|**a**|am-pm-of-day|am-pm|PM|
+|**h**|clock-hour-of-am-pm (1-12)|number(2)|12|
+|**K**|hour-of-am-pm (0-11)|number(2)|0|
+|**k**|clock-hour-of-day (1-24)|number(2)|0|
+|**H**|hour-of-day (0-23)|number(2)|0|
+|**m**|minute-of-hour|number(2)|30|
+|**s**|second-of-minute|number(2)|55|
+|**S**|fraction-of-second|fraction|978|
+|**V**|time-zone ID|zone-id|America/Los_Angeles; Z; -08:30|
+|**z**|time-zone name|zone-name|Pacific Standard Time; PST|
+|**O**|localized zone-offset|offset-O|GMT+8; GMT+08:00; UTC-08:00;|
+|**X**|zone-offset ‘Z’ for zero|offset-X|Z; -08; -0830; -08:30; -083015; -08:30:15;|
+|**x**|zone-offset|offset-x|+0000; -08; -0830; -08:30; -083015; -08:30:15;|
+|**Z**|zone-offset|offset-Z|+0000; -0800; -08:00;|
+|**’‘**|single quote|literal|’|
+
+
+#### 部分符号解释
+年份:
+- yyyy 四位数年份数字表示，例如 2022
+
+月份:
+- M 单位数月份数字表示，例如 3、12
+- MM 双位数月份表示，例如 03、12
+
+所在当月天数:
+- d 单位数当月日期表示，例如 5、20
+- dd 双位数当月日期表示，例如 05、20
+
+小时，24小时制:
+- H 单位数24小时制小时表示，例如 1、23
+- HH 双位数24小时制小时表示，例如 01、23
+
+分钟:
+- m 单位数分钟表示，例如 4、59
+- mm 双位数分钟表示，例如 04、59
+
+秒:
+- s 单位数秒钟表示，例如 8、59
+- ss 双位数秒钟表示，例如 08、59
+
+毫秒/微秒:
+- S 可以有 1-9 位，从左到右依次为 毫秒(3位)，微秒(3位)，纳秒(3位)。CZ 对于时间戳精度目前只支持微秒，因此在解析时间字符串时纳秒会被丢弃，生成时间字符串时纳秒部分则会置零。当 S 位数不足 9 位时，则会从右边开始降低精度。
+
+示例:
+- yyyy-MM-dd HH:mm:ss.SSSS: 2022-01-10 10:05:02.1232
+- yyyy/M/d H:m:s.SSSS: 2022/1/10 10:5:2.12
+- yyyy'你好世界yMdH'-MM-dd HH:mm:ss.SSSS: 2022你好世界yMdH-01-10 10:05:02.1232

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

@@ -0,0 +1,53 @@
+### DAY 函数
+
+```sql
+DAY(expr)
+```
+
+#### 功能描述
+
+`DAY` 函数用于从给定的日期或时间戳表达式 `expr` 中提取出所在月份的天数。该函数对于日期和时间戳类型的数据都能正常工作，返回整数值，表示一个月中的第几天。
+
+#### 参数说明
+
+* `expr`：`date` 或 `timestamp_ltz` 类型，表示输入的日期或时间戳。
+
+#### 返回结果
+
+返回一个整数，代表输入日期或时间戳所在月份的天数。
+
+#### 使用示例
+
+1. 从特定日期中提取天数：
+   ```sql
+   SELECT DAY('2022-03-31');
+   +---------------------+
+   | `DAY`('2022-03-31') |
+   +---------------------+
+   | 31                  |
+   +---------------------+
+   ```
+   结果将返回 31，表示 '2022-03-31' 是三月份的第 31 天。
+
+2. 从时间戳中提取天数并与其他操作结合：
+   ```sql
+   SELECT DAY(CURRENT_TIMESTAMP()) + 5 AS target_day;
+   +------------+
+   | target_day |
+   +------------+
+   | 26         |
+   +------------
+   ```
+
+3. 比较两个日期以确定它们是否在同一天：
+   ```sql
+   SELECT (DAY('2022-03-31') = DAY('2022-03-01')) AS is_same_day;
+   +-------------+
+   | is_same_day |
+   +-------------+
+   | false       |
+   +-------------+
+   ```
+   
+
+

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

@@ -0,0 +1,36 @@
+### DAYOFMONTH 函数
+#### 简介
+`DAY` 函数用于提取并返回给定日期表达式（`date` 或 `timestamp_ltz` 类型）在所属月份中的第几天，结果为整数类型。
+
+#### 语法
+```
+dayofmonth(expr)
+```
+#### 参数
+- `expr`：需要提取天数的日期或时间表达式，可以是字符串、时间戳等格式。
+
+#### 返回结果
+返回一个整数，表示输入表达式在所属月份中的第几天。
+
+#### 使用示例
+1. 从字符串类型日期中提取天数：
+```
+SELECT dayofmonth('2022-03-31'); -- 结果为：31
+```
+2. 从当前时间戳中提取天数：
+```
+SELECT dayofmonth(TIMESTAMP_LTZ '2022-08-15 03:21:00'); -- 结果为：15
+```
+3. 从字符串类型时间戳中提取天数：
+```
+SELECT dayofmonth('2022-09-01 10:30:20'); -- 结果为：1
+```
+4. 从当前时间戳中提取天数并添加前缀“000”：
+```
+SELECT '000' || dayofmonth(TIMESTAMP_LTZ '2022-10-20 14:45:30'); -- 结果为：00020
+```
+#### 注意事项
+- 确保输入的日期或时间表达式格式正确，否则可能导致函数无法正确执行。
+- 在处理字符串类型的时间表达式时，请注意字符串的格式与数据库支持的格式相匹配。
+
+通过使用 `DAY` 函数，您可以方便地从不同类型的日期表达式中提取天数，以便进行进一步的日期计算或数据展示。

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

@@ -0,0 +1,31 @@
+### 函数名称
+DAYOFWEEK
+
+### 功能描述
+`DAYOFWEEK` 函数用于计算并返回给定日期或时间表达式（`expr`）所在的星期几。返回的整数值表示星期几，其中 1 代表星期日，2 代表星期一，依此类推，直到 7 代表星期六。
+
+### 参数说明
+- `expr`: 输入的日期或时间表达式，可以是字符串、时间戳等格式。
+
+### 返回结果
+返回一个整数，表示星期几。1 代表星期日，2 代表星期一，...，7 代表星期六。
+
+### 使用示例
+1. 计算字符串类型日期的星期几：
+   ```sql
+   SELECT DAYOFWEEK('2022-03-31'); -- 结果为：5
+   ```
+   上述示例中，输入的日期为 2022 年 3 月 31 日，返回结果为 5，表示这一天是星期四。
+
+
+2. 计算特定时间戳的星期几：
+   ```sql
+   SELECT DAYOFWEEK(TIMESTAMP "2022-04-01 12:00:00"); -- 结果为：6
+   ```
+   在这个示例中，输入的时间戳表示 2022 年 4 月 1 日中午 12 点，返回结果为 6，表示这一天是星期五。
+
+### 注意事项
+- 确保输入的日期或时间表达式格式正确，否则可能导致计算结果不准确。
+- 该函数仅适用于日期或时间类型的数据，对于其他类型的数据，将返回错误结果。
+
+通过以上示例和说明，您可以更好地理解和使用 `DAYOFWEEK` 函数来计算给定日期或时间所在的星期几。

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

@@ -0,0 +1,56 @@
+### DAYOFWEEK\_ISO 函数
+
+```
+dayofweek_iso(expr)
+```
+
+#### 功能描述
+
+`DAYOFWEEK_ISO` 函数用于计算并返回给定日期（`date` 或 `timestamp_ltz` 类型）在所属星期的第几天（以整数表示）。星期一对应数字 1，星期日对应数字 7。
+
+#### 参数说明
+
+* `expr`：输入的日期或时间戳。该参数接受 `date` 或 `timestamp_ltz` 类型的值。
+
+#### 返回结果
+
+返回一个整数，表示给定日期在所属星期的第几天。返回结果的范围是 1 到 7，其中 1 表示星期一，2 表示星期二，依此类推，直到 7 表示星期日。
+
+#### 使用示例
+
+1. 计算当前日期是星期几：
+
+```
+SELECT dayofweek_iso(CURRENT_TIMESTAMP());
+```
+
+2. 计算特定日期是星期几：
+
+```
+SELECT dayofweek_iso('2022-03-31');
++-----------------------------+
+| dayofweek_iso('2022-03-31') |
++-----------------------------+
+| 4                           |
++-----------------------------+
+```
+
+3. 计算一个时间戳是星期几：
+
+```
+SELECT dayofweek_iso(TIMESTAMP "2022-03-31 03:21:00");
++-----+
+| res |
++-----+
+| 4   |
++-----+
+```
+
+
+
+#### 注意事项
+
+* 请确保输入的日期或时间戳格式正确，否则可能导致函数无法正确执行。
+* 当输入的时间戳没有日期部分时（例如，只有时间），该函数将根据时间戳的时区信息计算所属星期的第几天。
+
+

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

@@ -0,0 +1,40 @@
+### 函数名称
+DAYOFYEAR
+
+### 功能描述
+`DAYOFYEAR` 函数用于计算并返回给定日期（日期时间）在所在年份中是第几天。该函数对于日期类型的数据特别有用，可以帮助用户快速了解特定日期在全年中的位置。
+
+### 参数说明
+- `expr`: 输入参数为 `date` 或 `timestamp_ltz` 类型的数据。
+
+### 返回结果
+返回一个整数，表示给定日期在所属年份的第几天。结果范围为 1 到 365（平年）或 366（闰年）。
+
+### 使用示例
+1. 计算当前日期是今年第几天：
+   ```sql
+   SELECT DAYOFYEAR(CURRENT_TIMESTAMP());
+   ```
+   结果将显示当前日期在当年中的天数。
+
+2. 计算某个特定日期是其年份的第几天：
+   ```sql
+   SELECT DAYOFYEAR('2023-02-10');
+   ```
+   结果将返回 41，表示 2023 年 2 月 10 日是当年的第 41 天。
+
+3. 计算不同年份的日期天数：
+   ```sql
+   SELECT DAYOFYEAR('2022-03-31'), DAYOFYEAR('2024-03-31');
+   ```
+   结果将返回两个整数，分别为 90（2022 年 3 月 31 日是当年的第 90 天）和 91（2024 年 3 月 31 日是当年的第 91 天，因为 2024 年是闰年）。
+
+4. 在查询中使用 `DAYOFYEAR` 函数与其他条件结合：
+   ```sql
+   SELECT * FROM orders WHERE DAYOFYEAR(order_date) BETWEEN 100 AND 120;
+   ```
+   此查询将返回 `order_date` 在当年的第 100 天至第 120 天之间的所有订单记录。
+
+### 注意事项
+- 确保输入的日期格式正确，否则可能导致函数返回错误或意外的结果。
+- 当前年份的判断基于输入日期所在时区的系统时间。

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

@@ -0,0 +1,21 @@
+### DAYS
+```sql
+days(expr)
+```
+#### 功能
+返回从 epoch (1970-01-01 00:00:00) 到指定时间戳之间的天数。
+#### 参数
+* `expr`：date/timestamp_ltz/timestamp_ntz 类型的表达式。
+#### 返回结果
+* `bigint` 类型，表示从 epoch 开始的天数。
+#### 举例
+```sql
+> SELECT days(timestamp_ntz '1970-01-01 00:00:00');
+0
+
+> SELECT days(timestamp_ntz '2000-01-01 00:00:00');
+10957
+
+> SELECT days(timestamp_ntz '2020-08-09 03:04:05');
+18483
+```

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

@@ -0,0 +1,49 @@
+### 提取函数 (EXTRACT)
+
+#### 功能描述
+提取函数 `EXTRACT(field FROM source)` 用于从给定的 `source` 中提取指定的 `field` 值。该函数可以处理不同类型的日期时间表达式，包括字符串、时间戳等。
+
+#### 参数说明
+- `field` (关键词)：需要提取的日期时间字段，具体选项如下：
+  - `YEAR`, `(Y, YEARS, YR, YRS)` - 年份
+  - `QUARTER`, `(QTR)` - 季度 (1 - 4)
+  - `MONTH`, `(MON, MONS, MONTHS)` - 月份 (1 - 12)
+  - `WEEK`, `(W, WEEKS)` - 表示一年中的第几个星期。需要注意的是，星期的计算是以星期一为开始，每年的第一个星期是该年第一个包含四天或以上的星期。在 ISO 星期的计算体系中，1 月份的最初几天可能属于前一年的第 52 或 53 周；同理，12 月份的最后几天可能属于下一年的第 1 周。例如，2005-01-02 属于 2004 年的第 53 周，2012-12-31 属于 2013 年的第 1 周。
+  - `DAY`, `(D, DAYS)` - 所属月份的第几天 (1 - 31)
+  - `DAYOFWEEK`, `(DOW)` - 所属星期的第几天，1 对应星期日，7 对应星期六
+  - `DAYOFWEEK_ISO`, `(DOW_ISO)` - 所属星期的第几天，基于ISO 8601标准，1 对应星期一，7 对应星期日
+  - `DAYOFYEAR`, `(DOY)` - 在所属年份的第几天 (1 - 365/366)
+  - `HOUR`, `(H, HOURS, HR, HRS)` - 小时 (0 - 23)
+  - `MINUTE`, `(M, MIN, MINS, MINUTES)` - 分钟 (0 - 59)
+  - `SECOND`, `(S, SEC, SECONDS, SECS)` - 秒 (0 - 59)
+- `source` (日期/时间戳)：输入的日期时间表达式，可以是字符串、时间戳等。
+
+#### 返回结果
+返回结果为整数（int）。
+
+#### 使用示例
+以下为 `EXTRACT` 函数的使用示例：
+
+```sql
+-- 从字符串类型的时间戳中提取年份
+SELECT EXTRACT(YEAR FROM TIMESTAMP '2019-08-12 01:00:00.123456');
+-- 结果：2019
+
+-- 从字符串类型的时间戳中提取一年中的第几个星期
+SELECT EXTRACT(WEEK FROM TIMESTAMP '2019-08-12 01:00:00.123456');
+-- 结果：33
+
+-- 从字符串类型的日期中提取所属月份的第几天
+SELECT EXTRACT(DAY FROM DATE '2019-08-12');
+-- 结果：12
+
+-- 从当前时间戳中提取季度
+SELECT EXTRACT(QUARTER FROM CURRENT_TIMESTAMP());
+-- 结果：取决于当前日期
+
+-- 从字符串类型的日期中提取所属星期的第几天（基于ISO 8601标准）
+SELECT EXTRACT(DAYOFWEEK_ISO FROM DATE '2019-08-12');
+-- 结果： 1 
+```
+
+通过以上示例，可以看到 `EXTRACT` 函数在不同场景下的应用。该函数可以方便地从各种输入格式中提取所需的日期时间字段，便于进行进一步的数据分析和处理。

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

@@ -0,0 +1,43 @@
+### FROM_UNIXTIME 函数
+```
+from_unixtime(unixTime [, fmt])
+```
+#### 功能描述
+FROM_UNIXTIME 函数用于将 UNIX 时间戳（以秒为单位）转换为当前时区下的日期时间字符串。如果提供了可选的 fmt 参数，函数会按照指定的格式返回日期时间字符串。若未提供 fmt 参数，则默认按照 'yyyy-MM-dd HH:mm:ss' 格式返回。
+
+#### 参数说明
+- `unixTime` (bigint): 表示 UNIX 时间戳，单位为秒。
+- `fmt` (string, 可选): 日期时间格式化字符串，具体格式参考下文。
+
+#### 返回结果
+返回一个字符串类型的日期时间值。
+
+#### 使用说明
+- 当 `fmt` 参数为空或未提供时，默认使用 'yyyy-MM-dd HH:mm:ss' 格式。
+- `fmt` 参数支持的格式化字符如下：
+  - `yyyy`: 年份（四位数字）
+  - `M`: 月份（两位数字，01-12）
+  - `MM`: 月份（两位数字，01-12，带前导零）
+  - `dd`: 日期（两位数字，01-31）
+  - `HH`: 小时（两位数字，00-23）
+  - `mm`: 分钟（两位数字，00-59）
+  - `ss`: 秒（两位数字，00-59）
+
+#### 示例
+- 示例 1：将 UNIX 时间戳 0 转换为默认格式的日期时间字符串。
+  ```sql
+  SELECT from_unixtime(0);
+  -- 结果：1970-01-01 08:00:00
+  ```
+- 示例 2：将 UNIX 时间戳 1617184000 转换为 'yyyy-MM-dd' 格式的日期字符串。
+  ```sql
+  SELECT from_unixtime(1617184000, 'yyyy-MM-dd');
+  -- 结果：2021-03-31
+  ```
+- 示例 3：将 UNIX 时间戳 1617184000 转换为自定义格式的日期时间字符串。
+  ```sql
+  SELECT from_unixtime(1617184000, 'yyyy年MM月dd日 HH时mm分ss秒');
+  -- 结果：2021年03月31日 00时00分00秒
+  ```
+
+通过以上示例，您可以灵活地使用 FROM_UNIXTIME 函数将 UNIX 时间戳转换为所需的日期时间格式。

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

@@ -0,0 +1,45 @@
+### FROM_UTC_TIMESTAMP 函数
+```sql
+from_utc_timestamp(expr, timeZone)
+```
+#### 功能描述
+FROM_UTC_TIMESTAMP 函数用于将一个表示 UTC 时间的 timestamp 类型数据 `expr` 转换为指定时区 `timeZone` 的本地时间戳。
+
+#### 参数说明
+- `expr`: 表示 UTC 时间的 timestamp 类型数据。
+- `timeZone`: 目标时区，以字符串形式表示。
+
+#### 返回结果
+转换后的本地时间戳，类型为 timestamp_ltz。
+
+#### 使用示例
+1. 将 UTC 时间 '1970-01-01' 转换为北京时间：
+```sql
+SELECT from_utc_timestamp('1970-01-01', 'Asia/Shanghai');
+```
+结果：
+```
+1970-01-01 08:00:00
+```
+2. 将多个 UTC 时间戳转换为美国东部时间：
+```sql
+SELECT from_utc_timestamp('2022-01-01 03:21:00', 'America/New_York');
+SELECT from_utc_timestamp('2022-02-01 03:21:00', 'America/New_York');
+```
+结果：
+```
+2021-12-31 22:21:00 
+2022-01-31 22:21:00    
+```
+3. 将当前 UTC 时间转换为澳大利亚悉尼时间：
+```sql
+SELECT from_utc_timestamp(current_timestamp(), 'Australia/Sydney');
+```
+结果：
+```
+2024-04-08 06:32:21 (示例时间，具体结果可能因实际时间而有所不同)
+```
+#### 注意事项
+- 确保输入的时间戳格式正确，否则可能导致转换失败。
+- 时区字符串应使用标准的时区表示方法，如 'Asia/Shanghai' 或 'America/New_York'。如果时区字符串不正确，可能导致转换结果不符合预期。
+- 转换过程中，请注意夏令时的影响。部分国家和地区会在特定时期实行夏令时，这可能会导致时间有所偏差。

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

@@ -0,0 +1,49 @@
+### HOUR 函数
+
+#### 简介
+HOUR 函数用于从给定的 timestamp 类型表达式中提取小时部分。该函数对于处理时间数据和计算时间间隔等场景非常有用。
+
+#### 语法
+```sql
+hour(timestamp_ltz) 
+```
+
+#### 参数
+- `timestamp_ltz`: 表示待提取小时部分的 timestamp 类型表达式。
+
+#### 返回结果
+返回一个整数，表示输入表达式的小时部分。
+
+#### 使用示例
+
+1. 从当前时间戳中提取小时部分：
+```sql
+SELECT hour( NOW());
+```
+这将返回当前时间的小时部分。
+
+2. 从指定时间戳中提取小时部分：
+```sql
+SELECT hour(TIMESTAMP  '2022-01-01 10:00:00');
+```
+这将返回 10，表示指定时间的小时部分。
+
+3. 从一个包含时间戳的表中提取小时部分：
+假设我们有一个名为 `orders` 的表，其中包含一个名为 `order_time` 的 timestamp 类型列。我们可以提取每个订单的小时部分，如下所示：
+```sql
+SELECT order_id, hour(order_time) as hour
+FROM orders;
+```
+这将返回 `orders` 表中每个订单的 ID 和小时部分。
+
+4. 与其他时间函数结合使用：
+```sql
+SELECT order_id, 
+       hour(order_time) as hour, 
+       day(order_time) as day, 
+       month(order_time) as month
+FROM orders;
+```
+这将返回 `orders` 表中每个订单的 ID、小时部分、日和月份。
+
+通过以上示例，您可以看到 HOUR 函数在处理时间数据时的灵活性和实用性。使用 HOUR 函数可以帮助您更轻松地从时间戳中提取所需的小时部分，以便进行进一步的分析和计算。

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

@@ -0,0 +1,21 @@
+### HOURS
+```sql
+hours(expr)
+```
+#### 功能
+返回从 epoch (1970-01-01 00:00:00) 到指定时间戳之间的小时数。
+#### 参数
+* `expr`: date/timestamp_ltz/timestamp_ntz 类型的表达式
+#### 返回结果
+* `bigint` 类型，表示从 epoch 开始的小时数。
+#### 举例
+```sql
+> SELECT hours(timestamp_ntz '1970-01-01 00:00:00');
+0
+
+> SELECT hours(timestamp_ntz '2000-01-01 00:00:00');
+262968
+
+> SELECT hours(timestamp_ntz '2020-08-09 03:04:05');
+443595
+```

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

@@ -0,0 +1,35 @@
+### LAST_DAY 函数
+#### 功能描述
+`LAST_DAY` 函数用于获取给定日期（`date` 类型）或时间戳（`timestamp_ltz` 类型）参数所在月份的最后一天。这个函数通常用于日期计算和报告生成，帮助用户快速确定某个日期所在的月份的结束日期。
+
+#### 参数说明
+- `expr`: 输入的日期或时间戳参数，类型为 `date` 或 `timestamp_ltz`。
+
+#### 返回结果
+返回一个 `date` 类型的结果，表示输入参数在当月的最后一天。
+
+#### 使用示例
+1. 确定普通日期的月末最后一天：
+   ```sql
+   SELECT LAST_DAY('2020-02-05'); -- 结果为 2020-02-29
+   ```
+2. 确定时间戳的月末最后一天：
+   ```sql
+   SELECT LAST_DAY(TIMESTAMP_LTZ "2020-02-05 12:00:00"); -- 结果为 2020-02-29
+   ```
+3. 计算闰年二月的最后一天：
+   ```sql
+   SELECT LAST_DAY('2020-02-05'); -- 结果为 2020-02-29
+   ```
+   在这个例子中，由于 2020 年是闰年，二月有 29 天，所以返回的是 2020-02-29。
+4. 对于非闰年的二月：
+   ```sql
+   SELECT LAST_DAY('2021-02-05'); -- 结果为 2021-02-28
+   ```
+   在这个例子中，2021 年不是闰年，所以二月的最后一天是 2021-02-28。
+
+#### 注意事项
+- 当输入的日期或时间戳参数为所在月份的最后一天时，`LAST_DAY` 函数将返回该日期或时间戳本身。
+- 在处理时间戳参数时，请注意时区的影响。`timestamp_ltz` 类型的时间戳不包含时区信息，因此在计算时可能会依赖系统或会话的当前时区设置。
+
+通过以上示例和说明，您可以更好地理解 `LAST_DAY` 函数的用途和用法，从而在实际工作中更有效地进行日期处理。

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

@@ -0,0 +1,19 @@
+### LOCALTIMESTAMP 函数
+```SQL
+LOCALTIMESTAMP（）
+```
+
+### 功能描述
+
+返回本地时间，返回类型为 `TIMESTAMP_NTZ`。
+
+### 案例
+
+```SQL
+select localtimestamp();
++---------------------+
+| `localtimestamp`()  |
++---------------------+
+| 2024-06-17 11:33:19 |
++---------------------+
+```

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

@@ -0,0 +1,20 @@
+### MAKE_DATE
+```sql
+make_date(year, month, day)
+```
+#### 功能
+根据年、月、日构造一个 date 类型的值。
+
+#### 参数
+* `year`: int
+* `month`: int
+* `day`: int
+
+#### 返回值
+date
+
+#### 示例
+```sql
+> SELECT make_date(2000, 2, 28);
+2000-02-28
+```

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

@@ -0,0 +1,20 @@
+### MAKE_DATE
+```sql
+make_date(year, month, day)
+```
+#### 功能
+根据年、月、日构造一个 date 类型的值。
+
+#### 参数
+* `year`: int
+* `month`: int
+* `day`: int
+
+#### 返回值
+date 类型
+
+#### 示例
+```sql
+> SELECT make_date(2000, 2, 28);
+2000-02-28
+```