# 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: wartość podwójna 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](https://help.qlik.com/pl-PL/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Scripting/NumberInterpretationVariables/DecimalSep.htm). | | 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](https://help.qlik.com/pl-PL/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Scripting/NumberInterpretationVariables/ThousandSep.htm). | Więcej informacji o formatowaniu liczb zawiera temat [Konwencje formatów liczb i godzin](https://help.qlik.com/pl-PL/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm). 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 [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm) #### Wyrażenie wykresu 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. [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm) #### Skrypt ładowania 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 SenseQlik Sense pokazująca wyniki różnych zastosowań funkcji NumNum 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 [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm) #### Wyrażenie wykresu 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. [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Num.htm) #### Skrypt ładowania 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 SenseQlik Sense pokazująca wyniki funkcji `Num`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% |