fn:hours-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 Stun­denkomponente innerhalb des übergebenen Zeitstempelwertes entspricht.

Aufruf/Argumente:

fn:hours-from-dateTime($zeitstempelwert)

$zeitstempelwert:
Optional. Ein Zeitstempelwert vom Typ xs:dateTime, der eine Zeitzonenangabe beinhalten kann. Wird die leere Sequenz übergeben, so gibt die Funktion eine ebenfalls leere Ausgabesequenz zurück.

Verwendungszweck:

Die Funktion gibt eine Ganzzahl zwischen ein­schließlich 0 bis 23 zurück, die dem Wert der Stundenkomponente des über­gebenen Zeitstempelwertes vom Typ xs:dateTime entspricht. Der Wert wird vorher normalisiert, d.h. der Zeitzonenfaktor mit einbezogen (siehe Beispiele). Dies kann einen Datumssprung zum Vor- oder Folgetag bewirken, sofern der normalisierte Tageszeitanteil auf Grund des Zeitzonenkorrekturfaktors den Wert T00:00:00 unter- oder den Wert T23:59:59 überschreitet. In diesem Fall wird ein anderer Wert als der möglicherweise erwartetete ausgegeben (siehe Beispiel 2).

Beispiele:

Beispiel 1 – Stunden aus Zeitstempelwert, Version 1:

fn:hours-from-dateTime(
         xs:dateTime("2007-07-10T10:20:00-05:00")
  )

ergibt 15.

Die Einrechnung des Zeitzonenkorrekturfaktors ergibt einen Stundenwert von 15. Ein Datumssprung findet hier nicht statt.

Beispiel 2 – Stunden aus Zeitstempelwert, Version 2:

fn:hours-from-dateTime(
         xs:dateTime("2007-07-10T21:30:00-05:00")
  )

ergibt 2.

In diesem Fall bewirkt der Korrekturfaktor der Zeitzone bei der Normalisierung einen Datumssprung zum Folgetag T02:30:00.

Beispiel 3 – Stunden aus Zeitstempelwert, Version 3:

fn:hours-from-dateTime(
         xs:dateTime("2007-07-10T12:00:00")
  )

ergibt 17.

Bei einem angenommenen impliziten Zeitzonenfaktor von -5:00 ergibt sich hier der Wert 17 durch Subtraktion des entsprechenden Korrekturfaktors von -5:00 aus 12 -(-5:00).

Funktionsdefinition:

XPath 1.0:

Funktion nicht verfügbar

XPath 2.0:

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

   

<< zurück

vor >>