fn:timezone-from-time

(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 Zeitangabe in Form eines Zeitdauerwertes vom Typ xs:dayTimeDuration.

Aufruf/Argumente:

fn:timezone-from-time($zeitwert)

$zeitwert:
Optional. Eine Tageszeitangabe vom Typ xs:time, der eine Zeitzo­nenangabe beinhalten kann. Wird kein Wert übergeben, also die leere Sequenz, so gibt die Funktion diese zurück.

Verwendungszweck:

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

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

Beispiel – Extraktion des Zeitzonenfaktors aus einer Zeitangabe:

fn:timezone-from-time( xs:time("13: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-time($arg as xs:time?)
            as xs:dayTimeDuration?

   

<< zurück

vor >>