# Num - Funzione per script e grafici
Num() formatta un numero, ovvero converte il valore numerico dell'input per visualizzare il testo usando il formato specificato nel secondo parametro. Se il secondo parametro viene omesso, utilizza i separatori decimali e delle migliaia impostati nello script di caricamento dei dati. I simboli dei separatori decimali e delle migliaia personalizzati sono parametri opzionali.
Sintassi:
Num(number[, format[, dec\_sep [, thou\_sep]]])
Tipo di dati restituiti: duale
La funzione Num restituisce un valore duale contenente sia la stringa che il valore numerico. La funzione prende il valore numerico dell'espressione di input e genera una stringa che rappresenta il numero.
Argomenti
| Argomento | Descrizione |
| --- | --- |
| number | La stringa di testo da valutare. |
| format | Stringa che specifica come formattare la stringa risultante. Se omessi, verranno utilizzati i separatori di decimali e migliaia impostati nello script di caricamento dei dati.
La funzione `Num` supporta molte opzioni di formato per diverse strutture numeriche, ad esempio:
`#,##0`: visualizza un numero senza cifre decimali.
`#,##0.00`: visualizza un numero con due cifre decimali.
`##0.00%`: visualizza un numero come una percentuale con due cifre decimali.
`#,##0;(#,##0)`: formatta i numeri negativi in modo da essere visualizzati tra parentesi.
`$#,##0.00`: formatta i numeri come valuta con il simbolo $.
`0.00E+0`: visualizza i numeri in una notazione scientifica. |
| dec\_sep | Stringa che specifica il separatore decimale dei numeri. Se omesso, viene utilizzato il valore della variabile DecimalSep impostato nello script di caricamento dei dati.
La funzione `Num` supporta molti formati per il separatore decimale, ad esempio:
Virgola '`,` ': ad esempio, `$1,000,00` per mille dollari.
Punto '`.`': ad esempio, `€ 1,000.00`.
Trattino '`-`': se utilizzato al posto del punto o della virgola, utilizzati di norma per il separatore decimale, mostra valori come `¥1,000-00`.
Per ulteriori informazioni, vedere [DecimalSep](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Scripting/NumberInterpretationVariables/DecimalSep.htm). |
| thou\_sep | Stringa che specifica il separatore delle migliaia dei numeri. Se omesso, viene utilizzato il valore della variabile ThousandSep impostato nello script di caricamento dei dati.
La funzione `Num` supporta molte opzioni per il separatore delle migliaia:
Punto ' `.` ': utilizza un punto per il separatore di migliaia (comune in alcuni formati europei), visualizzandolo come `$1.000,00` se combinato con una virgola come separatore decimale.
Spazio ' ': utilizza uno spazio per il separatore delle migliaia, che è comune in alcuni Paesi europei. Viene visualizzato come `€ 1 000.00`.
Trattino basso '`_`': utilizza un trattino basso per il separatore delle migliaia, che a volte viene utilizzato in formati tecnici o regionali specifici. Visualizza valori come `$1_000.00`.
Per ulteriori informazioni, vedere [ThousandSep](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Scripting/NumberInterpretationVariables/ThousandSep.htm). |
Per ulteriori informazioni sulla formattazione dei numeri, vedere [Convenzioni per i formati dei numeri e dell'ora](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm).
Esempio: espressioni dei grafici
| Esempio | Risultati (valore stringa restituito) |
| --- | --- |
| `Num(35648.312)` | Restituisce `35648.312` (dipende dalle variabili ambiente nello script) |
| `Num(35648.312, '0.0', '.')` | Restituisce `35648.3` |
| `Num(35648.312, '0,00', ',')` | Restituisce `3,56,48` |
| `Num(35648.312, '#,##0.0', '.', ',')` | Restituisce `35,648.3` |
| `Num(35648.312, '# ##0', ',', ' ')` | Restituisce `35 648` |
## Esempio: principi fondamentali della funzione Num
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)
#### Espressione del grafico
Panoramica
Aprire l'Editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova sezione.
Lo script di caricamento contiene:
* Un set di dati che viene caricato in una tabella dati chiamata `Example`.
* Il seguente campo in una tabella dati:
* `InputValue`
Script di caricamento
```
Example:
Load * inline [
InputValue
35648
3564800
356.48
];
```
Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere questo campo come dimensione:
* ` InputValue
`
Creare le seguenti misure:
* `=Num(InputDate)`, per visualizzare il valore come numero formattato utilizzando le impostazioni di sistema.
* `=Num(InputValue, '0.0', '.')`, per visualizzare il valore come un numero formattato secondo il formato fornito nella funzione.
* `=Num(InputValue, '0,00', ',')`, per visualizzare il valore come un numero formattato secondo il formato fornito nella funzione.
* `=Num(InputValue, '#,##0.0', '.', ',')`, per visualizzare il valore come un numero formattato secondo il formato fornito nella funzione.
* `=Num(InputValue, '# ##0', ',', ' ')`, per visualizzare il valore come un numero formattato secondo il formato fornito nella funzione.
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 |
I risultati mostrano come la funzione `Num` può visualizzare i valori per il campo `InputValue` in base al formato fornito nell'espressione della funzione.
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)
#### Script di caricamento
La funzione `Num` può essere utilizzata in uno script di caricamento per formattare un numero, anche se i separatori delle migliaia e dei decimali sono già impostati nello script. Lo script di caricamento mostrato di seguito include specifici separatori delle migliaia e dei decimali, ma utilizza `Num` per formattare i dati in modi diversi.
Script di caricamento
In Editor caricamento dati, creare una nuova sezione, quindi aggiungere lo script di esempio ed eseguirlo. Aggiungere quindi almeno i campi elencati nella colonna dei risultati a un foglio nell'app per visualizzare il risultato.
```
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
];
```
Risultati
Tabella Qlik SenseQlik Sense che mostra i risultati di diversi utilizzi della funzione NumNum nello script di caricamento. La quarta colonna della tabella mostra una formattazione incorretta, a scopo esemplificativo.
| 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 |
## Esempio: scenario per la funzione Num
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)
#### Espressione del grafico
Panoramica
Un set di dati contiene dati sulle vendite che si desidera presentare con un formato numerico più semplice.
Aprire l'Editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova sezione.
Lo script di caricamento contiene:
* Un set di dati che viene caricato in una tabella dati chiamata `Example`.
* I seguenti campi nella tabella dati:
* `Customer`
* `Sales`
Script di caricamento
```
Example:
Load * inline [
Customer, Sales
Customer A, 2550000
Customer B, 12500
Customer C, 15000
Customer D, 250
];
```
Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere questo campo come dimensione:
* ` Customer
`
Creare la seguente misura:
* `=If(Sales > 1000000, Num(Sales/1000000, '#,##0.00M'), If(Sales > 1000, Num(Sales/1000, '#,##0.00K'), Num(Sales, '#,##0.00')))`, per impostare la rappresentazione numerica dei valori.
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 |
L'espressione di misura nella colonna 2 utilizza la funzione `Num` per presentare i dati in un formato numerico semplificato.
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm)
#### Script di caricamento
La funzione `Num` può essere utilizzata in uno script di caricamento per formattare un numero come percentuale.
Script di caricamento
Nell'editor caricamento dati creare una nuova sezione, aggiungere lo script di esempio ed eseguirlo. Per visualizzare il risultato, aggiungere quindi i campi elencati nella colonna dei risultati a un foglio nell'app.
```
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
];
```
Tabella Qlik SenseQlik Sense che mostra i risultati della funzione `Num`Num utilizzata nello script di caricamento per formattare le percentuali.
| Discount | Discount #,##0% |
| --- | --- |
| 0 | 0% |
| 0.1 | 10% |
| 0.22 | 22% |
| 0 | 0% |
| 75 | 7,500% |
| 0.333333333333333 | 33% |
| .14 | 14% |