diff --git a/sql-reference/functions/functions-relational-db.md b/sql-reference/functions/functions-relational-db.md index d36b52842d6451fefc0ec5cfbcce2e82c788cf48..b3587dcd5f916d9cd7a9b3765cb77a2419112dae 100644 --- a/sql-reference/functions/functions-relational-db.md +++ b/sql-reference/functions/functions-relational-db.md @@ -292,6 +292,10 @@ id: functions-relational-db | timezone(timezone: string, timestamptz: timestamptz) → timestamp | 将 timestamptz 转换到指定时区,返回不带时区的 timestamp 类型。 | | timezone(timezone: string, timestamptz_string: string) → timestamp | 将 timestamptz 转换到指定时区,返回不带时区的 timestamp 类型。 | | timezone(timezone: string, timetz: timetz) → timetz | 将 timetz 转换到指定时区,返回新时区的 timetz 类型。 | +| to_timestamp(int) → timestamp | 将时间戳类型的数据转换为时间格式的数据,其中 int 数据类型的入参在 `[-9223372036854775808, -9223372036854775807]` 范围内。| +| to_timestamp(string) → timestamp | 将时间戳类型的数据转换为时间格式的数据,其中 string 数据类型的入参符合以下条件:
- 有效的十进制整数字符串
- 在 `[-9223372036854775808, -9223372036854775807]` 范围内
- 不包含任何非数字字符(除可选的负号以外) | +| to_timestamp(time string, format string) → timestamp | 根据指定的 format 格式,将 time 转换为指定时间精度的数据。目前,KWDB 支持毫秒、微秒、纳秒三种时间精度。
- YYYY-MM-DD HH24:MI:SS.MS:毫秒精度
- YYYY-MM-DD HH24:MI:SS.US:微秒精度
- YYYY-MM-DD HH24:MI:SS.NS:纳秒精度| +| to_timestamp(time timestamp, format string) → timestamp | 根据指定的 format 格式,将 time 转换为指定时间精度的数据。目前,KWDB 支持毫秒、微秒、纳秒三种时间精度。
- YYYY-MM-DD HH24:MI:SS.MS:毫秒精度
- YYYY-MM-DD HH24:MI:SS.US:微秒精度
- YYYY-MM-DD HH24:MI:SS.NS:纳秒精度 | | transaction_timestamp() → date | 返回当前事务的时间。该值基于事务开始时选择的时间戳,并且在整个事务中保持不变。此时间戳与并发事务的提交顺序无关。 | | transaction_timestamp() → timestamp | 返回当前事务的时间。该值基于事务开始时选择的时间戳,并且在整个事务中保持不变。此时间戳与并发事务的提交顺序无关。 | | transaction_timestamp() → timestamptz | 返回当前事务的时间。该值基于事务开始时选择的时间戳,并且在整个事务中保持不变。此时间戳与并发事务的提交顺序无关。 | diff --git a/sql-reference/functions/functions-ts-db.md b/sql-reference/functions/functions-ts-db.md index b4dacb3fc540abedbe7de212f4aee14207960ed6..19aee47c669eb593a4a60c2c48da99dbe10ea8b3 100644 --- a/sql-reference/functions/functions-ts-db.md +++ b/sql-reference/functions/functions-ts-db.md @@ -92,6 +92,10 @@ id: functions-ts-db | time_bucket_gapfill(timestamp_column: timestamptz, interval: STRING) → timestamptz | 时间桶函数,根据时间间隔对时间戳进行对齐,并填充缺失的时间戳行。该函数必须与 `GROUP BY` 配合使用。相关使用说明和示例,参见[插值查询](../../db-administration/data-query/ts-data-query.md#插值查询)。
`time_bucket_gapfill()` 函数也可以和 `interpolate()` 函数配合使用,填充缺失的时间戳行的同时对指定数据列进行补值。
参数说明:
- timestamp_column:时间戳列。
- interval:时间间隔,支持的单位包括纳秒、微秒、毫秒、秒、分、小时、天、周、月、年。目前,KWDB 不支持复合时间格式,如 `1d1h`。
各时间单位支持的输入格式如下所示:
- 纳秒:`ns`、`nsec`、`nsecs`、`nanosecond`、`nanoseconds`
- 微秒:`us` 、`usec`、`usecs`、`microsecond`、`microseconds`
- 毫秒:`ms`、`msec`、`msecs`、`millisecond`、`milliseconds`
- 秒:`s`、`sec`、`secs`、`second`、`seconds`
- 分:`m`、`min`、`mins`、`minute`、`minutes`
- 小时:`h`、`hr`、`hrs`、`hour`、`hours`
- 天:`d`、`day`、`days`
- 周:`w`、`week`、`weeks`
- 月:`mon`、`mons`、`month`、`months`
- 年:`y`、`yr`、`yrs`、`year`、`years` | | time_bucket_gapfill(timestamp_column: timestamp, interval: int8) → timestamp | 时间桶函数,根据时间间隔对时间戳进行对齐,并填充缺失的时间戳行。该函数必须与 `GROUP BY` 配合使用。相关使用说明和示例,参见[插值查询](../../db-administration/data-query/ts-data-query.md#插值查询)。
`time_bucket_gapfill()` 函数也可以和 `interpolate()` 函数配合使用,填充缺失的时间戳行的同时对指定数据列进行补值。
参数说明:
- timestamp_column:时间戳列。
- interval:时间间隔,支持的单位包括纳秒、微秒、毫秒、秒、分、小时、天、周、月、年。目前,KWDB 不支持复合时间格式,如 `1d1h`。
各时间单位支持的输入格式如下所示:
- 纳秒:`ns`、`nsec`、`nsecs`、`nanosecond`、`nanoseconds`
- 微秒:`us` 、`usec`、`usecs`、`microsecond`、`microseconds`
- 毫秒:`ms`、`msec`、`msecs`、`millisecond`、`milliseconds`
- 秒:`s`、`sec`、`secs`、`second`、`seconds`
- 分:`m`、`min`、`mins`、`minute`、`minutes`
- 小时:`h`、`hr`、`hrs`、`hour`、`hours`
- 天:`d`、`day`、`days`
- 周:`w`、`week`、`weeks`
- 月:`mon`、`mons`、`month`、`months`
- 年:`y`、`yr`、`yrs`、`year`、`years` | | time_bucket_gapfill(timestamp_column: timestamptz, interval: int8) → timestamptz | 时间桶函数,根据时间间隔对时间戳进行对齐,并填充缺失的时间戳行。该函数必须与 `GROUP BY` 配合使用。相关使用说明和示例,参见[插值查询](../../db-administration/data-query/ts-data-query.md#插值查询)。
`time_bucket_gapfill()` 函数也可以和 `interpolate()` 函数配合使用,填充缺失的时间戳行的同时对指定数据列进行补值。
参数说明:
- timestamp_column:时间戳列。
- interval:时间间隔,支持的单位包括纳秒、微秒、毫秒、秒、分、小时、天、周、月、年。目前,KWDB 不支持复合时间格式,如 `1d1h`。
各时间单位支持的输入格式如下所示:
- 纳秒:`ns`、`nsec`、`nsecs`、`nanosecond`、`nanoseconds`
- 微秒:`us` 、`usec`、`usecs`、`microsecond`、`microseconds`
- 毫秒:`ms`、`msec`、`msecs`、`millisecond`、`milliseconds`
- 秒:`s`、`sec`、`secs`、`second`、`seconds`
- 分:`m`、`min`、`mins`、`minute`、`minutes`
- 小时:`h`、`hr`、`hrs`、`hour`、`hours`
- 天:`d`、`day`、`days`
- 周:`w`、`week`、`weeks`
- 月:`mon`、`mons`、`month`、`months`
- 年:`y`、`yr`、`yrs`、`year`、`years` | +| to_timestamp(int) → timestamp | 将时间戳类型的数据转换为时间格式的数据,其中 int 数据类型的入参在 `[-9223372036854775808, -9223372036854775807]` 范围内。| +| to_timestamp(string) → timestamp | 将时间戳类型的数据转换为时间格式的数据,其中 string 数据类型的入参符合以下条件:
- 有效的十进制整数字符串
- 在 `[-9223372036854775808, -9223372036854775807]` 范围内
- 不包含任何非数字字符(除可选的负号以外) | +| to_timestamp(time string, format string) → timestamp | 根据指定的 format 格式,将 time 转换为指定时间精度的数据。目前,KWDB 支持毫秒、微秒、纳秒三种时间精度。
- YYYY-MM-DD HH24:MI:SS.MS:毫秒精度
- YYYY-MM-DD HH24:MI:SS.US:微秒精度
- YYYY-MM-DD HH24:MI:SS.NS:纳秒精度| +| to_timestamp(time timestamp, format string) → timestamp | 根据指定的 format 格式,将 time 转换为指定时间精度的数据。目前,KWDB 支持毫秒、微秒、纳秒三种时间精度。
- YYYY-MM-DD HH24:MI:SS.MS:毫秒精度
- YYYY-MM-DD HH24:MI:SS.US:微秒精度
- YYYY-MM-DD HH24:MI:SS.NS:纳秒精度 | | transaction_timestamp() → timestamp | 返回当前事务的时间。该值基于事务开始时选择的时间戳,并且在整个事务中保持不变。此时间戳与并发事务的提交顺序无关。 | | transaction_timestamp() → timestamptz | 返回当前事务的时间。该值基于事务开始时选择的时间戳,并且在整个事务中保持不变。此时间戳与并发事务的提交顺序无关。 |