Skip to main content

変換関数

変換関数は、1つのデータ型または形式を別のデータ型または形式に変換します。数値を文字列に、または文字列を数値に変換するには、変換関数を使用します。変換関数は、文字列データ型と数値データ型で使用できます。

BinToInt

BinToInt(s): バイナリ文字列を整数に変換します。精度は64ビットに制限されます。長さは最大64ビットです。

  • BinToInt("101010101") 341を返します。文字列の長さが厳密に32文字または64文字の場合、符号付きの数値として扱われます。

  • BinToInt("11111111111111111111111111111011") -5を返します。先頭に符号の「+」や「-」が付いている場合は、常に符号付きの数値として扱われます。これは、32文字と64文字を符号付きの数値として扱うというルールよりも優先されます。

  • BinToInt("-111") -7を返します。

  • BinToInt("+111") 7を返します。

CharFromInt

CharFromInt(x): 入力した数値xと一致するUnicode®文字を返します。

  • CharFromInt(66) B(U + 0042 'ラテン語大文字B')を返します。

  • CharFromInt(169) © (U+00A9「著作権マーク」) を返します。

  • CharFromInt(1071) Я(U + 042F 'キリル文字大文字YA')を返します。

  • CharFromInt(127944) 🏈 (U+1F3C8「アメリカンフットボール」)を返します。

  • CharFromInt(0) 文字を表現するために使用できない整数値はnullを返す可能性があるため、[null](U + 000 'Null')を返します。

  • CharFromInt(55300) 現時点では文字を表現していない整数値は通常のフォントではレンダリングされないため、[null]を返します。

CharToInt

CharToInt(s): 入力したUnicode®文字sと一致する数値を返します。

  • CharToInt("B") 66(U + 0042 'ラテン語大文字B')を返します。

  • CharToInt("©") 169 (U+00A9「著作権マーク」) を返します。

  • CharToInt("Я") 1071(U + 042F 'キリル文字大文字YA')を返します。

  • CharToInt() 127944 (U+1F3C8「アメリカンフットボール」) を返します。

ConvertFromCodePage

ConvertFromCodePage(s, codePage): コードページのテキストをUnicodeに変換します。コードページの詳細については、 コードページ のドキュメントを参照してください。

ConvertToCodePage

ConvertToCodePage(s, codePage): Unicode®エンコーディングのテキストを特定のコードページに変換します。コードページの詳細については、コードページ のドキュメントを参照してください。

HexToNumber

HexToNumber(x): HEX文字列を数値に変換します (64ビットに制限されています)。64ビット、16のHEX文字列があり、リードビットが設定されている場合、結果は負になります。

  • HexToNumber("7FFFFFFFFFFFFFFA") 9223372036854775802を返します。

  • HexToNumber("FFFFFFFFFFFFFFFA") -6を返します。

  • HexToNumber("FFFFFFFFFFFFFFFB") -5を返します。

IntToBin

IntToBin(x): xをバイナリ文字列に変換します。

IntToHex

IntToHex(x): xを16進数文字列に変換します。

ToDegrees

ToDegrees(x): ラジアンの数値(x)を角度値に(x)rad × 180/πの計算で変換します。xは数値である必要があり、ラジアン記号(rad)を含めることはできません。

  • TODEGREES(0) 0を返します。

  • TODEGREES(1) 57.29578 (1 × 180/π)を返します。

  • TODEGREES(Null) Nullを返します。

  • TODEGREES(2.5) 143.239449 (2.5 × 180/π)を返します。

ToNumber

ToNumber(x, [bIgnoreErrors], [keepNulls], [decimalSeparator]): 文字列xを数値に変換します。ToNumberは、科学的表記倍精度として解釈できる文字列を受け入れます。既定では、ピリオドが小数点記号として使用されます。小数点記号(あれば)の前(後ではない)では、スペース、コンマ、ピリオド、アポストロフィなどすべての考えられる桁区切り記号が削除されます。「123 456’789.012345」と書くことができます。

ToNumberは、入力文字列が整数のようで、範囲内であれば、64ビットの精度で整数値を返すことができます。

数値以外の値

ToNumber は、文字列を最初から評価し、数値以外の値 (コンマ、ピリオド、スペース、アポストロフィは無視) を検出すると停止します。

たとえば、文字列「June 2022」は 0 または [Null] を返し (設定による)、「2022 June」は 2022 を返します。

オプションのパラメーター

  • bIgnoreErrors

    • (既定) 0 または false は、変換エラーメッセージを報告します。

    • 1 または true は変換エラーを無視します。

  • keepNulls

    • (既定) 0 または false は、数値以外の値 (null を含む) をゼロに変換します。

    • 1 または true は、数値以外の値を null に変換します。

  • decimalSeparator: 入力文字列で使用される小数点記号です。

    • (既定) "." はピリオドを小数点記号として指定します。

    • "," はコンマを小数点記号として指定します。

    decimalSeparatorパラメーターは、入力文字列に設定された3桁ごとの区切り文字(スペース、ピリオド、カンマ、またはアポストロフィ)を無視します。

  • ToNumber("878") 文字列878を数値として返します。

  • ToNumber("4.256411411E9") 数値4256411411.0を返します。

  • ToNumber("9223372036854775807") 9223372036854775807を返します。ただし、 ToNumber("9.223372036854774273e18") はDouble(倍精度浮動小数点数値型)を返すことで精度が低下し、9223372036854775808に切り上げられます。

  • ToNumber("Number", "false") 変換エラー (TONUMBER: 変換で数値情報が失われました。) で0を返します。

  • ToNumber("Number", 0, 0) 変換エラー (TONUMBER: 変換で数値情報が失われました。) で0を返します。

  • ToNumber("Number", 1, 0) 変換エラーなしで0を返します。

  • ToNumber("Number", 1, 1) [Null]および変換エラーなしで0を返します。

  • ToNumber("123456,789", 1, 1, ",") 123456.789を数値として返します。

  • ToNumber("123.456,789", 1, 1, ",") 123456.789を数値として返します。これは、ピリオドがdecimalSeparatorで指定した小数点記号の前に来たときに、桁区切り文字として解釈されるためです。

  • ToNumber("June 2022") 0を返します。関数は、即座に数値以外の値を検出し、0 に変換します。

  • ToNumber("2022 June") 2022を数値として返します。数値以外の値 (JuneのJ)を検出すると停止します。

  • ToNumber("6/1/2022") 6を数値として返します。数値以外の値 (/) を検出すると停止します。

  • ToNumber("2022 5:00:00") 20225 を数値として返します。数値以外の値 (5より後) を検出すると停止します。小数点記号の前のスペースは無視されます。

ToRadians

ToRadians(x): 角度の数値(x)をラジアンの値に(x)°  × π/180の計算で変換します。なお、xは数値である必要があり、度数記号(°)を含むことはできません。

  • TORADIANS(0) TORADIANS(0)は0 (0 × π/180)を返します。

  • TORADIANS(1) TORADIANS(1)は0.017453 (1 × π/180)を返します。

  • TORADIANS(5) TORADIANS(5)は0.087266 (5 × π/180)を返します。

  • TORADIANS(2.5) TORADIANS(2.5)は0.043633 (2.5 × π/180)を返します。

ToString

ToString(x, [numDec], [addThousandsSeparator], [decimalSeparator]): numDec*の小数位を使用して、数値パラメーター (x)を文字列に変換します。既定では、ピリオドが小数点記号として使用されます。ToStringでは、変換の精度を落とさないために、Int64値を別扱いしています。ToString(value, 0, 1) 値= 18014398509481983の場合、正確には18,014,398,509,481,983となります。

*numDecパラメーターの最大値は100です。

オプションのパラメーター

  • addThousandsSeparator

    • (既定)0は桁区切り記号を使用せずに数値文字列をフォーマットします。

    • 1は桁区切り記号を使用してフォーマットします。既定では、コンマが3桁ごとの区切り記号として使用されます。ただし、"," が decimalSeparatorに指定されている場合は、ピリオドが3桁ごとの区切り記号として使用されます。

    • "," は、コンマを桁区切り記号として指定します。

    • "." は、ピリオドを桁区切り記号として指定します。

    • " " は、スペースを桁区切り記号として指定します。

    • "'" は、アポストロフィを桁区切り記号として指定します。

  • decimalSeparator

    • (既定) "." は、ピリオドを小数点記号として指定します。

    • "," は、コンマを小数点記号として指定します。

  • ToString(10, 0) 10を文字列として返します。

  • ToString(10.4, 2) 10.40を文字列として返します。

  • ToString(100.4, 2) 100.40を文字列として返します。

  • ToString(1000.4, 2, 1) 1,000.40を文字列として返します。

  • ToString(123456.789, 3, 1, ",") 123.456,789を文字列として返します。

  • ToString(123456.789, 3, 0, ",") 123456,789を文字列として返します。

  • ToString(1234567.89, 2, ".", ",") 1.234.567,89を文字列として返します。

  • ToString(1234567.89, 2, " ", ",") 1 234 567,89を文字列として返します。

  • ToString(1234567.89, 2, "'", ",") 1'234'567,89を文字列として返します。

UnicodeNormalize

UnicodeNormalize(String, Form): 指定された文字列内のテキストデータを、標準化されたUnicode形式に変換します。必須のFormパラメーター(大文字と小文字を区別しない)を使用して、正規化形式を定義します。次の正規化形式オプションのいずれかを手動で入力する必要があります(このパラメーターを上流フィールドから入力することはできません)。

正規化は、同じテキストの異なる表現が同等に扱われるようにするのに役立ちます。あいまいさを減らし、検索、ソート、比較などのテキスト処理タスクを簡素化します。テキストがさまざまなソースに由来する場合や、エンコーディング標準の異なる複数のシステムで処理される環境では特に重要です。

パラメーター

  • String: 正規化対象の文字列。

  • Form: 文字列の正規化方法を指定するオプション。使用可能な正規化形式は次のとおりです(String形式と引用符が必要)。

    • NFC (Normalization Form Canonical Composition): NFCはテキスト内の文字や文字シーケンスをできるだけ単一の事前構成済み形式に合成します。この形式はデータの交換や保存によく使用されます。

    • NFD (Normalization Form Canonical Decomposition): NFDは文字や文字シーケンスを基底文字と結合文字に分解します。この形式はテキストの検索や比較などのタスクに便利です。

    • NFKC (Normalization Form Compatibility Composition): NFKCは最初に互換分解を適用してから、できるだけ文字や文字シーケンスを単一の事前構成済み形式に合成します。この形式は、レガシーデータの互換性と正規化のためによく使用されます。

    • NFKD (Normalization Form Compatibility Decomposition): NFKDは文字と文字シーケンスに互換分解を適用し、それらを基底文字と結合文字に分解します。この形式も互換性や正規化が目的の場合に便利です。

  • UnicodeNormalize("i⁹","NFKD") i9を返します。

  • UnicodeNormalize("¼","NFKC") 1/4を返します。

  • UnicodeNormalize("㌄","NFC") ㌄を返します。

  • UnicodeNormalize("㌄","NFKC") イニングを返します。