ChangeUnit (FPScript)

21.09.2021

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.

Siehe auch

ChangeUnitSymbol-Funktion

AdjustUnit-Funktion

Einheitenverwaltung

Größen in FPScript

Unit-Operator

Artikel teilen oder als Email versenden:

Diese Beiträge könnten Sie ebenfalls interessieren