# Num - Skript- und Diagrammfunktion

Num() formatiert eine Zahl, konvertiert also den Zahlenwert der Eingabe in den Eingabetext mit dem Format, das im zweiten Parameter angegeben ist. Wenn der zweite Parameter ausgelassen wird, werden die Dezimal- und Tausendertrennzeichen verwendet, die im Datenladeskript festgelegt sind. Angepasste Dezimal- und Tausendertrennzeichen sind optionale Parameter.

Syntax:

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

Rückgabe Datentyp: dual

Die Funktion Num gibt einen dualen Wert mit dem String- und dem Zahlenwert zurück. Die Funktion nimmt den Zahlenwert der Eingabeformel und generiert einen String, der die Zahl repräsentiert.

Argumente:

Argumente

| Argument | Beschreibung |
| --- | --- |
| number | Die zu formatierende Zahl. |
| format | String zur Angabe der Formatierung des resultierenden Strings. Ist kein String angegeben, werden die Dezimal- und Tausendertrennzeichen verwendet, die im Datenladeskript festgelegt sind. |
| dec\_sep | String zur Angabe des Dezimaltrennzeichens. Ist kein String angegeben, wird der vom Datenladeskript vorgegebene Wert der Variablen „DecimalSep“ verwendet. |
| thou\_sep | String zur Angabe des Tausendertrennzeichens. Ist kein String angegeben, wird der vom Datenladeskript vorgegebene Wert der Variablen „ThousandSep“ verwendet. |

Weitere Informationen zur Formatierung von Zahlen finden Sie unter [Konventionen für Zahlen- und Uhrzeitformate](https://help.qlik.com/de-DE/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)

#### Beispiel: Diagrammformel

Beispiel:

Die folgende Tabelle zeigt die Ergebnisse, wenn das Feld A 35648.312 entspricht.

Ergebnisse

| A | Ergebnis |
| --- | --- |
| Num(A) | 35648.312 (abhängig von Umgebungsvariablen im Skript) |
| 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)

#### Beispiel: Ladeskript

Ladeskript

Num kann im Ladeskript zum Formatieren einer Zahl verwendet werden, selbst wenn die Tausender- und Dezimaltrennzeichen bereits im Skript festgelegt sind. Das folgende Ladeskript enthält spezifische Tausender- und Dezimaltrennzeichen, verwendet dann aber Num zum Formatieren von Daten auf unterschiedliche Arten.

Erstellen Sie im Dateneditor einen neuen Abschnitt, fügen Sie dann das Beispielskript hinzu und führen Sie es aus. Fügen Sie einem Arbeitsblatt in Ihrer App dann mindestens diejenigen Felder hinzu, die in der Ergebnisspalte aufgeführt sind, um das Ergebnis anzuzeigen.

```
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
];
```

Qlik SenseQlik Sense Tabelle mit den Ergebnissen verschiedener Verwendungsweisen der NumNum-Funktion im Ladeskript. Die vierte Spalte der Tabelle enthält zu Beispielzwecken eine falsche Verwendung bei der Formatierung.

| 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)

#### Beispiel: Ladeskript

Ladeskript

Num kann in einem Ladeskript zum Formatieren einer Zahl als Prozentsatz verwendet werden.

Erstellen Sie im Dateneditor einen neuen Abschnitt, fügen Sie dann das Beispielskript hinzu und führen Sie es aus. Fügen Sie einem Arbeitsblatt in Ihrer App dann mindestens diejenigen Felder hinzu, die in der Ergebnisspalte aufgeführt sind, um das Ergebnis anzuzeigen.

```
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
];
```

Qlik SenseQlik Sense Tabelle mit den Ergebnissen der NumNum-Funktion, die im Ladeskript zum Formatieren von Prozentsätzen verwendet wird.

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