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 über­gebenen 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, normalisier­ten 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, entspre­chend -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, entspre­chend -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 Folge­tages, 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