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 Zahlen-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] zurück, weil Ganzzahlen, die derzeit 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. Um mehr über Codepages zu erfahren, rufen Sie die Codepages-Dokumentation auf.

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 Schreibweise mit doppelter Präzision 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 Parameter decimalSeparator 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: Zahl hat bei der Konvertierung Informationen verloren.

  • ToNumber("Number", 0, 0) gibt „0" mit Konvertierungsfehler zurück: TONUMBER: Zahl 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") 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): konvertiert Textdaten in der angegebenen Zeichenfolge in eine standardisierte Unicode-Form. Verwenden Sie den erforderlichen Formparameter (ohne Berücksichtigung der Groß-/Kleinschreibung), um die Normalisierungsform zu definieren. Sie müssen manuell eine der folgenden Optionen für die Normalisierungsform eingeben (dieser Parameter kann nicht über ein vorgelagertes Feld ausgefüllt werden).

Durch die Normalisierung kann sichergestellt werden, dass unterschiedliche Darstellungen desselben Textes gleichwertig behandelt werden. Sie reduziert Mehrdeutigkeiten und vereinfacht Textverarbeitungsaufgaben wie Suchen, Sortieren und Vergleichen. Dies ist besonders wichtig in Umgebungen, in denen Text aus verschiedenen Quellen stammen oder von verschiedenen Systemen mit unterschiedlichen Codierungsstandards verarbeitet werden kann.

Parameter

  • String: Die angegebene Zeichenfolge, die normalisiert werden muss.

  • Form: Optionen zum Normalisieren der Zeichenfolge. Dies sind die zulässigen Normalisierungsformen (Zeichenfolgenformat und Anführungszeichen sind erforderlich):

    • NFC (Normalization Form Canonical Composition): NFC setzt Zeichen und Zeichenfolgen in einem Text nach Möglichkeit in einer einzigen vordefinierten Form zusammen. Diese Form wird häufig für den Datenaustausch und die Datenspeicherung verwendet.

    • NFD (Normalization Form Canonical Decomposition): NFD zersetzt Zeichen und Zeichenfolgen in ihre Basiszeichen und kombiniert Zeichen. Diese Form kann für Aufgaben wie Suchen und Vergleichen von Text nützlich sein.

    • NFKC (Normalization Form Compatibility Composition): NFKC führt zunächst eine Kompatibilitätszerlegung durch und setzt dann Zeichen und Zeichenfolgen nach Möglichkeit in einer einzigen vorgefertigten Form zusammen. Diese Form wird häufig für die Kompatibilität und Normalisierung von Altdaten verwendet.

    • NFKD (Normalization Form Compatibility Decomposition): NFKD wendet eine Kompatibilitätszerlegung auf Zeichen und Zeichenfolgen an, wobei die Zeichen in ihre Basiszeichen zerlegt und kombiniert werden. Diese Form kann auch für Kompatibilitäts- und Normalisierungszwecke hilfreich sein.

Beispiel

  • UnicodeNormalize("i⁹","NFKD") gibt „i9“ zurück.

  • UnicodeNormalize("¼","NFKC") gibt „1/4“ zurück.

  • UnicodeNormalize("㌄","NFC") gibt ㌄ zurück.

  • UnicodeNormalize("㌄","NFKC") gibt イニング zurück.

In diesem Abschnitt: