Time.ToText

返回时间值的文本表示形式。

Syntax

Time.ToText(
    time as time,
    optional options as any,
    optional culture as text
) as text

返回 time 的文本表示形式。可提供可选的 record 参数 options，用于指定其他属性。culture 仅用于旧版工作流。record 可包含以下字段:

Format: 指示要使用的格式的 text 值。要了解更多详细信息，请访问 https://go.microsoft.com/fwlink/?linkid=2180104 和 https://go.microsoft.com/fwlink/?linkid=2180105。省略此字段或提供 null 将导致使用 Culture 定义的默认值设置日期格式。
Culture: 如果 Format 不为 null，则 Culture 将控制某些格式说明符。例如，在 "en-US" 中，"tt" 是 "AM" 或 "PM"，而在 "ar-EG" 中，"tt" 是 "ص" 或 "م"。当 Format 为 null 时，Culture 会控制要使用的默认格式。当 Culture 为 null 或省略时，将使用 Culture.Current。

要支持旧版工作流，options 和 culture 也可以是文本值。此行为与 options = [Format = options, Culture = culture] 相同。

将 #time(01, 30, 25) 转换为文本值。结果输出可能因当前区域性而异。

Time.ToText(#time(11, 56, 2))

Result:

"11:56 AM"

使用自定义格式和德语区域性进行转换。

Time.ToText(#time(11, 56, 2), [Format="hh:mm", Culture="de-DE"])

Result:

"11:56"

使用标准时间格式进行转换。

Time.ToText(#time(11, 56, 2), [Format="T", Culture="de-DE"])

Result:

"11:56:02"