変換関数
変換関数は、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を文字列として返します。