AbsoluteTime, AbsoluteTimeStrict
Wandelt Zeitdaten in Absolutzeit.
Syntax
AbsoluteTime[<Y|X|Z>] Ausdruck
oder
AbsoluteTimeStrict[<Y|X|Z>] Ausdruck
Die Syntax des AbsoluteTime-Operators besteht aus folgenden Teilen:
Teil |
Beschreibung |
|---|---|
Ausdruck |
Ein Datenobjekt oder ein Ausdruck, der Daten mit Kopfinformationen liefert. |
Anmerkungen
Die Wandlung in Absolutzeit erfolgt durch Addition des auf der Registerkarte Allgemein des Eigenschaften-Dialogfeldes des Datenobjektes angegebenen Zeitstempels für die zu wandelnde Datenkomponente.
Die Variante AbsoluteTimeStrict des Operators liefert während der Übersetzung der Formel einen Fehler, wenn Ausdruck ein FPScript-Ausdruck ist, der kein Datenobjekt liefert. Bei der Ausführung der Formel liefert diese Variante einen Fehler, wenn die entsprechende Komponente des Datenobjektes keinen Zeitstempel hat. Die Variante AbsoluteTime ignoriert beide Fehler und lässt das Argument dann unverändert.
Der Operator kann alle Datenstrukturen und reelle Datentypen verarbeiten. Listen werden elementweise verarbeitet. Wenn dem Operator eine Komponente angehängt wird, z. B. AbsoluteTime<X>, dann wird bei zusammengesetzten Datenstrukturen nur die entsprechende Komponente bearbeitet und die Daten der anderen Komponenten werden unverändert in das Ergebnis übernommen. Wird keine Komponente angehängt, dann werden alle Komponenten bearbeitet. Für nicht-zusammengesetzte Datenstrukturen ist AbsoluteTime<Y> äquivalent zu AbsoluteTime und AbsoluteTime<X> sowie AbsoluteTime<Z> haben keine Auswirkung.
Liegt die entsprechende Datenkomponente schon in Absolutzeit vor, d. h. hat den Datentyp Kalenderzeit, dann wird sie unverändert ins Ergebnis übernommen. Wenn der Operator für eine bestimmte Komponente angewandt wird und Ausdruck über keinen Zeitstempel für die zu konvertierende Komponente verfügt, dann wird ein Fehler ausgegeben. Bei eingeschalteter Einheitenverwaltung wird zusätzlich geprüft, ob die Einheit der Datenkomponente die Dimension Zeit hat. Ist dies nicht der Fall, erfolgt keine Konvertierung und sie wird unverändert ins Ergebnis übernommen.
Da der Operator den Zeitstempel aus dem Ausdruck auslesen muss, sind als Argument keine beliebigen Ausdrücke zulässig, sondern nur solche, die ein Datenobjekt repräsentieren oder Kopfinformationen zugewiesen haben.
Verfügbarkeit
FlexPro View, Basic, Professional, Developer Suite
Beispiele
AbsoluteTime<X> Signal |
Konvertiert die X-Komponente des Signals in Absolutzeit. |
AbsoluteTime Signal |
Konvertiert alle Komponenten des Signals, die eine Zeiteinheit haben, in Absolutzeit. |
AbsoluteTime<X> Signal(Amplitude, Zeit) |
Erzeugt eine Fehlermeldung, da das Argument des Operators kein Datenobjekt repräsentiert. |