Time (FPScript)
Ermittelt Uhrzeit eines oder mehrerer Kalenderzeitwerte als Zeitspannenwert oder erzeugt einen Zeitspannenwert anhand der angegebenen Elemente.
Syntax
Time(CalendarTime)
oder
Time(CalendarTime, Timezone)
oder
Time(Hours, Minutes, Seconds)
oder
Time(Days, Hours, Minutes, Seconds)
Die Syntax der Time-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
|---|---|
CalendarTime |
Ist der Kalenderzeitwert, aus dem die Uhrzeit extrahiert werden soll. Wenn das Argument keinen gültigen Kalenderzeitwert repräsentiert, dann wird ein ungültiger Fließkommawert ausgegeben. Erlaubte Datenstrukturen sind Einzelwert, Datenreihe und Datenmatrix. Es sind alle reellen Datentypen erlaubt außer Zeitspanne. Das Argument wird auf die Einheit s transformiert. 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. 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. |
Days |
Ist die Anzahl der Tage der Zeitspanne. Erlaubte Datenstrukturen sind Einzelwert und Datenreihe. Es sind alle reellen Datentypen erlaubt. Das Argument wird auf die Einheit d transformiert. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
Hours |
Ist die Anzahl der Stunden der Zeitspanne. Erlaubte Datenstrukturen sind Einzelwert und Datenreihe. Es sind alle reellen Datentypen erlaubt. Das Argument wird auf die Einheit h transformiert. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
Minutes |
Ist die Anzahl der Minuten der Zeitspanne. Erlaubte Datenstrukturen sind Einzelwert und Datenreihe. Es sind alle reellen Datentypen erlaubt. Das Argument wird auf die Einheit min transformiert. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
Seconds |
Ist die Anzahl der Sekunden der Zeitspanne. Erlaubte Datenstrukturen sind Einzelwert und Datenreihe. Es sind alle reellen Datentypen erlaubt. Das Argument wird auf die Einheit s transformiert. 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 Zeitspanne.
Die Struktur des Ergebnisses entspricht der des Arguments CalendarTime, ggf. erfolgt die Berechnung elementweise.
Verfügbarkeit
FlexPro View, Basic, Professional, Developer Suite
Beispiele
Time('2.3.04 12:13:14') |
Ergibt '12:13:14'. |
Time(CurrentDate(), 0) |
Liefert die aktuelle Uhrzeit in Koordinierter Weltzeit. |
Time(12, 30, 45.6) |
Ergibt '12:30:45.6'. |
Time(12, -30, 45.6) |
Ergibt '11:30:45.6'. |
-Time(12, 30, 45.6) |
Ergibt -'12:30:45.6'. |
Time(-12, -30, -45.6) |
Ergibt -'12:30:45.6'. |
Time(3, 12, 30, 45.6) |
Ergibt '3:12:30:45.6'. |
Time(3 d, 12 h, 30 min, 45 ms) |
Ergibt '3:12:30:00.045'. |