natural.number

natural.number.double(value, digits=2)

Converts a number to a formatted double based on the current locale.

Parameters:

• value – number
• digits – default 2

>>> double(42)
'42.00'
>>> double(42, digits=1)
'42.0'
>>> double(12.34)
'12.34'
>>> double(1234.56)
'1,234.56'

natural.number.number(value)

Converts a number to a formatted number based on the current locale.

Parameters:value – number

>>> number(42)
'42'
>>> number(12.34)
'12'
>>> number(1234)
'1,234'
>>> number(1234567)
'1,234,567'

natural.number.ordinal(value)

Converts a number to its ordinal representation.

Parameters:value – number

>>> ordinal(1)
'1st'
>>> ordinal(11)
'11th'
>>> ordinal(101)
'101st'
>>> ordinal(104)
'104th'
>>> ordinal(113)
'113th'
>>> ordinal(123)
'123rd'

natural.number.percentage(value, digits=2)

Converts a fraction to a formatted percentage.

Parameters:

• value – number
• digits – default 2

>>> percentage(1)
'100.00 %'
>>> percentage(0.23, digits=0)
'23 %'
>>> percentage(23.421)
'2,342.10 %'

natural.number.word(value, digits=2)

Converts a large number to a formatted number containing the textual suffix for that number.

Parameters:value – number

>>> word(1)
'1'
>>> word(123456789)
'123.46 million'