fn:month-from-date
(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 Wert der Monatskomponente des in normalisierte Form gebrachten, übergebenen Datumswertes entspricht.
Aufruf/Argumente:
fn:month-from-date($datumswert)
$datumswert:
Optional. Ein Datumswert vom Typ xs:date, der eine Zeitzonenangabe beinhalten kann. Ist die Eingangssequenz leer, so gibt die Funktion die leere Sequenz zurück.
Verwendungszweck:
Die Funktion gibt eine Ganzzahl zwischen 1 und 12 zurück, in Abhängigkeit vom Wert der Monatskomponente des Eingangswertes. Liegt eine implizite oder explizite Zeitzonenangabe vor, so wird der Wert vor Extraktion des Komponentenwertes entsprechend normalisiert.
Bei der Normalisierung kann sich bei positiver Zeitzonendifferenz ein Datumssprung ereignen, der sich unter Umständen auch auf den Wert der Monatskomponente auswirkt (siehe Beispiel 2).
Beispiele:
Beispiel 1 – Monatskomponente aus Datum:
fn:month-from-date(
xs:date("2007-07-30-05:00")
)
ergibt 7.
Die Normalisierung des Wertes bewirkt in diesem Fall keine Änderung der Tageskomponente. Der Wert der Monatskomponente wird entsprechend unverändert ausgegeben.
Beispiel 2 – Monatskomponente aus Datum, mit Datumssprung:
fn:month-from-date(
xs:date("2008-01-01+05:00")
)
ergibt 12.
Die Normalisierung (die der Subtraktion von +5:00 Stunden von der impliziten Tageszeitkomponente T00:00:00 entspricht) bewirkt einen Datumssprung zum Vortag auf den 31.12.2007, 19:00:00 – als Wert der Monatskomponente wird folgerichtig 12 ausgegeben.
Funktionsdefinition:
XPath 1.0:
Funktion nicht verfügbar
XPath 2.0:
fn:month-from-date($arg as xs:date?) 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