ms:utc 函式
將日期/時間的相關值轉換為 Coordinated Universal Time 及固定 (正規化) 的表示法,使其能夠進行字彙上的排序及比較。
string ms:utc(string)
備註
此函式只能與時間執行個體搭配運作,如 timeInstant、time、date、yearMonth、year、monthDay、day 與 month 等。utc()
函式不會與時段 (如 timeDuration) 或其衍生型別一起作業。對於非字串引數,此函式的作業方式如同先套用 string 函式的作業方式。無論是否有 XSD 資訊,此函式都可執行。若字串無法解譯為有效的 XSD 日期/時間相關格式,就會傳回空字串。日期/時間值的規則包括:
字串會解譯為與時間相關的 XSD 格式,並轉換為下列格式:
YYYY-MM-DD T HH:NN:SS.III
其中
字元 表示 YYYY
四位數的年份 (例如 2001)。
MM
月份數字 (例如 01 代表一月)。
DDD
一個月中的一天。使用三位數即可確切指出一年中的某一天 (例如,在 "2001-04-123" 中,123 表示一年中的第 123 天)。
HH
二位數的小時 (例如 "00-23")。
SS
秒 (例如 "00-59")。
III
毫秒 (例如 "000-999")。若未指定毫秒,則代表毫秒的破折號會向右截斷。
對於負值時間與超過 9999 的年份,
utc()
函式會傳回空字串,因為負值 timeInstances、期間、無效的西曆日期與其他在下列字串條件約束區段中所描述的情況,都將無法正確比較。表示循環的欄位會被相同數量的 "-" 字元取代。
未指定的欄位會被 "-" 字元取代。
字串比較條件約束:
- 混用 AC 與 BC 日期的組合無法進行字彙上的比較,而且 BC 日期的順序會相反。超過 9999 的年份無法進行字彙上的比較。