ms:utc-Funktion
Konvertiert Werte mit Bezug auf Datum/Uhrzeit in koordinierte Weltzeit (UTC – Coordinated Universal Time) und in eine feste (normalisierte) Darstellung, die lexikografisch sortiert und verglichen werden kann.
string ms:utc(string)
Hinweise
Diese Funktion wird ausschließlich mit Zeitinstanzen wie timeInstant, time, date, yearMonth, year, monthDay, day und month verwendet. Die utc()-Funktion wird nicht mit Zeiträumen wie timeDuration oder den davon abgeleiteten Typen verwendet. Bei Argumenten, die keine Zeichenfolge darstellen, verhält sich diese Funktion so, als wenn vorher eine string-Funktion angewendet worden wäre. Diese Funktion ist nicht vom Vorhandensein von XSD-Informationen abhängig. Wenn eine Zeichenfolge in XSD nicht als gültiges Format für Datum/Uhrzeit interpretiert werden kann, wird eine leere Zeichenfolge zurückgegeben. Folgende Regeln gelten für Datums-/Uhrzeitwerte:
Eine Zeichenfolge wird als zeitbezogenes XSD-Format interpretiert und in das folgende Format konvertiert:
JJJJ-MM-TT T HH:NN:SS.III
. Hierbei gilt:
Zeichen Bedeutung YYYY
Eine Jahresangabe mit vier Ziffern (z. B. 2001)
MM
Die Zahl eines Monats (z. B. 01 für Januar).
TTT
Der Tag eines Monats. Es werden drei Ziffern verwendet, damit die Möglichkeit besteht, den genauen Tag des Jahrs anzugeben (beispielsweise wird in "2001-04-123" mit 123 der 123. Tag des Jahrs angegeben).
HH
Die Stunde in zwei Ziffern (z. B. "00-23")
SS
Sekunden (z. B. "00-59")
III
Millisekunden (z. B. "000-999") Wenn keine Millisekunden angegeben sind, werden Bindestriche, die Millisekunden darstellen, rechts abgeschnitten.
Bei negativen Uhrzeit- und Jahresangaben über 9999 gibt die
utc()-Funktion eine leere Zeichenfolge zurück, da negative timeInstances, Zeiträume, ungültige gregorianische Datumsangaben und weitere Fälle, die im folgenden Abschnitt zu Zeichenfolgeneinschränkungen beschrieben werden, nicht ordnungsgemäß verglichen werden können.Felder, die Wiederholungen angeben, werden mit derselben Anzahl von "-" ersetzt.
Nicht definierte Felder werden durch "-" ersetzt.
Beschränkungen für Zeichenfolgenvergleiche:
- Lexikografische Vergleiche funktionieren nicht, wenn Datumsangaben n. Chr. und v. Chr. gemischt vorkommen. Für Datumsangaben vor unserer Zeitrechnung ergibt sich eine umgekehrte Reihenfolge. Lexikografische Vergleiche funktionieren nicht für Jahreszahlen, die größer als 9999 sind.