fn:day-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 Tages­komponente innerhalb des übergebenen Datumswertes entspricht

Aufruf/Argumente:

fn:day-from-date($datumswert)

$datumswert:
Optional. Ein Datumswert vom Typ xs:date, der eine Zeitzonen­angabe beinhalten kann. Wird die leere Sequenz als Argument übergeben, so gibt die Funktion die leere Sequenz zurück.

Verwendungszweck:

Die Funktion gibt eine Ganzzahl xs:integer zurück, die dem Wert der Tageskomponente des übergebenen Datumswertes vom Typ xs:date entspricht. Der Wert wird vorher normalisiert, d.h., der Zeitzonenfaktor wird mit einbezogen (siehe Beispiele). Dies kann wegen der in einem Datumswert implizit vorhandenen Tageszeitangabe von T00:00:00 einen Datumssprung bewirken, falls der Korrekturfaktor subtrahiert werden muss. In diesem Fall wird ein anderer Wert als der möglicherweise erwartetete ausgegeben (siehe Beispiel 2). Die Funktion gibt prinzipiell nur Werte von einschließlich 1 bis 31 zurück – in anderen Fällen wäre der Eingabewert ungültig.

Beispiele:

Beispiel 1 – Tag aus Datum mit negativem Zeitzonenwert:

fn:day-from-date(
       xs:date("2007-07-25-05:00")
  )

gibt 25 zurück. Der negative Zeitzonenwert bewirkt in diesem Fall keinen Sprung des Datums.

Beispiel 2 – Tag aus Datum mit positivem Zeitzonenwert:

fn:day-from-date(
       xs:date("2007-08-01+05:00")
  )

gibt den Wert 31 zurück und nicht 1, wie vielleicht erwartet. Die positive Zeit­zone wird bei der Normalisierung subtrahiert und bewirkt einen Datums­sprung zum Vortag – hier zum 31. des Vormonats.

Funktionsdefinition:

XPath 1.0:

Funktion nicht verfügbar

XPath 2.0:

fn:day-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