fn:seconds-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 Dezimalzahl xs:decimal, die dem Wert der Sekunden und Sekundenbruchteile des übergebenen Zeitstempelwertes in dessen norma­lisierter Form entspricht.

Aufruf/Argumente:

fn:seconds-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 leere Ergebnissequenz zurück.

Verwendungszweck:

Die Funktion gibt eine Dezimalzahl zwischen 0 und 60.99 (nicht 59.99, siehe unten!) zurück, die dem Wert der Sekunden­komponente und ihren Bruchteilen des übergebenen Zeitstempelwertes ent­spricht. Der übergebene Wert muss formal normalisiert werden, d.h., eine implizit oder explizit vorhandene Zeitzonenangabe muss eingerechnet werden. Auf den Wert der Sekundenkomponente hat dies jedoch keinen Einfluss.

Der Wert kann theoretisch die Zahl von 60 Sekunden überschreiten, da gele­gentlich Schaltsekunden eingeschoben werden, um den offiziellen Zeitablauf den Unregelmäßigkeiten der Erdrotation anzupassen. Dies geschieht jedoch nur am 30. Juni oder 31. Dezember um 23:59:59 UTC. Ein Wert größer 60 tritt dementsprechend äußerst selten auf.

Erläuterung: Seit 1967 ist eine Sekunde als SI-Basiseinheit nicht mehr als Bruchteil eines Tages, sondern über eine Resonanz des Cäsium-Atoms definiert. Da die Erdrotation weniger gleichmäßig ist, sind zur Angleichung an die Stan­dardzeit sogenannte Schaltsekunden nötig, die in Deutschland von der Physi­kalisch-Technischen Bundesanstalt festgelegt werden. Dies geschieht in Über­nahme der international vom International Earth Rotation Service festgelegten Schaltsekunden. Im Mittel ist eine Anpassung einmal jährlich nötig. Eine Syn­chronisation von Rechnern mit der Standardzeit ermöglicht das Network Time Protocol NTP über entsprechende NTP-Server.

Beispiele:

Beispiel 1 – Sekunden aus Zeitstempelwert:

fn:seconds-from-dateTime(xs:dateTime("2007-07-20T13:34:45"))

ergibt 45. Der Wert der Sekundenkomponente kann unmittelbar entnommen werden.

Beispiel 2 – Sekunden aus Zeitstempelwert:

fn:seconds-from-dateTime(xs:dateTime("2007-07-20T13:34:45-05:00"))

ergibt 45. Die explizite Zeitzonenangabe erfordert im Prinzip eine Normalisie­rung, die sich hier allerdings nicht auf den Wert der Sekundenkomponente (wohl aber auf den der Stundenkomponente) auswirkt.

Funktionsdefinition:

XPath 1.0:

Funktion nicht verfügbar

XPath 2.0:

fn:seconds-from-dateTime($arg as xs:dateTime?)
                          as xs:decimal?

   

<< zurück

vor >>