共用方式為


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 的年份無法進行字彙上的比較。

另請參閱

參考

XML 結構描述 (XSD) 參考
XML 資料型別參考