From 8e8eddd2bd8cfab636c7d7f40f9f39782d2cbf4e Mon Sep 17 00:00:00 2001 From: meelahme Date: Tue, 29 Jul 2025 11:33:40 -0700 Subject: [PATCH 1/4] docs: fix from_unixtime return type description --- content/shared/sql-reference/functions/time-and-date.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/shared/sql-reference/functions/time-and-date.md b/content/shared/sql-reference/functions/time-and-date.md index befe2331d..0d8971674 100644 --- a/content/shared/sql-reference/functions/time-and-date.md +++ b/content/shared/sql-reference/functions/time-and-date.md @@ -887,7 +887,7 @@ LIMIT 1 Converts an integer to RFC3339 timestamp format (`YYYY-MM-DDT00:00:00.000000000Z`). Input is parsed as a [Unix nanosecond timestamp](/influxdb/version/reference/glossary/#unix-timestamp) -and returns the corresponding RFC3339 timestamp. +and returns the corresponding timestamp. ```sql from_unixtime(expression) @@ -1454,7 +1454,7 @@ SELECT tz(time, 'Australia/Sydney') AS time_tz, time FROM home ORDER BY time LIM differ when the input timestamp **does not** have a timezone. - When using an input timestamp that does not have a timezone (the default behavior in InfluxDB) with the - `AT TIME ZONE` operator, the operator returns the the same timestamp, but with a timezone offset + `AT TIME ZONE` operator, the operator returns the same timestamp, but with a timezone offset (also known as the "wall clock" time)--for example: ```sql From b812eacb038e238dffc3c2136b0582c84ecc3399 Mon Sep 17 00:00:00 2001 From: Jameelah Mercer <36314199+MeelahMe@users.noreply.github.com> Date: Fri, 1 Aug 2025 10:51:21 -0700 Subject: [PATCH 2/4] Update time-and-date.md Co-authored-by: Jason Stirnaman --- content/shared/sql-reference/functions/time-and-date.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/content/shared/sql-reference/functions/time-and-date.md b/content/shared/sql-reference/functions/time-and-date.md index 0d8971674..06c68a38e 100644 --- a/content/shared/sql-reference/functions/time-and-date.md +++ b/content/shared/sql-reference/functions/time-and-date.md @@ -885,8 +885,10 @@ LIMIT 1 ## from_unixtime -Converts an integer to RFC3339 timestamp format (`YYYY-MM-DDT00:00:00.000000000Z`). -Input is parsed as a [Unix nanosecond timestamp](/influxdb/version/reference/glossary/#unix-timestamp) +Converts an integer (Unix timestamp in seconds) to a timestamp value. +The underlying result is a timestamp (`Timestamp(TimeUnit::Second, None)`). +In query results, JSON, CSV, and "pretty" formats render the timestamp as an ISO 8601 string (`YYYY-MM-DDTHH:MM:SS`, without a timezone indicator). +When output to Parquet, the raw integer value (for example, `1641042000`) is preserved. and returns the corresponding timestamp. ```sql From dbbc1dd61ee3400a07b9d45b4abca27622ce643d Mon Sep 17 00:00:00 2001 From: Jameelah Mercer <36314199+MeelahMe@users.noreply.github.com> Date: Fri, 1 Aug 2025 10:51:38 -0700 Subject: [PATCH 3/4] Update time-and-date.md Co-authored-by: Jason Stirnaman --- content/shared/sql-reference/functions/time-and-date.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/shared/sql-reference/functions/time-and-date.md b/content/shared/sql-reference/functions/time-and-date.md index 06c68a38e..50ee54d25 100644 --- a/content/shared/sql-reference/functions/time-and-date.md +++ b/content/shared/sql-reference/functions/time-and-date.md @@ -889,7 +889,6 @@ Converts an integer (Unix timestamp in seconds) to a timestamp value. The underlying result is a timestamp (`Timestamp(TimeUnit::Second, None)`). In query results, JSON, CSV, and "pretty" formats render the timestamp as an ISO 8601 string (`YYYY-MM-DDTHH:MM:SS`, without a timezone indicator). When output to Parquet, the raw integer value (for example, `1641042000`) is preserved. -and returns the corresponding timestamp. ```sql from_unixtime(expression) From 49b24ba90d93963f462039843238f7c4c78ec9dd Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Fri, 1 Aug 2025 16:54:32 -0500 Subject: [PATCH 4/4] Update content/shared/sql-reference/functions/time-and-date.md --- content/shared/sql-reference/functions/time-and-date.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/shared/sql-reference/functions/time-and-date.md b/content/shared/sql-reference/functions/time-and-date.md index 50ee54d25..82738435a 100644 --- a/content/shared/sql-reference/functions/time-and-date.md +++ b/content/shared/sql-reference/functions/time-and-date.md @@ -887,7 +887,7 @@ LIMIT 1 Converts an integer (Unix timestamp in seconds) to a timestamp value. The underlying result is a timestamp (`Timestamp(TimeUnit::Second, None)`). -In query results, JSON, CSV, and "pretty" formats render the timestamp as an ISO 8601 string (`YYYY-MM-DDTHH:MM:SS`, without a timezone indicator). +If you output query results as JSON (default for the API), CSV, or pretty (default for the CLI), the timestamp is formatted as an ISO 8601 string (`YYYY-MM-DDTHH:MM:SS`, without a timezone indicator). When output to Parquet, the raw integer value (for example, `1641042000`) is preserved. ```sql