Compartir a través de

Función ms:utc

  • Artículo

Convierte valores relacionados con la fecha y la hora en horario universal coordinado y en una representación fija (normalizada) que puede organizarse y compararse de manera lexicográfica.

string ms:utc(string)

Notas

Esta función solo trabaja con instancias de tiempo como timeInstant, time, date, yearMonth, year, monthDay, day y month. La función utc() no trabaja con periodos de tiempo como timeDuration o sus derivados. Para los argumentos que no son de cadena, esta función actúa como si se aplicase primero una función de cadena. Esta función no depende de la presencia de información XSD. Si una cadena no puede interpretarse como un formato XSD válido relacionado con la fecha y la hora, devuelve una cadena vacía. Las reglas para los valores de fecha y hora son:

  • Una cadena se interpreta como formato XSD relacionado con el tiempo y se convierte al siguiente formato:

    YYYY-MM-DD T HH:NN:SS.III

    donde

    Characters Representa

    YYYY

    Año expresado con cuatro dígitos (por ejemplo, 2001).

    MM

    El número del mes (por ejemplo, 01 corresponde a enero).

    DDD

    Un día del mes. Los tres dígitos se utilizan para albergar la capacidad de señalar un día concreto del año (por ejemplo, en "2001-04-123", 123 señala el día número 123 del año).

    HH

    Una hora expresada con dos dígitos (por ejemplo, "00-23").

    SS

    Segundos (por ejemplo, "00-59").

    III

    Milésimas de segundo (por ejemplo, "00-999"). Si no se especifican milésimas de segundos, se truncarán los guiones que representan estos valores.

  • En el caso de horas negativas y años posteriores a 9999, la función utc() devuelve una cadena vacía porque no podrá comparar correctamente instancias de tiempo negativas, periodos, fechas gregorianas no válidas y otros casos que se describen en la sección de limitaciones de cadenas.

  • Los campos que indican frecuencia se sustituyen por el mismo número de caracteres "-".

  • Los campos no especificados se sustituyen por caracteres "-".

Limitaciones de comparación de cadenas:

  • La comparación lexicográfica no funciona en el caso de conjuntos que mezclan fechas a. C. y d. C., y ofrece un orden inverso en el caso de las fechas a. C. La comparación lexicográfica no funciona en el caso de años posteriores a 9999.

Vea también

Referencia

Referencia de esquemas XML (XSD)
Referencia de tipos de datos XML