Поделиться через

Функция ms:utc

  • Статья

Преобразует относящиеся к датам и времени значения в формат UTC и в фиксированное (нормализованное) представление, обеспечивающее возможность сортировки и лексикографического сопоставления.

string ms:utc(string)

Замечания

Эта функция работает только с такими типами данных, определяющими время, как timeInstant, time, date, yearMonth, year, monthDay, day и month. Функция utc() не работает с периодами времени, такими как timeDuration, и с производными типами. С нестроковыми аргументами эта функция предварительно применяет функцию string. Функция не полагается на наличие XSD-данных. При невозможности интерпретировать строку как допустимую строку, выражающую дату и время в формате XSD, функция возвращает пустую строку. К значениям даты и времени применяются следующие правила.

  • Строка интерпретируется как имеющий отношение к дате и времени XSD-формат и преобразуется в следующий формат:

    ГГГГ-ММ-ДД T ЧЧ:ММ:СС.РРР,

    где

    Символы Значение

    ГГГГ

    Год из четырех цифр (например, 2001).

    ММ

    Номер месяца (например, 01 для января).

    ДДД

    День месяца. Три разряда используются для указания точного дня года (например, в выражении «2001-04-123» 123 указывает на 123-й день года).

    ЧЧ

    Час из двух цифр (например, «00-23»).

    СС

    Секунды (например, «00-59»).

    РРР

    Миллисекунды (например, «000-999»). Если миллисекунды не указаны, дефисы, представляющие миллисекунды, усекаются справа.

  • При указании отрицательных значений времени и дат после 9999 года функция utc() возвращает пустую строку, поскольку отрицательные значения timeInstances, периоды, недопустимые даты по Грегорианскому календарю и другие значения, описанные в следующем разделе о строковых ограничениях, не допускают корректного сопоставления.

  • Поля, указывающие на повторение, заменяются тем же числом символов «-».

  • Неопределенные поля заменяются символами «-».

Ограничения на сравнение строк

  • Лексикографические сравнения невозможны для наборов смешанных дат нашей эры и до нашей эры и дают обратный порядок при использовании дат до нашей эры. Лексикографические сравнения невозможны для дат после 9999 года.

См. также

Справочник

Справочник по схемам XML (XSD)
Справочник по типам данных XML