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 を HEX 文字列に変換します。

ToDegrees

ToDegrees(x) 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): 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 イニング.

このセクションの内容: