Apache DataFusion SQL Query Engine
minor: doc fixes for timestamp output format (#18315)
Jeffrey Vo8de8621aef98
diff --git a/datafusion/functions/src/datetime/to_local_time.rs b/datafusion/functions/src/datetime/to_local_time.rsindex a2a54398a3..6e0a150b0a 100644--- a/datafusion/functions/src/datetime/to_local_time.rs+++ b/datafusion/functions/src/datetime/to_local_time.rs@@ -69,11 +69,11 @@ use datafusion_macros::user_doc;FROM (SELECT '2024-04-01T00:00:20Z'::timestamp AT TIME ZONE 'Europe/Brussels' AS time);-+---------------------------+------------------------------------------------+---------------------+-----------------------------+-| time | type | to_local_time | to_local_time_type |-+---------------------------+------------------------------------------------+---------------------+-----------------------------+-| 2024-04-01T00:00:20+02:00 | Timestamp(Nanosecond, Some("Europe/Brussels")) | 2024-04-01T00:00:20 | Timestamp(Nanosecond, None) |-+---------------------------+------------------------------------------------+---------------------+-----------------------------+++---------------------------+----------------------------------+---------------------+--------------------++| time | type | to_local_time | to_local_time_type |++---------------------------+----------------------------------+---------------------+--------------------++| 2024-04-01T00:00:20+02:00 | Timestamp(ns, "Europe/Brussels") | 2024-04-01T00:00:20 | Timestamp(ns) |++---------------------------+----------------------------------+---------------------+--------------------+# combine `to_local_time()` with `date_bin()` to bin on boundaries in the timezone rather# than UTC boundariesdiff --git a/datafusion/functions/src/datetime/to_timestamp.rs b/datafusion/functions/src/datetime/to_timestamp.rsindex dcd52aa07b..0a07000977 100644--- a/datafusion/functions/src/datetime/to_timestamp.rs+++ b/datafusion/functions/src/datetime/to_timestamp.rs@@ -38,7 +38,7 @@ use datafusion_macros::user_doc;description = r#"Converts a value to a timestamp (`YYYY-MM-DDT00:00:00Z`). Supports strings, integer, unsigned integer, and double types as input. Strings are parsed as RFC3339 (e.g. '2023-07-20T05:44:00') if no [Chrono formats] are provided. Integers, unsigned integers, and doubles are interpreted as seconds since the unix epoch (`1970-01-01T00:00:00Z`). Returns the corresponding timestamp.-Note: `to_timestamp` returns `Timestamp(Nanosecond)`. The supported range for integer input is between `-9223372037` and `9223372036`. Supported range for string input is between `1677-09-21T00:12:44.0` and `2262-04-11T23:47:16.0`. Please use `to_timestamp_seconds` for the input outside of supported bounds.+Note: `to_timestamp` returns `Timestamp(ns)`. The supported range for integer input is between `-9223372037` and `9223372036`. Supported range for string input is between `1677-09-21T00:12:44.0` and `2262-04-11T23:47:16.0`. Please use `to_timestamp_seconds` for the input outside of supported bounds."#,syntax_example = "to_timestamp(expression[, ..., format_n])",sql_example = r#"```sqldiff --git a/docs/source/user-guide/sql/scalar_functions.md b/docs/source/user-guide/sql/scalar_functions.mdindex 0f091cb43e..d090b5b70c 100644--- a/docs/source/user-guide/sql/scalar_functions.md+++ b/docs/source/user-guide/sql/scalar_functions.md@@ -2749,11 +2749,11 @@ to_local_time(expression)FROM (SELECT '2024-04-01T00:00:20Z'::timestamp AT TIME ZONE 'Europe/Brussels' AS time);-+---------------------------+------------------------------------------------+---------------------+-----------------------------+-| time | type | to_local_time | to_local_time_type |-+---------------------------+------------------------------------------------+---------------------+-----------------------------+-| 2024-04-01T00:00:20+02:00 | Timestamp(Nanosecond, Some("Europe/Brussels")) | 2024-04-01T00:00:20 | Timestamp(Nanosecond, None) |-+---------------------------+------------------------------------------------+---------------------+-----------------------------+++---------------------------+----------------------------------+---------------------+--------------------++| time | type | to_local_time | to_local_time_type |++---------------------------+----------------------------------+---------------------+--------------------++| 2024-04-01T00:00:20+02:00 | Timestamp(ns, "Europe/Brussels") | 2024-04-01T00:00:20 | Timestamp(ns) |++---------------------------+----------------------------------+---------------------+--------------------+# combine `to_local_time()` with `date_bin()` to bin on boundaries in the timezone rather# than UTC boundaries@@ -2777,7 +2777,7 @@ FROM (Converts a value to a timestamp (`YYYY-MM-DDT00:00:00Z`). Supports strings, integer, unsigned integer, and double types as input. Strings are parsed as RFC3339 (e.g. '2023-07-20T05:44:00') if no [Chrono formats] are provided. Integers, unsigned integers, and doubles are interpreted as seconds since the unix epoch (`1970-01-01T00:00:00Z`). Returns the corresponding timestamp.-Note: `to_timestamp` returns `Timestamp(Nanosecond)`. The supported range for integer input is between `-9223372037` and `9223372036`. Supported range for string input is between `1677-09-21T00:12:44.0` and `2262-04-11T23:47:16.0`. Please use `to_timestamp_seconds` for the input outside of supported bounds.+Note: `to_timestamp` returns `Timestamp(ns)`. The supported range for integer input is between `-9223372037` and `9223372036`. Supported range for string input is between `1677-09-21T00:12:44.0` and `2262-04-11T23:47:16.0`. Please use `to_timestamp_seconds` for the input outside of supported bounds.```sqlto_timestamp(expression[, ..., format_n])