Money# — funkcja skryptu i funkcja wykresu
Funkcja Money#() konwertuje ciąg znaków na wartość pieniężną w formacie ustawionym w skrypcie ładowania lub systemie operacyjnym, chyba że podano format ciągu znaków. Parametrami opcjonalnymi są niestandardowe symbole separatora dziesiętnego i separatora tysięcy.
Składnia:
Money#(text[, format[, dec_sep [, thou_sep ] ] ])
Typ zwracanych danych: wartość podwójna
| Argument | Opis |
|---|---|
| text | Tekstowy ciąg znaków do oceny. |
| format | Ciąg znaków opisujący spodziewany format danych wejściowych, który ma być użyty podczas konwertowania tego ciągu na interwał liczbowy. W przypadku pominięcia dla MoneyFormat zostanie użyta wartość ustawiona w skrypcie ładowania danych. Funkcja Money# obsługuje wiele opcji formatu dla różnych struktur pieniężnych, na przykład: $#,##0.00: dodaje znak dolara i dwa miejsca po przecinku. € #,##0: dodaje znak euro bez miejsc po przecinku, ze spacją po znaku euro. ¥#,##0: dodaje japoński znak jena bez miejsc dziesiętnych. $#,##0;($#,##0): formatuje wartości ujemne w nawiasach. ₣ #.##0,00: Dodaje znak franka szwajcarskiego z kropkami jako separatorami tysięcy i przecinkiem dla separatorów dziesiętnych (na przykład ₣ 1.000,00). R #,##0.00: znak randa południowoafrykańskiego z dwoma miejscami po przecinku i Przestrzenie po symbolu randa. $ #,##0.000: Dodaje trzy miejsca po przecinku do formatu dolara. |
| dec_sep |
Ciąg znaków określający separator dziesiętny. W przypadku pominięcia zostanie użyta wartość MoneyDecimalSep ustawiona w skrypcie ładowania danych.
Funkcja Money# 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. |
| thou_sep |
Ciąg znaków określający separator tysięcy. W przypadku pominięcia zostanie użyta wartość MoneyThousandSep ustawiona w skrypcie ładowania danych. Funkcja Money# 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. |
Funkcja Money# zazwyczaj działa analogicznie do funkcji Num#, ale pobiera domyślne wartości separatora dziesiętnego i separatora tysięcy ze zmiennych skryptu określających format lub ustawień systemowych waluty.
| Przykład | Wyniki |
|---|---|
| Money#('35 648,37 kr' , '# ##0,00 kr',',',' ' ) |
Zwraca 35 648,37 kr, gdy ustawienie MoneyFormat to # ##0,00 kr. Skrypt ładowania musi zawierać następujące ustawienia, aby można było poprawnie ocenić to jako liczbę:
|
| Money#( '$35,648.37', ' $#', '.', ',' ) |
Zwraca $35,648.37 po ustawieniu:
|