toDuration

將引數值轉換為持續時間。 如需資料型別的詳細資訊,請參閱 此頁面.

類別

轉換

函式語法

toDuration(<parameter>)

參數

參數 說明
字串 以ISO-8601工期格式PnDTnHnMn.nS為基礎的格式,將天數視為24小時
整數 毫秒數

如果字串運算式:接受的格式是以ISO-8601期間格式PnDTnHnMn.nS為基礎,天數則視為24小時。

字串以選擇性符號開頭,以ASCII負號或正號表示。 如果為負值,則整個期間都會被否定。 ASCII字母「P」是下一個使用大寫或小寫字母的字母。 然後會有四個區段,每個區段都包含一個數字和一個尾碼。 區段的ASCII字尾為"D"、"H"、"M"及"S",分別代表日、時、分、秒,可採用大寫或小寫。 尾碼必須依序出現。 ASCII字母「T」必須在小時、分鐘或秒區段(若有的話)的第一次出現之前出現。 四個區段中的至少一個必須存在,如果存在「T」,則在「T」之後必須至少有一個區段。 每個區段的數字部分必須包含一個或多個ASCII數字。 數字可以以ASCII負號或正號為前置詞。 必須剖析的天數、小時數和分鐘數。 秒數必須剖析為以及可選的分數。 小數點可以是點或逗號。 分數部分可能有0到9位數。

簽章和傳回型別

toDuration(<string>)

toDuration(<integer>)

傳回持續時間。

範例

toDuration("PT10H")

傳回10小時的持續時間。

toDuration("PT4S")

傳回4秒的持續時間。

toDuration(4000)

傳回4秒的持續時間。

本頁內容