Time.ToText

语法

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

关于

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

  • Format:一个 text 值,指示要使用的格式。 有关更多详细信息,请转到 标准日期和时间格式字符串 以及 自定义日期和时间格式字符串。 省略此字段或提供 null 将导致使用由 Culture 定义的默认值设置日期的格式。

  • Culture:如果 Format 不为 null,则 Culture 会控制某些格式说明符。 例如,in "en-US" 是,而 in "tt""AM" or "PM""ar-EG""tt""ص" or "م"Formatnull 时,Culture 控制要使用的默认格式。 当 Culturenull 或被省略时,将使用 Culture.Current

若要支持旧工作流,optionsculture 也可以是文本值。 这与 options = [Format = options, Culture = culture] 具有相同的行为。

示例 1

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

使用情况

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

输出

"11:56 AM"

示例 2

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

使用情况

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

输出

"11:56"

示例 3

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

使用情况

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

输出

"11:56:02"