Condividi tramite

Funzione ms:utc

  • Articolo

Converte i valori relativi a data/ora in unità UTC e in una rappresentazione fissa (normalizzata) che può essere ordinata e confrontata a livello lessicografico.

string ms:utc(string)

Osservazioni

Questa funzione è consentita solo con istanze di tempo quali timeInstant, time, date, yearMonth, year, monthDay, day e month. La funzione utc() non può essere utilizzata con periodi di tempo quali timeDuration o i relativi tipi derivati. Per argomenti non di tipo stringa questa funzione si comporta come se venisse prima applicata una funzione string. La funzione non dipende dalla presenza di informazioni XSD. Se non è possibile interpretare una stringa come formato XSD valido relativo a data e ora, viene restituita una stringa vuota. Di seguito sono indicate le regole per i valori di data e ora.

  • Una stringa viene interpretata come formato XSD relativo al tempo e convertita nel seguente formato:

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

    dove

    Caratteri Valore rappresentato

    AAAA

    Un anno di quattro cifre (ad esempio 2001).

    MM

    Il numero di un mese (ad esempio 01 per indicare gennaio).

    GGG

    Un giorno del mese. Vengono utilizzate tre cifre per consentire di indicare il giorno esatto dell'anno (ad esempio, nella stringa "2001-04-123", 123 indica il 123° giorno dell'anno).

    HH

    Un'ora di due cifre (ad esempio "00-23").

    SS

    Secondi (ad esempio "00-59").

    III

    Millisecondi (ad esempio "000-999"). Se non sono specificati millisecondi, i trattini che rappresentano i millisecondi vengono troncati a destra.

  • Per le date/ore negative e gli anni oltre il 9999 la funzione utc() restituisce una stringa vuota perché istanze di tempo e periodi negativi, date del calendario gregoriano non valide e altri casi descritti nella successiva sezione relativa ai vincoli di stringa non consentono un confronto corretto.

  • I campi che indicano una data/ora ricorrente vengono sostituiti dallo stesso numero di caratteri "-".

  • I campi non specificati vengono sostituiti da caratteri "-".

Vincoli del confronto di stringhe:

  • Il confronto lessicografico non funziona per insiemi di date AC e DC miste e restituisce un ordine invertito per le date DC. Il confronto lessicografico non funziona per anni successivi al 9999.

Vedere anche

Riferimento

Riferimenti dello schema XML (XSD)
Riferimenti dei tipi di dati XML