fn:timezone-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: Die Zeitzonenkomponente einer Zeitstempelangabe in Form eines Zeitdauerwertes vom Typ xs:dayTimeDuration.

Aufruf/Argumente:

fn:timezone-from-dateTime($zeitstempelwert)

$zeitstempelwert:
Optional. Ein Wert vom Typ xs:dateTime, der einem Datumswert mit Tageszeitangabe entspricht, dessen Zeitzonenkompo­nente extrahiert werden soll.

Verwendungszweck:

Die Funktion extrahiert den Wert der Zeitzeitzo­nenabweichung von der UTC-Zeit eines übergebenen Zeitstempelwertes in Form eines Zeitdauerwertes vom Typ xs:dayTimeDuration.

Der ausgege­bene Wert kann sich im Intervall zwischen +14:00 (PT14H) bis -14:00 Stunden (-PT14H) bewegen. Wird die leere Sequenz übergeben, so gibt die Funktion eine leere Ergebnisseqeunz zurück.

Beispiel – Zeitzone aus Zeitstempelwert extrahieren:

fn:timezone-from-dateTime(
        xs:dateTime("2003-07-30T13:20:00-05:00")
  )

gibt den Wert -05:00 in Form von -PT5H als xs:dayTimeDuration zurück.

Funktionsdefinition:

XPath 1.0:

Funktion nicht verfügbar

XPath 2.0:

fn:timezone-from-dateTime($arg as xs:dateTime?)
            as xs:dayTimeDuration?

   

<< zurück

vor >>