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 Zeitzonen­angabe 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 Eingangs­wertes. 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 Datums­sprung ereignen, der sich unter Umständen auch auf den Wert der Monats­komponente 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