fn:year-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 die Jahreszahl des normalisierten übergebenen Datumswertes darstellt.

Aufruf/Argumente:

fn:year-from-date($datumswert)

$datumswert:
Ein Datumswert vom Typ xs:date, aus dessen normalisierter Form die Jahresangabe extrahiert werden soll.

Verwendungszweck:

Die Funktion gibt eine Ganzzahl vom Typ xs:integer zurück, die der Jahreskomponente des übergebenen, normalisier­ten Datumswertes entspricht. Ein impliziter Zeitzonenfaktor wird, falls vorhan­den, eingerechnet. Ist der Eingabewert die leere Sequenz, so gibt die Funktion eine leere Ergebnissequenz zurück.

Beispiele:

Beispiel 1 – Extraktion des Jahrs aus einem Datumswert:

fn:year-from-date( xs:date("2007-05-31")
  )

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-date( xs:date("2008-01-01+05:00")
  )

ergibt den Wert 2007.

Hier wurde eine implizite Zeitzonenangabe von -5:00 angenommen, entspre­chend -PT5H0M. Bei der Normalisierung des Datumswertes wird der ursprüng­liche Zeitzonenfaktor subtrahiert und der neue addiert. Hier ergibt sich aus der impliziten Zeitangabe T00:00:00 – (+05:00) + (-05:00) ein Sprung auf T14:00:00 des Vortages, was einen Datumswechsel und damit die Ausgabe des Jahres 2007 bewirkt.

Funktionsdefinition:

XPath 1.0:

Funktion nicht verfügbar

XPath 2.0:

fn:year-from-date($arg as xs:date?) as xs:integer?

   

<< zurück

vor >>