PackagesReroutesAboutlamdera.com

cuducos/elm-format-number/3.0.0

NOTE: this package is not compatible with Elm 0.19.1

READMEAboutVersionsSourceModules

FormatNumber

This simple package formats float numbers as pretty strings. It is flexible enough to deal with different number of decimals, different thousand separators and diffetent decimal separator.

format : Locale -> Float -> String

Format a float number as a pretty string:

>>> format { decimals = 2, thousandSeparator = ".", decimalSeparator = "," } 123456.789
"123.456,79"


>>> format { decimals = 2, thousandSeparator = ",", decimalSeparator = "." } 1234.5567
"1,234.56"


>>> import Locales exposing (Locale)
>>> format (Locale 3 "." ",") -7654.3210
"−7.654,321"


>>> import Locales exposing (Locale)
>>> format (Locale 1 "," ".") -0.01
"0.0"


>>> import Locales exposing (Locale)
>>> format (Locale 2 "," ".") 0.01
"0.01"


>>> import Locales exposing (Locale)
>>> format (Locale 0 "," ".") 123.456
"123"


>>> import Locales exposing (Locale)
>>> format (Locale 0 "," ".") 1e9
"1,000,000,000"


>>> import Locales exposing (Locale)
>>> format (Locale 5 "," ".") 1.0
"1.00000"


>>> import Locales exposing (usLocale)
>>> format usLocale pi
"3.14"


>>> import Locales exposing (frenchLocale)
>>> format { frenchLocale | decimals = 4 } pi
"3,1416"


>>> import Locales exposing (frenchLocale)
>>> format frenchLocale 67295
"67 295,000"


>>> import Locales exposing (spanishLocale)
>>> format spanishLocale e
"2,718"


>>> import Locales exposing (spanishLocale)
>>> format spanishLocale 67295
"67.295,000"


>>> import Locales exposing (usLocale)
>>> format usLocale 67295
"67,295.00"

What about Int numbers?

>>> import Locales exposing (usLocale)
>>> format usLocale (toFloat 1234)
"1,234.00"


>>> import Locales exposing (usLocale)
>>> format { usLocale | decimals = 0 } <| toFloat 1234
"1,234"

Known bugs

There are known bugs in how Elm handles large numbers. This library cannot work with large numbers (over 2 ^ 31) until Elm itself is fixed:

>>> format usLocale 1e10
"1,410,065,408.00"

Modules

About this package serverReroutesreroutes.json
Pages and docs rendering from package.elm-lang.org, © 2012-2020 Evan Czaplicki. © 2026 Lamdera