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.

In diesem Abschnitt: