Funkcja Num#() interpretuje ciąg tekstowy jako wartość liczbową, to znaczy konwertuje ciąg wejściowy na liczbę 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#(text[, 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 reprezentację tekstową wyrażenia wejściowego i generuje liczbę. Nie zmienia formatu liczby: dane wyjściowe są sformatowane tak samo jak dane wejściowe.
Argumenty:
| Argument | Opis |
|---|---|
| text | Tekstowy ciąg znaków do oceny. |
| format |
Ciąg określający format liczb używany w pierwszym parametrze. W przypadku pominięcia zostaną użyte separatory dziesiętne i tysięcy ustawione w skrypcie ładowania danych. |
| 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. |
| 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. |
W poniższej tabeli przedstawiono wynik Num#( A, '#', '.' , ',') dla różnych wartości A.
| Przykład | Wynik (ciąg) | Wynik (liczba) |
|---|---|---|
| Num#( '35,648.31', '#', '.' , ',' ) | 35,648.31 | 35648.31 |
| Num#( ‘35 648.312’, '#', '.' , ',' ) | 35 648.312 | 35648.312 |
| Num#( '35.648,3123', '#', '.' , ',' ) | 35.648,3123 | - |
| Num#( '35 648,31234', '#', '.' , ',' ) | 35 648,31234 | - |
| Num#('1,234.56', '#,##0.00') | 1,234.56 | 1234.56 |
| Num#('$1,230.45', '$#,##0.00') | $1,230.45 | 1230.45 |
| Num#('20220315', 'YYYYMMDD') | 20220315 | 20220315 |