Skip to main content

Konvertierungsfunktionen

Eine Konvertierungsfunktion konvertiert einen Datentyp oder ein Format in einen anderen Datentyp oder ein anderes Format. Mithilfe einer Konvertierungsfunktion können Sie Zahlen in Zeichenfolgen oder Zeichenfolgen in Zahlen konvertieren. Konvertierungsfunktionen können für Zeichenfolgen und numerische Datentypen verwendet werden.

BinToInt

BinToInt(s) : konvertiert die binäre Zeichenfolge (s) in eine Ganzzahl. Sie ist einer Genauigkeit von 64 Bit begrenzt und kann bis zu 64 Bit lang sein.

Beispiel

  • BinToInt("101010101")  gibt 341 zurück. Wenn die Zeichenfolge genau 32 oder 64 Zeichen enthält, wird sie als signierte Zahl behandelt:

  • BinToInt("11111111111111111111111111111011")  gibt -5 zurück. Die Vorzeichen '+' and '-' haben Vorrang vor der Behandlung von Zeichenfolgen mit 32 und 64 Zeichen als signierte Zahl:

  • BinToInt("-111")  gibt -7 zurück.

  • BinToInt("+111")  gibt 7 zurück.

CharFromInt

CharFromInt(x) : gibt das Unicode®-Zeichen zurück, das der eingegebenen Zahl x entspricht.

Beispiel

  • CharFromInt(66)  gibt B zurück (U+0042 „Lateinischer Großbuchstabe B“).

  • CharFromInt(169)  gibt © zurück (U+00A9 „Copyright-Zeichen“).

  • CharFromInt(1071)  gibt Я zurück (U+042F „Kyrillischer Großbuchstabe YA“).

  • CharFromInt(127944)  gibt 🏈 zurück (U+1F3C8 „American Football-Symbol“).

  • CharFromInt(0)  gibt [null] (U+000 'Null') zurück, weil Ganzzahlen, die nicht zum Darstellen von Zeichen verwendet werden können, möglicherweise ein Null-Ergebnis liefern.

  • CharFromInt(55300)  gibt [null] aus, weil Ganzzahlen, die momentan kein Zeichen darstellen, nicht mit einer normalen Schriftart angezeigt werden.

CharToInt

CharToInt(s) : gibt die Zahl zurück, die dem eingegebenen Unicode®-Zeichen „s" entspricht.

Beispiel

  • CharToInt("B")  gibt 66 (U+0042 „Lateinischer Großbuchstabe B“) zurück.

  • CharToInt("©")  gibt 169 zurück (U+00A9 „Copyright-Zeichen“) zurück.

  • CharToInt("Я")  gibt 1071 (U+042F „Kyrillischer Großbuchstabe YA“) zurück.

  • CharToInt()  gibt 127944 (U+1F3C8 „American Football-Symbol“) zurück.

ConvertFromCodePage

ConvertFromCodePage(s, codePage) : übersetzt Text von einer Codepage in Unicode. Weitere Informationen zu Codepages finden Sie in der Codepages -Dokumentation.

ConvertToCodePage

ConvertToCodePage(s, codePage) : übersetzt Text aus Unicode®-Kodierung in eine spezifische Codepage. Weitere Informationen zu Codepages finden Sie in der Codepages -Dokumentation.

HexToNumber

HexToNumber(x): konvertiert eine HEX-Zeichenfolge in eine Zahl (begrenzt auf 64 Bit). Wenn 64 Bit und 16 Hexadezimalzeichen vorhanden sind und das führende Bit gesetzt ist, ist das Ergebnis negativ.

Beispiel

  • HexToNumber("7FFFFFFFFFFFFFFA")  gibt 9223372036854775802 zurück.

  • HexToNumber("FFFFFFFFFFFFFFFA")  gibt -6 zurück

  • HexToNumber("FFFFFFFFFFFFFFFB")  gibt -5 zurück.

IntToBin

IntToBin(x) : konvertiert x in eine binäre Zeichenfolge.

IntToHex

IntToHex(x) : konvertiert x in eine hexadezimale Zeichenfolge.

ToDegrees

ToDegrees(x) : Konvertiert einen numerischen Bogenmaßwert (x) mithilfe der (x)rad × 180/π-Berechnung in Grad. Bitte beachten Sie, dass x ein numerischer Wert sein muss und kein Bogenmaß (rad) enthalten darf.

Beispiel

  • TODEGREES(0)  gibt 0 zurück.

  • TODEGREES(1)  gibt 57.29578 (1 * 180/π) zurück.

  • TODEGREES(Null)  gibt Null zurück.

  • TODEGREES(2.5)  gibt 143.239449 (2.5 * 180/π) zurück.

ToNumber

ToNumber(x, [bIgnoreErrors], [keepNulls], [decimalSeparator]) : konvertiert eine Zeichenfolge (x) in eine Zahl. ToNumber akzeptiert Zeichenfolgen, die als wissenschaftliche Notation mit doppelter Genauigkeit interpretiert werden können. Standardmäßig wird ein Punkt als Dezimaltrennzeichen verwendet. Vor (nicht nach) dem Dezimaltrennzeichen (falls vorhanden) werden alle plausiblen Tausendertrennzeichen entfernt: Leerzeichen, Komma, Punkt und Apostroph. Sie können "123 456’789.012345" schreiben.

ToNumber kann einen ganzzahligen Wert mit einer Genauigkeit von 64 Bit zurückgeben, wenn die Eingabezeichenfolge wie eine Ganzzahl aussieht und im Bereich liegt.

Nicht-numerische Werte

ToNumber wertet die Zeichenfolge von Anfang an aus und stoppt, wenn ein nicht-numerischer Wert gefunden wird (ignoriert Kommas, Punkte, Leerzeichen und Apostrophe).

Die Zeichenfolge „June 2022“ gibt beispielsweise 0 oder [Null] (je nach Konfiguration) zurück, während „2022 June“ 2022 zurückgibt.

Optionale Parameter

  • bIgnoreErrors

    • (Standard) 0 oder False (falsch) meldet Konvertierungsfehler.

    • 1 oder True (wahr) ignoriert Konvertierungsfehler.

  • keepNulls

    • (Standard) 0 oder False konvertiert nicht-numerische Werte (einschließlich Nullwerte) in die Zahl 0.

    • 1 oder True konvertiert nicht-numerische Werte in null.

  • decimalSeparator : Das Dezimaltrennzeichen der eingehenden Zeichenfolge.

    • (Standard) „.“ legt einen Punkt als Dezimaltrennzeichen fest.

    • „,“ legt ein Komma als Dezimaltrennzeichen fest.

    Der decimalSeparator -Parameter ignoriert das angegebene Tausendertrennzeichen (Leerzeichen, Punkt, Komma oder Apostroph) der eingehenden Zeichenfolge.

Beispiel

  • ToNumber("878")  gibt Zeichenfolge 878 als Zahl zurück.

  • ToNumber("4.256411411E9")  gibt die Zahl 4256411411.0 zurück.

  • ToNumber("9223372036854775807")  Gibt 9223372036854775807 zurück. Allerdings gibt ToNumber("9.223372036854774273e18") jedoch ein Double zurück, das an Präzision verliert und auf 9223372036854775808 aufgerundet wird.

  • ToNumber("Number", "false")  gibt 0 mit Konvertierungsfehler zurück: TONUMBER: hat bei der Konvertierung Informationen verloren.

  • ToNumber("Number", 0, 0)  gibt 0 mit Konvertierungsfehler zurück: TONUMBER: hat bei der Konvertierung Informationen verloren.

  • ToNumber("Number", 1, 0)  gibt 0 ohne Konvertierungsfehler zurück.

  • ToNumber("Number", 1, 1)  gibt [Null] zurück und keinen Konvertierungsfehler.

  • ToNumber("123456,789", 1, 1, ",")  gibt 123456.789 als Zahl zurück.

  • ToNumber("123.456,789", 1, 1, ",")  gibt 123456.789 als Zahl zurück. Dies liegt daran, dass der Punkt automatisch als Tausendertrennzeichen interpretiert wird, wenn er über decimalSeparator vor dem spezifizierten Dezimaltrennzeichen gesetzt wird.

  • ToNumber("June 2022")  : Konvertiert einen numerischen Gradwert (x) über die Berechnung (x)° × π/180 in Bogenmaß.gibt 0 zurück. Die Funktion findet sofort einen nicht-numerischen Wert und konvertiert ihn in „0“.

  • ToNumber("2022 June")  gibt „2022“ als Zahl zurück. Sie stoppt, wenn ein nicht-numerischen Wert gefunden wird, wie das „J“ in „June“.

  • ToNumber("6/1/2022")  gibt „6“ als Zahl zurück. Sie stoppt, wenn ein nicht-numerischer Wert gefunden wird, „/“.

  • ToNumber("2022 5:00:00")  gibt „20225“ als Zahl zurück. Sie stoppt, wenn ein nicht-numerischer Wert gefunden wird, wie das „:“ nach der „5“. Leerzeichen vor einem Dezimaltrennzeichen werden ignoriert.

ToRadians

ToRadians(x) : Konvertiert einen numerischen Gradwert (x) über die Berechnung (x)° × π/180 in Bogenmaß. Bitte beachten Sie, dass x ein numerischer Wert sein muss und nicht das Gradsymbol (°) enthalten darf.

Beispiel

  • TORADIANS(0)  gibt 0 (0 * π/180) zurück.

  • TORADIANS(1)  gibt 0.017453 (1 * π/180) zurück.

  • TORADIANS(5)  gibt 0.087266 (5 * π/180) zurück.

  • TORADIANS(2.5)  gibt 0.043633 (2.5 * π/180) zurück.

ToString

ToString(x, [numDec], [addThousandsSeparator], [decimalSeparator]) : konvertiert einen numerischen Parameter (x) in eine Zeichenfolge und verwendet dazu  numDec Dezimalstellen. Standardmäßig wird ein Punkt als Dezimaltrennzeichen verwendet. ToString behandelt Int64-Werte unterschiedlich, um bei der Konvertierung nicht an Präzision zu verlieren. ToString(value, 0, 1) mit value=18014398509481983 ergibt genau 18,014,398,509,481,983.

*Der Maximalwert für den  numDec -Parameter ist 100.

Optionale Parameter

  • addThousandsSeparator

    • (Standard) 0 formatiert die numerische Zeichenfolge ohne Tausendertrennzeichen.

    • 1 formatiert mit Tausendertrennzeichen. Standardmäßig ist das Tausendertrennzeichen ein Komma, es sei denn, es wird ein „,“ für decimalSeparator angegeben. In diesem Fall ist das Tausendertrennzeichen ein Punkt.

    • „,“ legt ein Komma als Tausendertrennzeichen fest.

    • „.“ legt einen Punkt als Tausendertrennzeichen fest.

    • „ “ legt ein Leerzeichen als Tausendertrennzeichen fest.

    • "'" legt ein Apostroph als Tausendertrennzeichen fest.

  • decimalSeparator

    • (Standard) „.“ legt den Punkt als Dezimaltrennzeichen fest.

    • „,“ legt das Komma als Dezimaltrennzeichen fest.

Beispiel

  • ToString(10, 0)  gibt 10 als Zeichenfolge zurück.

  • ToString(10.4, 2)  gibt 10.40 als Zeichenfolge zurück.

  • ToString(100.4, 2)  gibt 100.40 als Zeichenfolge zurück.

  • ToString(1000.4, 2, 1)  gibt 1,000.40 als Zeichenfolge zurück.

  • ToString(123456.789, 3, 1, ",")  gibt 123.456,789 als Zeichenfolge zurück.

  • ToString(123456.789, 3, 0, ",")  gibt 123456,789 als Zeichenfolge zurück.

  • ToString(1234567.89, 2, ".", ",")  gibt 1.234.567,89 als Zeichenfolge zurück.

  • ToString(1234567.89, 2, " ", ",")  gibt 1 234 567,89 als Zeichenfolge zurück.

  • ToString(1234567.89, 2, "'", ",")  gibt 1'234'567,89 als Zeichenfolge zurück.

UnicodeNormalize

UnicodeNormalize(String, Form): Converts text data in the provided string into a standardized Unicode form. Use the required Form parameter (case-insensitive) to define the normalization form. You must manually enter one of the below normalization form options (this parameter can't be populated via an upstream field.

Normalization helps ensure that different representations of the same text are treated equivalently. It reduces ambiguity and simplifies text processing tasks such as searching, sorting, and comparing. It's particularly important in environments where text can originate from various sources or be processed by different systems with differing encoding standards.

Parameters

  • String: The provided string that you need to normalize.

  • Form: Options for how to normalize your string. These are the acceptable normalization forms (String format and quotes are required):

    • NFC (Normalization Form Canonical Composition): NFC composes characters and sequences of characters in a text into a single precomposed form whenever possible. This form is commonly used for data interchange and storage.

    • NFD (Normalization Form Canonical Decomposition): NFD decomposes characters and sequences of characters into their base characters and combines characters. This form can be useful for tasks such as searching and comparing text.

    • NFKC (Normalization Form Compatibility Composition): NFKC first applies a compatibility decomposition, then composes characters and sequences of characters into a single precomposed form whenever possible. This form is often used for compatibility and normalization of legacy data.

    • NFKD (Normalization Form Compatibility Decomposition): NFKD applies a compatibility decomposition to characters and sequences of characters, breaking them down into their base characters and combining characters. This form can also be useful for compatibility and normalization purposes.

Example

  • UnicodeNormalize("i⁹","NFKD") returns i9.

  • UnicodeNormalize("¼","NFKC") returns 1/4.

  • UnicodeNormalize("㌄","NFC") returns ㌄.

  • UnicodeNormalize("㌄","NFKC") returns イニング.

In diesem Abschnitt: