formatnumber(value, format, culture) returns string
Presenteert een getal in de gespecificeerde opmaak.Functie
Argument | Types | Omschrijving |
---|---|---|
value | double, integer | Getal. |
format | string | Opmaakspecificatie, bijvoorbeeld "#.##", of een standaard opmaak zoals "F" of "G". |
culture | string | Taal en land, bijvoorbeeld "nl", "nl-NL", "nl-BE", "en", "en-US" or "en-GB". |
Result | string | Tekstfragment met het opgemaakte getal. |
Omschrijving
Algemeen te gebruiken als formatnumber( [numeriekveld] , format, culture )
Cultures |
Voorbeeld |
|
De cultures volgen de MSDN werkwijze. De culture bestaat uit 2 delen gescheiden door een "-". |
nl |
|
Het eerste deel verwijst naar een taal, het tweede deel verwijst naar een regio of land. |
nl-BE |
|
In een formatnumber of formatdatetime bepaalt de culture de eigenschappen voor datum weergave |
nl-NL |
|
en getalweergave zoals gebruikelijk voor die taal en regio/land |
fr-FR |
|
Een regio/land kan eventueel worden weggelaten. |
en-GB |
|
en-US |
||
Standaard numerieke formaten : te gebruiken om een getal als geheel op te maken in een bepaald formaat |
||
Format specifier |
Omschrijving |
Voorbeeld |
C of c |
Bedrag notatie. Een getal achter de format specifier geeft het aantal weer te geven decimalen aan |
(123.456,"C", "en-US") -> $123.46 |
(123.456 ,"C", "fr-FR") -> 123,46 € |
||
(123.456 ,"C", "ja-JP") -> ¥123 |
||
(-123.456 ,"C3", "en-US") -> ($123.456) |
||
(-123.456 ,"C3", "fr-FR") -> -123,456 € |
||
(-123.456 ,"C3", "ja-JP") -> -¥123.456 |
||
D of d |
Integer weergave, eventueel met - teken bij negatieve integers Een getal achter de format specifier geeft het aantal weer te geven decimalen aan |
(1234, "D") -> 1234 |
(-1234, "D6") -> -001234 |
||
E of e |
Exponentiele notatie. Een getal achter de format specifier geeft het aantal weer te geven decimalen aan |
(1052.0329112756,"E", "en-US") -> 1.052033E+003 |
(1052.0329112756 ,"e", "fr-FR") -> 1,052033e+003 |
||
(-1052.0329112756, "e2", "en-US") -> -1.05e+003 |
||
(-1052.0329112756 , "E2", "fr_FR") -> -1,05E+003 |
||
F of f |
Floating weergave, getal met decimale punt |
(1234.567 , "F", "en-US") -> 1234.57 |
(1234.567, "F", "de-DE") -> 1234,57 |
||
(1234 , "F1", "en-US") -> 1234.0 |
||
(1234 ., "F1", "de-DE") -> 1234,0 |
||
(-1234.56 , "F4", "en-US") -> -1234.5600 |
||
(-1234.56 , "F4", "de-DE") -> -1234,5600 |
||
N of n |
Opmaak met duizendtallen en decimalen separator. Een getal achter de format specifier geeft het aantal weer te geven decimalen aan |
(1234.567 , "N", "en-US") -> 1,234.57 |
(1234.567 , "N", "ru-RU") -> 1 234,57 |
||
(1234 , "N1", "en-US") -> 1,234.0 |
||
(1234 , "N1", "ru-RU") -> 1 234,0 |
||
(-1234.56, "N3", "en-US") -> -1,234.560 |
||
(-1234.56 ,"N3", "ru-RU") -> -1 234,560 |
||
P of p |
Pecentage weergave. Het te formatten getal wordt eerst vermenigvuldigd met 100 en dan weergegeven met een % teken. en getal achter de format specifier geeft het aantal weer te geven decimalen aan |
(1 , "P", "en-US") -> 100.00 % |
(1, "P", "fr-FR") -> 100,00 % |
||
(-0.39678, "P1", "en-US") -> -39.7 % |
||
(-0.39678 ,"P1", "fr-FR") -> -39,7 % |
||
X of x |
Hexadecimale weergave |
(255, "X") -> FF |
(-1, "x") -> ff |
||
(255 ,"x4") -> 00ff |
||
(-1 ,"X4") -> 00FF |
||
Custom numerieke formaten : te gebruiken om iedere positie van een getal apart op te kunnen maken. |
||
Format specifier |
Omschrijving |
Voorbeeld |
"0" |
Het 0 sysmbool wordt vervangen door een cijfer uit het getal, als op die positie een cijfer aanwezig is, anders verschijnt een nul. |
(1234.5678 ,"00000") -> 01235 |
(0.45678 ,"0.00", "en-US") -> 0.46 |
||
(0.45678 ,"0.00", "fr-FR") -> 0,46 |
||
"#" |
Het #sysmbool wordt vervangen door een cijfer uit het getal, als op die positie een cijfer aanwezig is, anders verschijnt geen cijfer. |
(1234.5678 ,"#####") -> 1235 |
(0.45678 ,"#.##", "en-US") -> .46 |
||
(0.45678 ,"#.##", "fr-FR") -> ,46 |
||
"." |
Bepaalt de plaats van een decimale punt |
(0.45678 ,"0.00", "en-US") -> 0.46 |
(0.45678 ,"0.00", "fr-FR") -> 0,46 |
||
"," |
Bepaalt de plaats van een duizendtal separator |
(2147483647 , "##,#", "en-US") -> 2,147,483,647 |
(2147483647 ,"##,#", "es-ES") -> 2.147.483.647 |
||
"%" |
Percentage weergave |
(0.3697 ,"%#0.00", "en-US") -> %36.97 |
(0.3697 ,"%#0.00", "el-GR") -> %36,97 |
||
(0.3697 ,"##.0 %", "en-US") -> 37.0 % |
||
(0.3697 ,"##.0 %", "el-GR") -> 37,0 % |
||
"‰" |
Promille weergave |
(0.03697, "#0.00‰", "en-US") -> 36.97‰ |
(0.03697 ,"#0.00‰", "ru-RU") -> 36,97‰ |
||
Andere tekens |
Worden overgenomen in het uiteindelijke resultaat |
(68 ,"# °") -> 68 ° |
Voorbeelden
formatnumber(123, "C", "nl") = "€ 123,00"
formatnumber(123, "C", "en-US") = "$123.00"
formatnumber(123, "D", "") = "123"
formatnumber(123, "d", "") = "123"
formatnumber(123, "D4", "") = "0123"
formatnumber(-123, "D4", "") = "-0123"
formatnumber(123, "E", "") = "1.230000E+002"
formatnumber(123, "E", "nl-NL") = "1,230000E+002"
formatnumber(123, "E3", "nl") = "1,230E+002"
formatnumber(123, "F1", "nl") = "123,0"
formatnumber(123, "G", "") = "123"
formatnumber(1234567, "N", "nl") = "1.234.567,00"
formatnumber(123, "X", "") = "7B"
formatnumber(123, "00000", "") = "00123"
formatnumber(100.23, "#.000", "nl") = "100,230"
formatnumber(1234567, "#,###,###,###", "nl") = "1.234.567"