fn:year-from-dateTime
(Auszug aus "XSLT 2.0 & XPath 2.0" von Frank Bongers, Kapitel 5.)
A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z
Kategorie: Wertextraktion aus Zeitwerten, Datumswerten und Dauer
Herkunft: XPath 2.0
Rückgabewert: Eine Ganzzahl vom Typ xs:integer, die dem Jahr eines übergebenen Zeitstempelwertes nach seiner Normalisierung entspricht.
Aufruf/Argumente:
fn:year-from-dateTime($zeitstempelwert)
$zeitstempelwert:
Ein Zeitstempelwert vom Typ xs:dateTime, der einem Datumswert mit Tageszeitangabe entspricht, aus dem die Jahreskomponente extrahiert werden soll.
Verwendungszweck:
Die Funktion gibt eine Ganzzahl vom Typ xs:integer zurück, die der Jahreskomponente des übergebenen, normalisierten Zeitstempelwertes entspricht. Ein impliziter Zeitzonenfaktor wird, falls vorhanden, eingerechnet. Ist der Eingabewert die leere Sequenz, so gibt die Funktion eine leere Ergebnissequenz zurück.
Beispiele:
Beispiel 1 – Extraktion des Jahres aus einem Zeitstempelwert:
fn:year-from-dateTime(
xs:dateTime("2007-05-31T12:00:00-05:00")
)
ergibt den Wert 2007.
Hier wurde eine implizite Zeitzonenangabe von -5:00 angenommen, entsprechend -PT5H0M. Durch die Normalisierung ergibt sich beim ausgegebenen Jahr kein Unterschied. Dies kann jedoch – siehe folgendes Beispiel – in Grenzfällen anders sein.
Beispiel 2 – Datumswechsel durch Normalisierung:
fn:year-from-dateTime(
xs:dateTime("2007-12-31T19:30:00-05:00")
)
ergibt den Wert 2008.
Hier wurde eine implizite Zeitzonenangabe von -5:00 angenommen, entsprechend -PT5H0M. Bei der Normalisierung des Zeitstempelwertes wird der ursprüngliche Zeitzonenfaktor subtrahiert und der neue addiert. Hier ergibt sich aus T19:30:00 – (-05:00) + (-05:00) ein Sprung auf T00:30:00 des Folgetages, was einen Datumswechsel und damit die Ausgabe des Jahres 2008 bewirkt.
Funktionsdefinition:
XPath 1.0:
Funktion nicht verfügbar
XPath 2.0:
fn:year-from-dateTime($arg as xs:dateTime?) as xs:integer?
<< zurück | vor >> |
Tipp der data2type-Redaktion: Zum Thema XSLT bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an: |
Copyright © Galileo Press, Bonn 2008
Für Ihren privaten Gebrauch dürfen Sie die Online-Version ausdrucken.
Ansonsten unterliegt dieses Kapitel aus dem Buch "XSLT 2.0 & XPath 2.0 ― Das umfassende Handbuch" denselben Bestimmungen wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.
Galileo Press, Rheinwerkallee 4, 53227 Bonn