ChangeUnit (FPScript)
Konvertiert bzw. setzt die Einheit(en) eines Datensatzes.
Syntax
ChangeUnit(DataSet, [ Unit ], [ UnitX ] [ , UnitZ ])
Die Syntax der ChangeUnit-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
---|---|
DataSet |
Der Datensatz, dessen Einheit(en) gesetzt oder konvertiert werden soll(en). Es sind alle Datenstrukturen erlaubt außer Liste. Unterstützte Datentypen sind 32-Bit Fließkomma, 64-Bit Fließkomma, Komplexe 32-Bit Fließkommazahl, Komplexe 64-Bit Fließkommazahl, Kalenderzeit und Zeitspanne. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
Unit |
Gibt die Zieleinheit für den Datensatz bzw. dessen Y-Komponente an. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette. |
UnitX |
Gibt die Zieleinheit für die X-Komponente des Datensatzes an. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette. |
UnitZ |
Gibt die Zieleinheit für die Z-Komponente des Datensatzes an. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette. |
Anmerkungen
Wenn DataSet bereits einheitenbehaftet ist, dann wird die Einheit konvertiert und ansonsten zugewiesen. Wenn Sie für eines der Argumente Unit, UnitX oder UnitZ eine leere Zeichenkette angeben, wird die entsprechende Einheit entfernt. Wenn Sie ein Argument weglassen, bleibt die entsprechende Einheit unverändert. Ist die Konvertierung wegen nicht übereinstimmender SI-Dimension nicht möglich, wird ein Fehler ausgegeben. Einheiten mit unbekannter SI-Dimension können nur gesetzt oder entfernt aber nicht transformiert werden.
Verfügbarkeit
FlexPro View, Basic, Professional, Developer Suite
Beispiele
ChangeUnit(1.4 V, "mV") |
Ergibt 1400. mV. Die Einheit wird konvertiert. |
ChangeUnit(1.4, "mV") |
Ergibt 1.4 mV. Die Einheit wird gesetzt. |
ChangeUnit(1.4 mV, "") |
Ergibt 1.4. Die Einheit wird entfernt. |
ChangeUnit(2 Pi, "1") |
Ergibt 6.283185307179586. Die dimensionslose Einheit wird in die Einheit 1 transformiert. |
ChangeUnit(Signal, "mV", "ms") |
Die Y- und die X-Einheit des Signals werden gesetzt bzw. konvertiert. |
ChangeUnit(Signal, , "ms") |
Nur die Einheit der X-Komponente des Signals wird gesetzt bzw. konvertiert. Die der Y-Komponente bleibt unverändert. |