Partager via

Fonction ms:utc

  • Article

Convertit les valeurs de date/heure en heure UTC et en représentation fixe (normalisée) pouvant être triée et comparée lexicographiquement.

string ms:utc(string)

Notes

Cette fonction ne peut être utilisée qu'avec les instances de temps telles que timeInstant, time, date, yearMonth, year, monthDay, day et month. La fonction utc() ne peut pas être utilisée avec des durées telles que timeDuration ou des types dérivés. Pour les arguments autres que des chaînes, cette fonction agit comme si une fonction de chaîne avait d'abord été appliquée. Elle ne dépend pas de la présence des informations XSD. Si elle ne peut pas interpréter une chaîne comme un format XSD d'heure/date valide, elle retourne une chaîne vide. Les règles pour les valeurs de date/heure sont les suivantes :

  • Une chaîne est interprétée comme un format d'heure XSD et convertie au format suivant :

    AAAA-MM-JJ T HH:NN:SS.III

    où

    Caractères Représente

    AAAA

    Une année à quatre chiffres (par exemple, 2001).

    MM

    Le numéro correspondant au mois (par exemple, 01 pour janvier).

    JJJ

    Un jour du mois. Trois chiffres permettent de désigner le jour exact de l'année (par exemple, dans « 2001-04-123 », 123 fait référence au 123e jour de l'année).

    HH

    Une heure à deux chiffres (par exemple, « 00-23 »).

    SS

    Les secondes (par exemple, « 00-59 »).

    III

    Les millisecondes (par exemple, « 000-999 »). Si les millisecondes ne sont pas spécifiées, les traits d'union représentant les millisecondes sont tronqués à droite.

  • Pour les périodes négatives et les années au-delà de 9999, la fonction utc() retourne une chaîne vide parce que les instances de temps et les périodes négatives, les dates grégoriennes non valides ainsi que les autres cas décrits dans la section suivante relative aux contraintes de chaîne ne peuvent pas être comparés correctement.

  • Les champs indiquant une récurrence sont remplacés par un nombre identique de caractères « - ».

  • Les champs non spécifiés sont remplacés par des caractères « - ».

Contraintes relatives à la comparaison de chaînes :

  • La comparaison lexicographique ne fonctionne pas pour les ensembles mélangeant des dates avant et après Jésus-Christ et donne un résultat inverse pour les dates avant Jésus-Christ. Elle ne fonctionne pas non plus pour les années au-delà de 9999.

Voir aussi

Référence

Référence du schéma XML (XSD)
Référence des types de données XML