Num# - 指令碼與圖表函數
Num#() 將文字字串解譯為數值,亦即使用第二參數指定的格式將輸入字串轉換為數字。若省略第二參數,這會使用資料載入指令碼中設定的小數點和千位分隔符號。自訂小數與千位分隔符號是選用參數。
語法:
Num#(text[, format[, dec_sep [, thou_sep ] ] ])
傳回的資料類型: 雙值
Num#() 函數會傳回含有字串和數值的雙值。該函數採用輸入運算式的文字表示,並產生數字。這不會變更數字格式;輸出的格式化方式與輸入相同。
引數 | 描述 |
---|---|
text | 要評估的文字字串。 |
format | 指示第一個參數使用的數字格式的字串。如果省略,會使用資料載入指令碼中設定的小數點和千位分隔符號。 Num# 函數支援多種不同數字結構的格式選項,例如: #,##0:顯示沒有小數位數的數字。 #,##0.00:顯示有兩位小數的數字。 ##0.00%:以百分比顯示有兩位小數的數字。 #,##0;(#,##0):格式化負值以顯示在括號中。 $#,##0.00:使用 $ 符號將數字格式化為貨幣。 0.00E+0:以科學標記法顯示數字。 |
dec_sep | 指定小數點位數分隔符號的字串。如果省略,則會使用資料載入指令碼中設定的變數 DecimalSep 的值。 Num# 函數支援多種小數分隔符號格式,例如: 逗號「,」:例如 $1,000,00 表示一千美元。 句號「. 」:例如 € 1,000.00。 連字符「-」:若用來代替傳統的句號或逗號作為小數點分隔符號,這會顯示類似 ¥1,000-00 的值。 如需詳細資訊,請參閱DecimalSep。 |
thou_sep | 指定千位分隔符號的字串。如果省略,則會使用資料載入指令碼中設定的變數 ThousandSep 的值。 Num# 函數支援千位數字分隔符號的多種選項: 句號「.」:使用句號作為千位分隔符號 (在某些歐洲格式中很常見),如果與逗號小數點分隔符號搭配則顯示為 $1.000,00 。 空格「 」:使用空格作為千位分隔符號,這在一些歐洲國家很常見。顯示為 € 1 000.00。 底線「_」:使用底線作為千位分隔符號,這有時候用於技術或特定區域格式。顯示像 $1_000.00 這樣的值。 如需詳細資訊,請參閱ThousandSep。 |
範例 | 結果 (傳回的字串值) |
---|---|
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 的字串和 NULL (-) 的數值。 |
Num#( '35 648,31234', '#', '.' , ',' ) | 傳回 35 648,31234 的字串和 NULL (-) 的數值。 |
Num#('1,234.56', '#,##0.00') | 傳回 1,234.56 的字串和 1230.45 的數值。 |
Num#('$1,230.45', '$#,##0.00') | 傳回 $1,230.45 的字串和 1234.56 的數值。 |
Num#('20220315', 'YYYYMMDD') | 傳回 20220315 的字串和 20220315 的數值。 |