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

>>> print(double(42))
42.00
>>> print(double(42, digits=1))
42.0
>>> print(double(12.34))
12.34
>>> print(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

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

natural.number.ordinal(value)

Converts a number to its ordinal representation.

Parameters:value – number

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

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

Converts a fraction to a formatted percentage.

Parameters:

• value – number
• digits – default 2

>>> print(percentage(1))
100.00 %
>>> print(percentage(0.23, digits=0))
23 %
>>> print(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

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