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"