fn:seconds-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: Ein Dezimalwert xs:decimal, der dem Anteil der Sekunden und Sekundenbruchteile eines übergebenen Tageszeitwertes entspricht.

Aufruf/Argumente:

fn:seconds-from-time($zeitwert)

$zeitwert:
Optional. Eine Tageszeitangabe vom Typ xs:time, der eine Zeitzo­nenangabe 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 zurück (Achtung – nicht 59.99). Diese entspricht dem Wert der Sekunden­komponente und ihren Bruchteilen des übergebenen Zeitwertes. 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 (nähere Erläuterung: siehe fn:seconds-from-dateTime).

Beispiel – Extraktion der Sekunden aus einem Tageszeitwert:

fn:seconds-from-time(xs:time("15:30:12.67"))

ergibt den Wert 12.67.

Funktionsdefinition:

XPath 1.0:

Funktion nicht verfügbar

XPath 2.0:

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

   

<< zurück

vor >>