fn:current-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: Kontextinformationen – Datum und Zeit

Herkunft: XPath 2.0

Rückgabewert: Der für den Auswertungskontext aktuelle Datumswert mit Tageszeitanteil im Format xs:dateTime

Aufruf/Argumente:

fn:current-dateTime()

Keine Argumente

Verwendungszweck:

Die Funktion fn:current-dateTime() wird ohne Übergabe eines Arguments aufgerufen. Der zurückgegebene Zeitstempelwert ist abhängig vom gültigen Kontext zum Zeitpunkt der Auswertung des betreffenden XPath-Ausdrucks.

Während einer XSLT-Transformation gibt die Funktion in der Regel einen Zeitstempelwert zurück, der aus Systemdatum und -zeit ermittelt wird. Der Wert kann die implizite Zeitzone als Zeitzonenangabe enthalten.

Die Funktion ist stabil (stable), gibt also während einer laufenden Transforma­tion einen gleich bleibenden Wert zurück.

Beispiele:

Beispiel 1 – Zeitstempelwert mit Zeitzone im Funktionskontext:

fn:current-dateTime() gibt zurück: 2007-07-10T20:48:10.553+12:00

Die Funktion gibt kontextabhängig den jeweils aktuellen Zeitstempelwert zurück – hier mit einer Zeitzonenangabe.

Beispiel 2 – Zeitstempelwert ohne Zeitzone im Funktionskontext:

fn:current-dateTime() gibt zurück: 2007-07-10T20:48:10.553Z

Ist keine implizite Zeitzone vorhanden, so wird der reine Zeitstempelwert zurückgegeben – in diesem Fall mit nachgestelltem Z.

Funktionsdefinition:

XPath 1.0:

Funktion nicht verfügbar

XPath 2.0:

fn:current-dateTime() as xs:dateTime

   

<< zurück

vor >>