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) 轉換爲 text 值。結果輸出可能因目前文化特性而有所不同。

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"