fn:month-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 Wert der Monatskomponente des in normalisierte Form gebrachten, übergebenen Zeit­stempelwertes entspricht.

Aufruf/Argumente:

fn:month-from-dateTime($zeitstempelwert)

$zeitstempelwert:
Optional. Ein Zeitstempelwert vom Typ xs:dateTime, 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 Eingangs­wertes. Liegt eine implizite oder explizite Zeitzonenangabe vor, so wird der Wert vor Extraktion des Komponentenwertes entsprechend normalisiert.

Bei der Normalisierung kann sich durch die Verrechnung der Zeitzonendiffe­renz mit der Tageszeitkomponente des Wertes ein Datumssprung ereignen, der sich unter Umständen auch auf den Wert der Monatskomponente auswirkt (siehe Beispiel 2).

Beispiele:

Beispiel 1 – Monatskomponente aus Zeitstempelwert:

fn:month-from-dateTime(
         xs:dateTime("2007-07-30T14:30:00-05:00")
  )

ergibt 7.

Die Normalisierung des Wertes durch Abzug der Zeitzonendifferenz bewirkt keine Änderung der Tageskomponente (T14:30:00 -(-5:00) ergibt T19:30:00). Der Wert der Monatskomponente wird unverändert ausgegeben.

Beispiel 2 – Monatskomponente aus Zeitstempelwert, mit Datumssprung:

fn:month-from-dateTime(
         xs:dateTime("2007-12-31T19:20:00-05:00")
  )

ergibt 1.

Die Normalisierung (die der Subtraktion von -5:00 Stunden von der Tageszeit­komponente T20:00:00 entspricht) bewirkt einen Datumssprung zum Folge­tag auf den 1.1.2008, 01:00:00 – als Wert der Monatskomponente wird 1 aus­gegeben.

Funktionsdefinition:

XPath 1.0:

Funktion nicht verfügbar

XPath 2.0:

fn:month-from-dateTime($arg as xs:dateTime?) as xs:integer?

   

<< zurück

vor >>