Num — funkcja skryptu i funkcja wykresu

Funkcja Num() formatuje liczbę, to znaczy konwertuje wartość liczbową danych wejściowych na wyświetlany tekst przy użyciu formatu określonego w drugim parametrze. Jeśli drugi parametr zostanie pominięty, używa separatorów dziesiętnych i tysięcznych ustawionych w skrypcie ładowania danych. Parametrami opcjonalnymi są niestandardowe symbole separatora dziesiętnego i separatora tysięcy.

Składnia:

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

Typ zwracanych danych: dual

Funkcja Num zwraca wartość podwójną z ciągiem i wartością liczbową. Funkcja pobiera wartość liczbową wyrażenia wejściowego i generuje ciąg reprezentujący liczbę.

Argumenty
Argument	Opis
number	Tekstowy ciąg znaków do oceny.
format	Ciąg określający sposób formatowania otrzymywanego ciągu. W przypadku pominięcia zostaną użyte separatory dziesiętne i tysięcy ustawione w skrypcie ładowania danych. Funkcja Num obsługuje wiele opcji formatu dla różnych struktur liczbowych, na przykład: #,##0: Wyświetla liczbę bez miejsc dziesiętnych. #,##0.00: wyświetla liczbę z dwoma miejscami dziesiętnymi. ##0.00%: wyświetla liczbę jako wartość procentową z dwoma miejscami dziesiętnymi. #,##0;(#,##0): formatuje wartości ujemne w nawiasach. $#,##0.00: Formatuje liczby jako walutę z symbolem $. 0.00E+0: Wyświetla liczby w notacji naukowej.
dec_sep	Ciąg znaków określający separator dziesiętny. W przypadku pominięcia zostanie użyta wartość zmiennej DecimalSep ustawiona w skrypcie ładowania danych. Funkcja Num obsługuje wiele formatów separatorów dziesiętnych, np: Przecinek „,”: na przykład $1,000,00 w przypadku tysiąca dolarów. Kropka „.”: na przykład € 1,000.00. Łącznik „-”: używany zamiast tradycyjnej kropki lub przecinka jako separatora dziesiętnego, wyświetla wartości w taki sposób: ¥1,000-00. Więcej informacji zawiera temat DecimalSep.
thou_sep	Ciąg znaków określający separator tysięcy. W przypadku pominięcia zostanie użyta wartość zmiennej ThousandSep ustawiona w skrypcie ładowania danych. Funkcja Num obsługuje wiele opcji separatora tysięcy: Kropka „.”: używa kropki jako separatora tysięcy (typowe w niektórych formatach europejskich), wyświetlając w formie $1.000,00 w połączeniu z przecinkiem jako separatorem dziesiętnym. Spacja Space „ ”: używa spacji jako separatora tysięcy, co jest typowe w niektórych krajach europejskich. Wygląda tak: € 1 000.00. Znak podkreślenia „_”: używa znaku podkreślenia jako separatora tysięcy, który jest czasami używany w formatach technicznych lub specyficznych formatach regionalnych. Wyświetla wartości w takiej formie: $1_000.00. Więcej informacji zawiera temat ThousandSep.

Więcej informacji o formatowaniu liczb zawiera temat Konwencje formatów liczb i godzin.

Przykład: wyrażenia wykresu
Przykład	Wyniki (zwrócona wartość łańcuchowa)
Num(35648.312)	Zwraca 35648.312 (zależy od zmiennych środowiskowych w skrypcie)
Num(35648.312, '0.0', '.')	Zwraca wartość 35648.3
Num(35648.312, '0,00', ',')	Zwraca wartość 3,56,48
Num(35648.312, '#,##0.0', '.', ',')	Zwraca wartość 35,648.3
Num(35648.312, '# ##0', ',', ' ')	Zwraca wartość 35 648

Przykład — podstawy wartości numerycznych

Przegląd

Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej sekcji.

Skrypt ładowania zawiera:

Zestaw danych załadowany do tabeli o nazwie Example.
Następujące pole w tabeli danych:
- InputValue

Skrypt ładowania

Example:
Load * inline [
InputValue
35648
3564800
356.48
];

Wyniki

Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj to pole jako wymiar:

InputValue

Utwórz następujące miary:

=Num(InputDate), aby wyświetlić wartość jako liczbę sformatowaną przy użyciu ustawienia systemowego.
=Num(InputValue, '0.0', '.'), aby wyświetlić wartość jako liczbę sformatowaną przy użyciu formatu podanego w funkcji.
=Num(InputValue, '0,00', ','), aby wyświetlić wartość jako liczbę sformatowaną przy użyciu formatu podanego w funkcji.
=Num(InputValue, '#,##0.0', '.', ','), aby wyświetlić wartość jako liczbę sformatowaną przy użyciu formatu podanego w funkcji.
=Num(InputValue, '# ##0', ',', ' '), aby wyświetlić wartość jako liczbę sformatowaną przy użyciu formatu podanego w funkcji.

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

Wyniki pokazują, w jaki sposób funkcja Num może wyświetlać wartości pola InputValue na podstawie formatu podanego w wyrażeniu funkcji.

Funkcja Num może być używana w skrypcie ładowania w celu formatowania liczb, nawet jeśli separatory tysięcy i dziesiętne są już ustawione w skrypcie. Poniższy skrypt ładowania zawiera konkretne separatory tysięcy i dziesiętne, a następnie używa funkcji Num w celu formatowania danych na inne sposoby.

Skrypt ładowania

W edytorze Edytor ładowania danych utwórz nową sekcję, a następnie dodaj skrypt przykładowy i uruchom go. Następnie dodaj do arkusza w swojej aplikacji co najmniej pola wyszczególnione w tabeli wyników, aby wyświetlić wynik.

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

Wyniki

Tabela aplikacji Qlik Sense pokazująca wyniki różnych zastosowań funkcji Num w skrypcie ładowania. Czwarta kolumna tabeli zawiera niepoprawne użycie formatowania — do celów przykładowych.
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

Przykład — zastosowanie wartości liczbowych

Przegląd

Kontener zawiera dane sprzedaży, które mają być prezentowane w prostszym formacie liczbowym.

Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej sekcji.

Skrypt ładowania zawiera:

Zestaw danych załadowany do tabeli o nazwie Example.
Tabela zawiera następujące pola:
- Customer
- Sales

Skrypt ładowania

Example:
Load * inline [
Customer, Sales
Customer A, 2550000
Customer B, 12500
Customer C, 15000
Customer D, 250
];

Wyniki

Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj to pole jako wymiar:

Customer

Utwórz następującą miarę:

=If(Sales > 1000000, Num(Sales/1000000, '#,##0.00M'), If(Sales > 1000, Num(Sales/1000, '#,##0.00K'), Num(Sales, '#,##0.00'))), aby ustawić numeryczną reprezentację wartości.

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

Wyrażenie miary w kolumnie 2 wykorzystuje funkcję Num do przedstawienia danych w uproszczonym formacie liczbowym.

Funkcja Num może być używana w skrypcie ładowania w celu sformatowania liczby jako procentu.

Skrypt ładowania

W edytorze ładowania danych utwórz nową sekcję, a następnie dodaj skrypt przykładowy i uruchom go. Następnie dodaj do arkusza w swojej aplikacji pola wyszczególnione w kolumnie wyników, aby wyświetlić wynik.

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

Tabela aplikacji Qlik Sense pokazująca wyniki funkcji Num używanej w skrypcie ładowania w celu formatowania procentów.
Discount	Discount #,##0%
0	0%
0.1	10%
0.22	22%
0	0%
75	7,500%
0.333333333333333	33%
.14	14%

Czy ta strona była pomocna?

Jeżeli natkniesz się na problemy z tą stroną lub jej zawartością — literówkę, brakujący krok lub błąd techniczny — daj nam znać, co możemy poprawić!

Przekaż tu opinię