# Num Script- en diagramfunctie
Num() geeft de opmaak van een getal, wat wil zeggen dat deze functie de numerieke waarde van de invoer converteert naar tekst met gebruikmaking van de opmaak die is opgegeven in de tweede parameter. Als de tweede parameter wordt weggelaten, worden de scheidingstekens voor decimalen en duizendtallen gebruikt die zijn ingesteld in het load-script voor gegevens. Aangepaste scheidingstekens voor decimalen en scheidingstekens voor duizendtallen zijn optionele parameters.
Syntaxis:
Num(number[, format[, dec\_sep [, thou\_sep]]])
Retourgegevenstypen: dubbele waarde
De functie Num retourneert een dubbele waarde met zowel de tekenreeks als de numerieke waarde. De functie neemt de numerieke waarde van de invoeruitdrukking en genereert een tekenreeks die het getal vertegenwoordigt.
Argumenten
| Argument | Beschrijving |
| --- | --- |
| number | De teksttekenreeks die moet worden geëvalueerd. |
| format | Tekenreeks die specificeert hoe de resulterende tekenreeks moet worden opgemaakt. Bij weglating worden de scheidingstekens voor decimalen en duizendtallen gebruikt die zijn ingesteld in het load-script voor gegevens.
De functie `Num` ondersteunt vele opmaakopties voor verschillende numerieke structuren, bijvoorbeeld:
`#,##0`:geeft een getal zonder decimalen weer.
`#,##0.00`:geeft een getal met twee decimalen weer.
`##0.00%`: geeft een getal als een percentage met twee decimalen weer.
`#,##0;(#,##0)`: plaatst getallen tussen haakjes.
`$#,##0.00`: maakt getallen op als valuta met een $-symbool.
`0.00E+0`:gGeeft getallen in wetenschappelijke notatie weer. |
| dec\_sep | Tekenreeks die het scheidingsteken voor decimalen opgeeft. Bij weglating wordt gebruikgemaakt van de waarde voor de variabele DecimalSep die is ingesteld in het load-script voor gegevens.
De functie `Num` ondersteunt vele notaties voor scheidingstekens voor decimalen, bijvoorbeeld:
Komma ' `,` ': Bijvoorbeeld `$1,000,00` voor duizend dollar.
Punt ' `.` ': bijvoorbeeld `€ 1,000.00`.
Koppelteken ' `-` ': als dit wordt gebruikt in plaats van de traditionele punt of komma als scheidingsteken voor decimalen, geeft het waarden weer als `¥1,000-00`.
Ga voor meer informatie naar [DecimalSep](https://help.qlik.com/nl-NL/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/NumberInterpretationVariables/DecimalSep.htm). |
| thou\_sep | Tekenreeks die het scheidingsteken voor duizendtallen opgeeft. Bij weglating wordt gebruikgemaakt van de waarde voor de variabele ThousandSep die is ingesteld in het load-script voor gegevens.
De functie `Num` ondersteunt vele opties voor het scheidingsteken voor duizendtallen:
Punt ' `.` ': gebruikt een punt als scheidingsteken voor duizendtallen (gebruikelijk in sommige Europese notaties), wordt weergegeven als `$1.000,00` indien gecombineerd met een komma als scheidingsteken voor decimalen.
Spatie ' ': gebruikt een spatie voor het scheidingsteken voor duizendtallen, wat gebruikelijk is in sommige Europese landen. Wordt weergegeven als `€ 1 000.00`.
Onderstrepingsteken '`_`': gebruikt een onderstrepingsteken voor het scheidingsteken voor duizendtallen, dat soms wordt gebruikt in technische of specifieke regionale notaties. Geeft waarden weer zoals `$1_000.00`.
Ga voor meer informatie naar [ThousandSep](https://help.qlik.com/nl-NL/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/NumberInterpretationVariables/ThousandSep.htm). |
Zie [Conventies voor getal- en tijdnotaties](https://help.qlik.com/nl-NL/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) voor meer informatie over getalnotaties.
Voorbeeld: diagramuitdrukkingen
| Voorbeeld | Resultaten (geretourneerde tekenreekswaarde) |
| --- | --- |
| `Num(35648.312)` | Retourneer `35648.312` (afhankelijk van omgevingsvariabelen in het script) |
| `Num(35648.312, '0.0', '.')` | Retourneert `35648.3` |
| `Num(35648.312, '0,00', ',')` | Retourneert `3,56,48` |
| `Num(35648.312, '#,##0.0', '.', ',')` | Retourneert `35,648.3` |
| `Num(35648.312, '# ##0', ',', ' ')` | Retourneert `35 648` |
## Voorbeeld - Basisprincipes voor Num
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)
#### Diagramuitdrukking
Overzicht
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.
Het load-script bevat:
* Een gegevensverzameling die wordt geladen in een tabel met de naam `Example`.
* Het volgende veld in een gegevenstabel:
* `InputValue`
Load-script
```
Example:
Load * inline [
InputValue
35648
3564800
356.48
];
```
Resultaten
Laad de gegevens en open een werkblad. Maak een nieuwe tabel en voeg dit veld toe als dimensie:
* ` InputValue
`
Maak de volgende metingen:
* `=Num(InputDate)`, om de waarde weer te geven als een getal dat is opgemaakt volgens de systeeminstellingen.
* `=Num(InputValue, '0.0', '.')`, om de waarde weer te geven als een getal dat is opgemaakt volgens de notatie die in de functie is opgegeven.
* `=Num(InputValue, '0,00', ',')`, om de waarde weer te geven als een getal dat is opgemaakt volgens de notatie die in de functie is opgegeven.
* `=Num(InputValue, '#,##0.0', '.', ',')`, om de waarde weer te geven als een getal dat is opgemaakt volgens de notatie die in de functie is opgegeven.
* `=Num(InputValue, '# ##0', ',', ' ')`, om de waarde weer te geven als een getal dat is opgemaakt volgens de notatie die in de functie is opgegeven.
Results table
| InputValue | Num(InputDate) | Num(InputValue, '0.0', '.') | Num(InputValue, '0,00', ',') | Num(InputValue, '#,##0.0', '.', ',') | Num(InputValue, '# ##0', ',', ' ') |
| --- | --- | --- | --- | --- | --- |
| 356.48 | 356.48 | 356.5 | 3,56 | 356.5 | 356 |
| 35648 | 35648 | 35648.0 | 3,56,48 | 35,648.0 | 35 648 |
| 3564800 | 3564800 | 3564800.0 | 3,56,48,00 | 3,564,800.0 | 3 564 800 |
De resultaten laten zien hoe de functie `Num` de waarden voor het veld `InputValue` kan weergeven op basis van de notatie die in de functie-uitdrukking is opgegeven.
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)
#### Load-script
Zelfs als de scheidingstekens voor duizendtallen en decimalen al in het script zijn ingesteld, kan de functie `Num` worden gebruikt voor de notatie van een getal in een load-script. Het onderstaande load-script bevat specifieke scheidingstekens voor duizendtallen en decimalen, maar vervolgens is `Num` gebruikt om de gegevens op andere manieren te noteren.
Load-script
Maak een nieuwe sectie aan in de Editor voor laden van gegevens, voeg vervolgens het voorbeeldscript toe en voer het uit. Voeg vervolgens ten minste de velden die in de resultatentabel staan toe aan een werkblad in uw applicatie om het resultaat te bekijken.
```
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
];
```
Resultaten
Qlik SenseQlik Sense-tabel met de resultaten van verschillende manieren waarop de functie NumNum in het load-script wordt gebruikt. Ter illustratie bevat de vierde kolom van de tabel het gebruik van incorrecte notatie.
| 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 |
## Voorbeeld – Scenario met Num
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)
#### Diagramuitdrukking
Overzicht
Een gegevensverzameling bevat verkoopgegevens die u wilt presenteren in een eenvoudiger numerieke notatie.
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.
Het load-script bevat:
* Een gegevensverzameling die wordt geladen in een tabel met de naam `Example`.
* De volgende velden in de gegevenstabel:
* `Customer`
* `Sales`
Load-script
```
Example:
Load * inline [
Customer, Sales
Customer A, 2550000
Customer B, 12500
Customer C, 15000
Customer D, 250
];
```
Resultaten
Laad de gegevens en open een werkblad. Maak een nieuwe tabel en voeg dit veld toe als dimensie:
* ` Customer
`
Maak de volgende meting:
* `=If(Sales > 1000000, Num(Sales/1000000, '#,##0.00M'), If(Sales > 1000, Num(Sales/1000, '#,##0.00K'), Num(Sales, '#,##0.00')))`, om de numerieke weergave van de waarden in te stellen.
Results table
| Customer | If(Sales > 1000000, Num(Sales/1000000, '#,##0.00M'), If(Sales > 1000, Num(Sales/1000, '#,##0.00K'), Num(Sales, '#,##0.00'))) |
| --- | --- |
| Customer A | 2.55M |
| Customer B | 12.50K |
| Customer C | 15.00K |
| Customer D | 250.00 |
De metinguitdrukking in kolom 2 gebruikt de functie `Num` om de gegevens in een vereenvoudigde numerieke notatie weer te geven.
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)
#### Load-script
De functie `Num` kan worden gebruikt in een load-script om getallen als percentage op te maken.
Load-script
Maak een nieuwe sectie aan in de Editor voor laden van gegevens, voeg vervolgens het voorbeeldscript toe en voer het uit. Voeg vervolgens de velden die in de resultatenkolom staan toe aan een werkblad in uw applicatie om het resultaat te bekijken.
```
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-tabel met de resultaten van de functie `Num`Num die in het load-script wordt gebruikt voor het noteren van percentages.
| Discount | Discount #,##0% |
| --- | --- |
| 0 | 0% |
| 0.1 | 10% |
| 0.22 | 22% |
| 0 | 0% |
| 75 | 7,500% |
| 0.333333333333333 | 33% |
| .14 | 14% |