Format timestamp as string（将时间戳格式化为字符串（Format timestamp as string））¶

Supported in: Batch, Faster, Streaming

Returns the timestamp as a formatted string (ISO8601 by default).

Expression categories: Cast, Datetime, String

Declared arguments¶

Timestamp: The timestamp to convert to a string.
Expression\
optional Format: The format to use, defaults to ISO8601 with a zone offset.
Literal\
optional Time zone: Defaults to UTC.
TimeZone

Output type: String

Examples¶

Example 1: Base case¶

Argument values:

Timestamp: 2022-10-01T09:00:00Z
Format: yyyy-MM-dd
Time zone: null

Output: 2022-10-01

Example 2: Base case¶

Argument values:

Timestamp: 2022-10-01T09:00:00Z
Format: yyyy-MM-dd-HH-mm-ss
Time zone: BST

Output: 2022-10-01-15-00-00

Example 3: Base case¶

Argument values:

Timestamp: 2022-10-01T09:00:00Z
Format: yyyy-MM-dd-hh-mm-ssXXX
Time zone: CET

Output: 2022-10-01-11-00-00+02:00

Example 4: Base case¶

Argument values:

Timestamp: 2022-10-01T09:00:00Z
Format: yyyy-MM-dd-HH-mm-ss
Time zone: EST

Output: 2022-10-01-04-00-00

Example 5: Base case¶

Argument values:

Timestamp: 2022-10-01T09:00:00Z
Format: yyyy-MM-dd-hh-mm-ssXXX
Time zone: Europe/London

Output: 2022-10-01-10-00-00+01:00

Example 6: Base case¶

Argument values:

Timestamp: 2022-10-01T09:00:00Z
Format: yyyy-MM-dd-HH-mm-ss
Time zone: Etc/UTC

Output: 2022-10-01-09-00-00

Example 7: Null case¶

Argument values:

Timestamp: null
Format: yyyy-MM-dd
Time zone: UTC

Output: null

Example 8: Edge case¶

Argument values:

Timestamp: 2022-10-01T15:00:01Z
Format: HH-mm XXXX
Time zone: EST

Output: 10-00 -0500

Example 9: Edge case¶

Argument values:

Timestamp: 2022-10-01T15:00:01Z
Format: HH-mm X
Time zone: EST

Output: 10-00 -05

Example 10: Edge case¶

Argument values:

Timestamp: 2022-10-01T15:00:01Z
Format: HH-mm X
Time zone: null

Output: 15-00 Z

Example 11: Edge case¶

Argument values:

Timestamp: 2022-10-01T15:00:01Z
Format: HH-mm O
Time zone: EST

Output: 10-00 GMT-5

Example 12: Edge case¶

Argument values:

Timestamp: 2022-10-01T15:00:01Z
Format: HH-mm-ss-SS
Time zone: null

Output: 15-00-01-00

Example 13: Edge case¶

Argument values:

Timestamp: 2022-10-01T15:00:01Z
Format: HH-mm v
Time zone: EST

Output: 10-00 -05:00

Example 14: Edge case¶

Argument values:

Timestamp: 2022-10-01T15:00:01Z
Format: HH-mm z
Time zone: EST

Output: 10-00 -05:00

Example 15: Edge case¶

Argument values:

Timestamp: 2022-10-01T09:00:00Z
Format: hh-mm-a
Time zone: null

Output: 09-00-AM

Example 16: Edge case¶

Argument values:

Timestamp: 2022-10-01T09:00:00Z
Format: KK-mm-a
Time zone: null

Output: 09-00-AM

Example 17: Edge case¶

Argument values:

Timestamp: 2022-10-01T15:00:00Z
Format: kk-mm-a
Time zone: null

Output: 15-00-PM

Example 18: Edge case¶

Argument values:

Timestamp: 2022-10-01T15:00:00Z
Format: HH-mm-a
Time zone: null

Output: 15-00-PM

Example 19: Edge case¶

Argument values:

Timestamp: 2022-10-01T15:00:01Z
Format: HH-mm xxxx
Time zone: EST

Output: 10-00 -0500

Example 20: Edge case¶

Argument values:

Timestamp: 2022-10-01T15:00:01Z
Format: HH-mm x
Time zone: EST

Output: 10-00 -05

Example 21: Edge case¶

Argument values:

Timestamp: 2022-10-01T15:00:01Z
Format: HH-mm x
Time zone: null

Output: 15-00 +00

Example 22: Edge case¶

Argument values:

Timestamp: 2022-10-01T15:00:01Z
Format: HH-mm Z
Time zone: EST

Output: 10-00 -0500

中文翻译¶

将时间戳格式化为字符串（Format timestamp as string）¶

支持：批处理（Batch）、快速处理（Faster）、流处理（Streaming）

将时间戳返回为格式化字符串（默认采用 ISO8601 格式）。

表达式类别： 类型转换（Cast）、日期时间（Datetime）、字符串（String）

声明的参数（Declared arguments）¶

Timestamp（时间戳）： 要转换为字符串的时间戳。
Expression\
可选 Format（格式）： 使用的格式，默认为带时区偏移的 ISO8601 格式。
Literal\
可选 Time zone（时区）： 默认为 UTC。
TimeZone

输出类型： String

示例¶

示例 1：基本情况¶

参数值：

Timestamp： 2022-10-01T09:00:00Z
Format： yyyy-MM-dd
Time zone： null

输出： 2022-10-01

示例 2：基本情况¶

参数值：

Timestamp： 2022-10-01T09:00:00Z
Format： yyyy-MM-dd-HH-mm-ss
Time zone： BST

输出： 2022-10-01-15-00-00

示例 3：基本情况¶

参数值：

Timestamp： 2022-10-01T09:00:00Z
Format： yyyy-MM-dd-hh-mm-ssXXX
Time zone： CET

输出： 2022-10-01-11-00-00+02:00

示例 4：基本情况¶

参数值：

Timestamp： 2022-10-01T09:00:00Z
Format： yyyy-MM-dd-HH-mm-ss
Time zone： EST

输出： 2022-10-01-04-00-00

示例 5：基本情况¶

参数值：

Timestamp： 2022-10-01T09:00:00Z
Format： yyyy-MM-dd-hh-mm-ssXXX
Time zone： Europe/London

输出： 2022-10-01-10-00-00+01:00

示例 6：基本情况¶

参数值：

Timestamp： 2022-10-01T09:00:00Z
Format： yyyy-MM-dd-HH-mm-ss
Time zone： Etc/UTC

输出： 2022-10-01-09-00-00

示例 7：空值情况¶

参数值：

Timestamp： null
Format： yyyy-MM-dd
Time zone： UTC

输出： null

示例 8：边界情况¶

参数值：

Timestamp： 2022-10-01T15:00:01Z
Format： HH-mm XXXX
Time zone： EST

输出： 10-00 -0500

示例 9：边界情况¶

参数值：

Timestamp： 2022-10-01T15:00:01Z
Format： HH-mm X
Time zone： EST

输出： 10-00 -05

示例 10：边界情况¶

参数值：

Timestamp： 2022-10-01T15:00:01Z
Format： HH-mm X
Time zone： null

输出： 15-00 Z

示例 11：边界情况¶

参数值：

Timestamp： 2022-10-01T15:00:01Z
Format： HH-mm O
Time zone： EST

输出： 10-00 GMT-5

示例 12：边界情况¶

参数值：

Timestamp： 2022-10-01T15:00:01Z
Format： HH-mm-ss-SS
Time zone： null

输出： 15-00-01-00

示例 13：边界情况¶

参数值：

Timestamp： 2022-10-01T15:00:01Z
Format： HH-mm v
Time zone： EST

输出： 10-00 -05:00

示例 14：边界情况¶

参数值：

Timestamp： 2022-10-01T15:00:01Z
Format： HH-mm z
Time zone： EST

输出： 10-00 -05:00

示例 15：边界情况¶

参数值：

Timestamp： 2022-10-01T09:00:00Z
Format： hh-mm-a
Time zone： null

输出： 09-00-AM

示例 16：边界情况¶

参数值：

Timestamp： 2022-10-01T09:00:00Z
Format： KK-mm-a
Time zone： null

输出： 09-00-AM

示例 17：边界情况¶

参数值：

Timestamp： 2022-10-01T15:00:00Z
Format： kk-mm-a
Time zone： null

输出： 15-00-PM

示例 18：边界情况¶

参数值：

Timestamp： 2022-10-01T15:00:00Z
Format： HH-mm-a
Time zone： null

输出： 15-00-PM

示例 19：边界情况¶

参数值：

Timestamp： 2022-10-01T15:00:01Z
Format： HH-mm xxxx
Time zone： EST

输出： 10-00 -0500

示例 20：边界情况¶

参数值：

Timestamp： 2022-10-01T15:00:01Z
Format： HH-mm x
Time zone： EST

输出： 10-00 -05

示例 21：边界情况¶

参数值：

Timestamp： 2022-10-01T15:00:01Z
Format： HH-mm x
Time zone： null

输出： 15-00 +00

示例 22：边界情况¶

参数值：

Timestamp： 2022-10-01T15:00:01Z
Format： HH-mm Z
Time zone： EST

输出： 10-00 -0500