fn:minutes-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 Ganzzahl vom Typ xs:integer, die dem Wert der Minutenkomponente des in normalisierte Form gebrachten übergebenen Zeitstempelwertes xs:dateTime entspricht.

Aufruf/Argumente:

fn:minutes-from-dateTime($zeitstempel)

$zeitstempel:
Optional. Ein Zeitstempelwert vom Typ xs:dateTime, der eine Zeitzonenangabe beinhalten kann. Wird kein Wert übergeben, also die leere Sequenz, so gibt die Funktion diese zurück.

Verwendungszweck:

Rückgabewert ist eine Ganzzahl xs:integer zwischen (inklusive) 0 und 59, die der Minutenkomponente des normalisierten Wertes entspricht.

Eine Normalisierung des Zeitstempelwertes, also eine Einrechnung der Zeitdauer der Zeitzonendifferenz, hat in der Regel auf die Minutenkomponente keinen Einfluss, da Zeitzonenangaben ganze Stunden zu umfassen pflegen (in Beispiel 2 liegt eine konstruierte Ausnahme vor).

Beispiele:

Beispiel 1 – Minuten aus Zeitstempelwert, Version 1:

fn:minutes-from-dateTime(
           xs:dateTime("2007-05-31T13:20:00-05:00")
  )

ergibt 20.

Die Minutenkomponente wird direkt extrahiert. Die Normalisierung hat keinen Einfluss, da die Zeitzonendifferenz nur den Stundenwert beeinflusst.

Beispiel 2 – Minuten aus Zeitstempelwert, Version 2:

fn:minutes-from-dateTime(
           xs:dateTime("1999-05-31T13:30:00+05:30")
  )

ergibt 0.

Hier wird ein fiktiver Zeitzonenkorrekturfaktor von +5 1/2 Stunden angenommen, dessen Subtraktion die Minutenkomponente zu 0 macht.

Funktionsdefinition:

XPath 1.0:

Funktion nicht verfügbar

XPath 2.0:

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

   

<< zurück vor >>
Tipp der data2type-Redaktion:
Zum Thema XSLT bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an:

Copyright © Galileo Press, Bonn 2008
Für Ihren privaten Gebrauch dürfen Sie die Online-Version ausdrucken.
Ansonsten unterliegt dieses Kapitel aus dem Buch "XSLT 2.0 & XPath 2.0 ― Das umfassende Handbuch" denselben Bestimmungen wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.


Galileo Press, Rheinwerkallee 4, 53227 Bonn