1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
.. -*- mode: rst; encoding: utf-8 -*-
.. _numbers:
=================
Number Formatting
=================
Support for locale-specific formatting and parsing of numbers is provided by
the ``babel.numbers`` module:
.. code-block:: pycon
>>> from babel.numbers import format_number, format_decimal, format_percent
Examples:
.. code-block:: pycon
>>> format_decimal(1.2345, locale='en_US')
u'1.234'
>>> format_decimal(1.2345, locale='sv_SE')
u'1,234'
>>> format_decimal(12345, locale='de_DE')
u'12.345'
Pattern Syntax
==============
While Babel makes it simple to use the appropriate number format for a given
locale, you can also force it to use custom patterns. As with date/time
formatting patterns, the patterns Babel supports for number formatting are
based on the `Locale Data Markup Language specification`_ (LDML).
Examples:
.. code-block:: pycon
>>> format_decimal(-1.2345, format='#,##0.##;-#', locale='en')
u'-1.23'
>>> format_decimal(-1.2345, format='#,##0.##;(#)', locale='en')
u'(1.23)'
The syntax for custom number format patterns is described in detail in the
the specification. The following table is just a relatively brief overview.
.. _`Locale Data Markup Language specification`: http://unicode.org/reports/tr35/#Number_Format_Patterns
+----------+-----------------------------------------------------------------+
| Symbol | Description |
+==========+=================================================================+
| ``0`` | Digit |
+----------+-----------------------------------------------------------------+
| ``1-9`` | '1' through '9' indicate rounding. |
+----------+-----------------------------------------------------------------+
| ``@`` | Significant digit |
+----------+-----------------------------------------------------------------+
| ``#`` | Digit, zero shows as absent |
+----------+-----------------------------------------------------------------+
| ``.`` | Decimal separator or monetary decimal separator |
+----------+-----------------------------------------------------------------+
| ``-`` | Minus sign |
+----------+-----------------------------------------------------------------+
| ``,`` | Grouping separator |
+----------+-----------------------------------------------------------------+
| ``E`` | Separates mantissa and exponent in scientific notation |
+----------+-----------------------------------------------------------------+
| ``+`` | Prefix positive exponents with localized plus sign |
+----------+-----------------------------------------------------------------+
| ``;`` | Separates positive and negative subpatterns |
+----------+-----------------------------------------------------------------+
| ``%`` | Multiply by 100 and show as percentage |
+----------+-----------------------------------------------------------------+
| ``‰`` | Multiply by 1000 and show as per mille |
+----------+-----------------------------------------------------------------+
| ``¤`` | Currency sign, replaced by currency symbol. If doubled, |
| | replaced by international currency symbol. If tripled, uses the |
| | long form of the decimal symbol. |
+----------+-----------------------------------------------------------------+
| ``'`` | Used to quote special characters in a prefix or suffix |
+----------+-----------------------------------------------------------------+
| ``*`` | Pad escape, precedes pad character |
+----------+-----------------------------------------------------------------+
Parsing Numbers
===============
Babel can also parse numeric data in a locale-sensitive manner:
.. code-block:: pycon
>>> from babel.numbers import parse_decimal, parse_number
Examples:
.. code-block:: pycon
>>> parse_decimal('1,099.98', locale='en_US')
1099.98
>>> parse_decimal('1.099,98', locale='de')
1099.98
>>> parse_decimal('2,109,998', locale='de')
Traceback (most recent call last):
...
NumberFormatError: '2,109,998' is not a valid decimal number
.. note:: Number parsing is not properly implemented yet
|