Num# - スクリプトおよびチャート関数
Num#() は、テキスト文字列を数値として解釈します。つまり、2 番目のパラメータで指定された形式を使用して、入力文字列を数値に変換します。2 番目のパラメーターを省略すると、データ ロード スクリプトで設定された 10 進数と 1000 進数の区切り文字が使用されます。カスタムの小数点および桁区切り記号は、オプションのパラメータです。
構文:
Num#(text[, format[, dec_sep [, thou_sep ] ] ])
戻り値データ型: デュアル
Num#() 関数は、文字列と数値の両方が指定されたデュアル値を返します。この関数は、入力式のテキスト表現を取得し、数値を生成します。数値の形式は変更されません。出力は入力と同じ方法で形式化されます。
| 引数 | 説明 |
|---|---|
| text | 評価対象のテキスト文字列。 |
| format | 最初のパラメータで使用される数値形式を指定する文字列。省略した場合、データ ロード スクリプトで設定されている 10 進数と 1000 進数の区切り文字が使用されます。 Num# 関数は、さまざまな数値構造に対して多くの形式オプションをサポートしています。次に例を示します。 #,##0:小数点なしで数値を表示します。 #,##0.00:小数点以下 2 桁の数値を表示します。 ##0.00%: 数値を小数点以下 2 桁のパーセンテージとして表示します。 #,##0;(#,##0): 負の数値を括弧内に表示されるようにフォーマットします。 $#,##0.00: 数値を $ 記号付きの通貨としてフォーマットします。 0.00E+0: 数値を科学的記数法で表示します。 |
| dec_sep | 小数点記号を指定する文字列。省略されている場合は、データ ロード スクリプトで設定された変数 DecimalSep 値が使用されます。 Num# 関数は、次のような多くの小数点区切り形式をサポートしています。 カンマ「,」: 千ドルは $1,000,00 など。 ピリオド 「.」: € 1,000.00 など。 ハイフン「-」: 小数点の記号として従来のピリオドやカンマの代わりに使用すると、¥1,000-00 のような値が表示されます。 詳細については、「DecimalSep」を参照してください。 |
| thou_sep | 3 桁区切りの記号を指定する文字列。省略されている場合は、データ ロード スクリプトで設定された変数 ThousandSep 値が使用されます。 Num# 関数は、3 桁区切りの記号の多くのオプションをサポートしています。 ピリオド「.」: 3 桁ごとの区切りにピリオドを使用します (一部のヨーロッパ形式で一般的)。小数点の記号のコンマと組み合わせると $1.000,00 として表示されます。 スペース「 」: 一部のヨーロッパ諸国で一般的な、3 桁ごとの区切りにスペースを使用します。€ 1 000.00 と表示されます。 アンダースコア「_」: 3 桁ごとの区切りとしてアンダースコアを使用します。これは、技術的な形式や特定の地域の形式で使用されることがあります。$1_000.00 のような値が表示されます。 詳細については、「ThousandSep」を参照してください。 |
| 例 | 結果 (返される文字列値) |
|---|---|
| Num#( '35,648.31', '#', '.' , ',' ) | 35,648.31 の文字列と 35648.31 の数値を返します。 |
| Num#( ‘35 648.312’, '#', '.' , ',' ) | 35 648.312 の文字列と 35648.312 の数値を返します。 |
| Num#( '35.648,3123', '#', '.' , ',' ) | 35.648,3123 の文字列と NULL (-) の数値を返します。 |
| Num#( '35 648,31234', '#', '.' , ',' ) | 35 648,31234 の文字列と NULL (-) の数値を返します。 |
| Num#('1,234.56', '#,##0.00') | 1,234.56 の文字列と1230.45 の数値を返します。 |
| Num#('$1,230.45', '$#,##0.00') | $1,230.45 の文字列と1234.56 の数値を返します。 |
| Num#('20220315', 'YYYYMMDD') | 20220315 の文字列と20220315 の数値を返します。 |