# Num - スクリプトおよびチャート関数

Num() は数値をフォーマットします。つまり、2 番目のパラメーターで指定された形式を使用して、入力の数値をテキストを表示するように変換します。2 番目のパラメーターを省略すると、データ ロード スクリプトで設定された 10 進数と 1000 進数の区切り文字が使用されます。カスタムの小数点および桁区切り記号は、オプションのパラメータです。

構文:

Num(number[, format[, dec\_sep [, thou\_sep]]])

戻り値データ型： デュアル

Num 関数は、文字列と数値の両方が指定されたデュアル値を返します。この関数は、入力式の数値を取得し、数値を表す文字列を生成します。

引数：

引数

| 引数 | 説明 |
| --- | --- |
| number | 書式設定する数値。 |
| format | 結果として返される文字列の書式を設定する方法を指定する文字列。省略した場合、データ ロード スクリプトで設定されている 10 進数と 1000 進数の区切り文字が使用されます。 |
| dec\_sep | 小数点記号を指定する文字列。省略した場合、データ ロード スクリプトで設定されている変数 DecimalSep の値が使用されます。 |
| thou\_sep | 3 桁区切りの記号を指定する文字列。省略されている場合は、データ ロード スクリプトで設定された変数 ThousandSep 値が使用されます。 |

数値の書式設定の詳細については、「[数値や日付書式の変換](https://help.qlik.com/ja-JP/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm)」を参照してください。

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)

#### 例: チャートの数式

次の表は、項目 A が 35648.312 に等しい場合の結果を示しています。

結果

| A | 結果 |
| --- | --- |
| Num(A) | 35648.312 (スクリプト内の環境変数に依存) |
| Num(A, '0.0', '.') | 35648.3 |
| Num(A, '0,00', ',') | 35648,31 |
| Num(A, '#,##0.0', '.', ',') | 35,648.3 |
| Num(A, '# ##0', ',', ' ') | 35 648 |

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)

#### 例: ロード スクリプト

ロード スクリプト

Num は、ロード スクリプトで千の桁区切りと小数点の記号がすでに設定されている場合であっても、そのロード スクリプトで使用して数字の書式を設定できます。以下のロード スクリプトには、特定の千の桁区切りと小数点の記号が含まれていますが、Num を使用して異なる方法でデータの書式を設定します。

データ ロード エディターで、新しいセクションを作成し、サンプル スクリプトを追加して実行します。その後、結果列に含まれている項目をアプリのシートに追加して結果を表示します。

```
SET ThousandSep=',';
SET DecimalSep='.';
Transactions:
Load
*,
Num(transaction_amount) as [No formatting],
Num(transaction_amount,'0') as [0],
Num(transaction_amount,'#,##0') as [#,##0],
Num(transaction_amount,'# ###,00') as [# ###,00],
Num(transaction_amount,'# ###,00',',',' ') as [# ###,00 , ',' , ' '],
Num(transaction_amount,'#,###.00','.',',') as [#,###.00 , '.' , ','],
Num(transaction_amount,'$#,###.00') as [$#,###.00],
;
Load * Inline [
transaction_id, transaction_date, transaction_amount, transaction_quantity, discount, customer_id, size, color_code
3750, 20180830, 12423.56, 23, 0,2038593, L, Red
3751, 20180907, 5356.31, 6, 0.1, 203521, m, orange
3752, 20180916, 15.75, 1, 0.22, 5646471, S, blue
3753, 20180922, 1251, 7, 0, 3036491, l, Black
3754, 20180922, 21484.21, 1356, 75, 049681, xs, Red
3756, 20180922, -59.18, 2, 0.333333333333333, 2038593, M, Blue
3757, 20180923, 3177.4, 21, .14, 203521, XL, Black
];
```

ロード スクリプトでの NumNum 関数のさまざまな使用法の結果を示した Qlik SenseQlik Sense テーブル。テーブルの 4 列目には、目的など、誤った方法の書式設定が含まれています。

| No formatting | 0 | #,##0 | # ###,00 | # ###,00 , ',' , ' ' | #,###.00 , '.' , ',' | $#,###.00 |
| --- | --- | --- | --- | --- | --- | --- |
| -59.18 | -59 | -59 | -59###,00 | -59,18 | -59.18 | $-59,18 |
| 15.75 | 16 | 16 | 16###,00 | 15,75 | 15.75 | $15,75 |
| 1251 | 1251 | 1,251 | 1251###,00 | 1 251,00 | 1,251.00 | $1,251.00 |
| 3177.4 | 3177 | 3,177 | 3177###,00 | 3 177,40 | 3,177.40 | $3,177.40 |
| 5356.31 | 5356 | 5,356 | 5356###,00 | 5 356,31 | 5,356.31 | $5,356.31 |
| 12423.56 | 12424 | 12,424 | 12424###,00 | 12 423,56 | 12,423.56 | $12,423.56 |
| 21484.21 | 21484 | 21,484 | 21484###,00 | 21 484,21 | 21,484.21 | $21,484.21 |

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)

#### 例: ロード スクリプト

ロード スクリプト

Num は、ロード スクリプトで使用して、数字をパーセントとして書式設定できます。

データ ロード エディターで、新しいセクションを作成し、サンプル スクリプトを追加して実行します。7その後、結果列に含まれている項目をアプリのシートに追加して結果を表示します。

```
SET ThousandSep=',';
SET DecimalSep='.';
Transactions:
Load
*,
Num(discount,'#,##0%') as [Discount #,##0%]
;
Load * Inline [
transaction_id, transaction_date, transaction_amount, transaction_quantity, discount, customer_id, size, color_code
3750, 20180830, 12423.56, 23, 0,2038593, L, Red
3751, 20180907, 5356.31, 6, 0.1, 203521, m, orange
3752, 20180916, 15.75, 1, 0.22, 5646471, S, blue
3753, 20180922, 1251, 7, 0, 3036491, l, Black
3754, 20180922, 21484.21, 1356, 75, 049681, xs, Red
3756, 20180922, -59.18, 2, 0.333333333333333, 2038593, M, Blue
3757, 20180923, 3177.4, 21, .14, 203521, XL, Black
];
```

パーセントの書式設定のためにロード スクリプトで使用されている NumNum 関数の結果を示した Qlik SenseQlik Sense テーブル。

| Discount | Discount #,##0% |
| --- | --- |
| 0.333333333333333 | 33% |
| 0.22 | 22% |
| 0 | 0% |
| .14 | 14% |
| 0.1 | 10% |
| 0 | 0% |
| 75 | 7,500% |