Num - funzione dello script e del grafico

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

Per ulteriori informazioni sulla formattazione dei numeri, vedere Convenzioni per i formati dei numeri e dell'ora.

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

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.

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 Sense che mostra i risultati di diversi utilizzi della funzione Num 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

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.

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 Sense che mostra i risultati della funzione 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%

Hai trovato utile questa pagina?

Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – facci sapere come possiamo migliorare!

Lascia qui il tuo feedback