fn:minutes-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: Eine Ganzzahl vom Typ xs:integer, die dem Wert der Minu­tenkomponente des in normalisierte Form gebrachten, übergebenen Zeitwer­tes entspricht.

Aufruf/Argumente:

fn:minutes-from-time($zeitangabe)

$zeitangabe:
Optional. Eine Tageszeitangabe vom Typ xs:time, der eine Zeitzo­nenangabe beinhalten kann. Ist die Eingangssequenz leer, so gibt die Funktion die leere Sequenz zurück.

Verwendungszweck:

Rückgabewert ist eine Ganzzahl zwischen (inklu­sive) 0 und 59, die der Minutenkomponente des normalisierten Wertes ent­spricht.

Eine Normalisierung des Zeitwertes durch Einrechnung einer Zeitzonendiffe­renz hat in der Regel, da Zeitzonenangaben ganze Stunden zu umfassen pfle­gen, auf dessen Minutenkomponente keinen Einfluss.

Beispiele:

Beispiel 1 – Minutenkomponente aus Zeit:

fn:minutes-from-time(
           xs:time("13:00:00Z")
  )

ergibt 0.

Die Zeit liegt bereits in UTC-Zeit vor, sodass keine Normalisierung erforderlich ist (die hier ohnehin keine Auswirkung hätte). Die Minutenkomponente kann direkt extrahiert werden.

Beispiel 2 – Minutenkomponente aus Zeit:

fn:minutes-from-time(
           xs:time("21:35:00-5:00")
  )

ergibt 35.

In diesem Fall ist eine explizite Zeitzonenangabe vorhanden. Die Normalisie­rung wirkt sich jedoch nicht auf den Wert der Minutenkomponente aus.

Funktionsdefinition:

XPath 1.0:

Funktion nicht verfügbar

XPath 2.0:

fn:minutes-from-time($arg as xs:time?) as xs:integer?

   

<< zurück

vor >>