ms:utc 函数
将与日期/时间有关的值转换为协调通用时间以及可以按字典序进行排序和比较的固定(标准化)显示。
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()
函数返回空字符串,因为负的 timeInstance、时间期限、无效公历日期以及以下字符串约束部分描述的其他情况将无法正确比较。指示重复的字段将替换为相同数目的“-”字符。
未指定的字段将替换为“-”字符。
字符串比较约束:
- 按字典序比较不适用于混合 AC 和 BC 日期的集合,对 BC 日期提供反序。 按字典序比较不适用于超过 9999 的年份。