Hour (FPScript)
Ermittelt die Stunde des Tages eines oder mehrerer Kalenderzeit- oder Zeitspannenwerte.
Syntax
Hour(Time)
oder
Hour(Time, Timezone)
Die Syntax der Hour-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
|---|---|
Time |
Ist der Kalenderzeit- oder Zeitspannenwert, aus dem die Stunde extrahiert werden soll. Erlaubte Datenstrukturen sind Einzelwert, Datenreihe und Datenmatrix. Es sind alle reellen Datentypen erlaubt. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
Timezone |
Ist die Zeitzone, für die das Ergebnis ermittelt werden soll, als Zeitversatz zur Koordinierten Weltzeit (UTC) in Stunden. Wenn Sie das Argument weglassen, wird das Ergebnis in Lokalzeit ermittelt. Wenn Sie als Argument Time einen Zeitspannenwert angegeben haben, dann wird das Argument Timezone ignoriert. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind 16-Bit Ganzzahl, 32-Bit Ganzzahl, 64-Bit Ganzzahl, 32-Bit Fließkomma, 64-Bit Fließkomma und Zeitspanne. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
Anmerkungen
Der Datentyp des Ergebnisses ist immer 64-Bit Fließkomma.
Die Struktur des Ergebnisses entspricht der des Arguments Time, ggf. erfolgt die Berechnung elementweise.
Das Ergebnis hat die Einheit h.
Wenn das Argument keinen gültigen Kalenderzeitwert repräsentiert, dann wird ein ungültiger Fließkommawert ausgegeben.
Verfügbarkeit
FlexPro View, Basic, Professional, Developer Suite
Beispiele
Hour('9.2.04 12:30:00') |
Ergibt 12. |
Hour(-'12:30:00') |
Ergibt -12. |
Hour(1.25 d) |
Ergibt 6. Ein reeller Wert mit Zeiteinheit wird als Zeitspanne interpretiert. |
Hour(-300) |
Ergibt ?. Ein Zahlenwert ohne Einheit wird als Kalenderzeit interpretiert. |