Num - fonction de script et fonction de graphique

Num() formate une expression numériquement selon le format numérique défini dans les variables système du script de chargement de données ou sur le système d'exploitation, à moins qu'une chaîne de format ne soit précisée, et insère des séparateurs décimaux et de milliers facultatifs.

Syntax:

Num(number[, format[, dec_sep [, thou_sep]]])

Return data type: double

La fonction Num renvoie une valeur double comportant à la fois la chaîne et le nombre. La fonction prend la valeur numérique de l'expression entrée et génère une chaîne représentant le nombre.

Arguments:

Argument	Description
number	Nombre à formater.
format	Chaîne décrivant la façon dont la chaîne résultante doit être formatée. En cas d'omission, c'est le format de nombre défini dans le système d'exploitation qui est utilisé.
dec_sep	Chaîne indiquant le séparateur de nombres décimaux. En cas d'omission, la valeur MoneyDecimalSep définie dans le script de chargement de données est utilisée.
thou_sep	Chaîne indiquant le séparateur de milliers. En cas d'omission, la valeur MoneyThousandSep définie dans le script de chargement de données est utilisée.

Soient les paramètres par défaut suivants dans les exemples ci-dessous :

Paramètre de format numérique 1 : # ##0
Paramètre de format numérique 2 : #,##0

Pour plus d'informations sur le formatage des nombres, voir Conventions relatives aux formats de nombre et d'heure.

Expression de graphique	Résultats	Paramètre 1	Paramètre 2
Num( 35648.375 , '0.0' )	Chaîne	35 648 375	35648.375
Num( 35648.375 , '0.0' )	Nombre	35648375	35648.375
Num( 35648, '#,##0.##', '.' , ',' )	Chaîne	35,648.00	35,648.00
Num( 35648, '#,##0.##', '.' , ',' )	Nombre	35648	35648
Num( pi( ), '0,00' )	Chaîne	3,14	003
Num( pi( ), '0,00' )	Nombre	3.141592653	3.141592653

Script de chargement

Vous pouvez utiliser Num dans un script de chargement afin de formater un nombre, même si le séparateur de milliers et le séparateur décimal sont déjà définis dans le script. Le script de chargement ci-dessous comprend un séparateur décimal et un séparateur de milliers spécifiques, mais utilise cependant Num pour formater les données de différentes façons.

Dans l'éditeur de chargement de données, créez une section, puis ajoutez et exécutez l'exemple de script. Ensuite, ajoutez au moins les champs répertoriés dans la colonne des résultats à une feuille de votre application afin de visualiser le résultat.

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

Résultats

Table Qlik Sense affichant les résultats de différentes utilisations de la fonction Num dans le script de chargement. À titre d'exemple, la quatrième colonne de la table contient une utilisation de formatage incorrecte.
Aucun formatage	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

Script de chargement

Vous pouvez utiliser Num dans un script de chargement afin de formater un nombre sous forme de pourcentage.

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

Résultats

Table Qlik Sense affichant les résultats de la fonction Num utilisée dans le script de chargement en vue de formater les pourcentages.
discount	Discount #,##0%
0.333333333333333	33%
0.22	22%
0	0%
.14	14%
0.1	10%
0	0%
75	7,500%