Mercurial > babel > old > mirror

annotate babel/numbers.py @ 235:d0cd235ede46

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Upgraded to CLDR 1.5 and improved timezone formatting.
author cmlenz
date Wed, 01 Aug 2007 12:32:20 +0000
parents ce3ad60145db
children d462423feeea
rev   line source
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
1 # -*- coding: utf-8 -*-
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
2 #
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
3 # Copyright (C) 2007 Edgewall Software
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
4 # All rights reserved.
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
5 #
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
6 # This software is licensed as described in the file COPYING, which
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
7 # you should have received as part of this distribution. The terms
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
8 # are also available at http://babel.edgewall.org/wiki/License.
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
9 #
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
10 # This software consists of voluntary contributions made by many
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
11 # individuals. For the exact contribution history, see the revision
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
12 # history and logs, available at http://babel.edgewall.org/log/.
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
13
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
14 """Locale dependent formatting and parsing of numeric data.
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
15
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
16 The default locale for the functions in this module is determined by the
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
17 following environment variables, in that order:
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
18
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
19 * ``LC_NUMERIC``,
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
20 * ``LC_ALL``, and
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
21 * ``LANG``
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
22 """
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
23 # TODO: percent and scientific formatting
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
24
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
25 import re
220
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
26 try:
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
27 from decimal import Decimal
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
28 have_decimal = True
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
29 except ImportError:
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
30 have_decimal = False
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
31
74
d9c34d2f3d1d More explicit module-level function names in `babel.core`. Added `Locale.negotiate` class method.
cmlenz
parents: 52
diff changeset
32 from babel.core import default_locale, Locale
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
33
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
34 __all__ = ['format_number', 'format_decimal', 'format_currency',
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
35 'format_percent', 'format_scientific', 'parse_number',
34
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
36 'parse_decimal', 'NumberFormatError']
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
37 __docformat__ = 'restructuredtext en'
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
38
74
d9c34d2f3d1d More explicit module-level function names in `babel.core`. Added `Locale.negotiate` class method.
cmlenz
parents: 52
diff changeset
39 LC_NUMERIC = default_locale('LC_NUMERIC')
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
40
127
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
41 def get_currency_symbol(currency, locale=LC_NUMERIC):
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
42 """Return the symbol used by the locale for the specified currency.
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
43
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
44 >>> get_currency_symbol('USD', 'en_US')
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
45 u'$'
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
46
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
47 :param currency: the currency code
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
48 :param locale: the `Locale` object or locale identifier
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
49 :return: the currency symbol
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
50 :rtype: `unicode`
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
51 """
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
52 return Locale.parse(locale).currency_symbols.get(currency, currency)
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
53
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
54 def get_decimal_symbol(locale=LC_NUMERIC):
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
55 """Return the symbol used by the locale to separate decimal fractions.
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
56
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
57 >>> get_decimal_symbol('en_US')
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
58 u'.'
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
59
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
60 :param locale: the `Locale` object or locale identifier
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
61 :return: the decimal symbol
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
62 :rtype: `unicode`
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
63 """
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
64 return Locale.parse(locale).number_symbols.get('decimal', u'.')
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
65
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
66 def get_group_symbol(locale=LC_NUMERIC):
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
67 """Return the symbol used by the locale to separate groups of thousands.
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
68
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
69 >>> get_group_symbol('en_US')
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
70 u','
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
71
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
72 :param locale: the `Locale` object or locale identifier
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
73 :return: the group symbol
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
74 :rtype: `unicode`
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
75 """
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
76 return Locale.parse(locale).number_symbols.get('group', u',')
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
77
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
78 def format_number(number, locale=LC_NUMERIC):
103
1ba215a5774d Add wrapper class bundling the various formatting functions bound to a specific locale and time-zone.
cmlenz
parents: 74
diff changeset
79 """Return the given number formatted for a specific locale.
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
80
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
81 >>> format_number(1099, locale='en_US')
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
82 u'1,099'
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
83
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
84 :param number: the number to format
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
85 :param locale: the `Locale` object or locale identifier
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
86 :return: the formatted number
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
87 :rtype: `unicode`
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
88 """
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
89 # Do we really need this one?
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
90 return format_decimal(number, locale=locale)
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
91
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
92 def format_decimal(number, format=None, locale=LC_NUMERIC):
103
1ba215a5774d Add wrapper class bundling the various formatting functions bound to a specific locale and time-zone.
cmlenz
parents: 74
diff changeset
93 """Return the given decimal number formatted for a specific locale.
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
94
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
95 >>> format_decimal(1.2345, locale='en_US')
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
96 u'1.234'
52
4df5e8994657 Added round-half-even (banker's rounding) support.
jonas
parents: 41
diff changeset
97 >>> format_decimal(1.2346, locale='en_US')
4df5e8994657 Added round-half-even (banker's rounding) support.
jonas
parents: 41
diff changeset
98 u'1.235'
4df5e8994657 Added round-half-even (banker's rounding) support.
jonas
parents: 41
diff changeset
99 >>> format_decimal(-1.2346, locale='en_US')
4df5e8994657 Added round-half-even (banker's rounding) support.
jonas
parents: 41
diff changeset
100 u'-1.235'
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
101 >>> format_decimal(1.2345, locale='sv_SE')
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
102 u'1,234'
52
4df5e8994657 Added round-half-even (banker's rounding) support.
jonas
parents: 41
diff changeset
103 >>> format_decimal(12345, locale='de')
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
104 u'12.345'
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
105
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
106 The appropriate thousands grouping and the decimal separator are used for
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
107 each locale:
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
108
127
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
109 >>> format_decimal(12345.5, locale='en_US')
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
110 u'12,345.5'
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
111
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
112 :param number: the number to format
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
113 :param format:
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
114 :param locale: the `Locale` object or locale identifier
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
115 :return: the formatted decimal number
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
116 :rtype: `unicode`
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
117 """
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
118 locale = Locale.parse(locale)
127
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
119 if not format:
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
120 format = locale.decimal_formats.get(format)
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
121 pattern = parse_pattern(format)
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
122 return pattern.apply(number, locale)
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
123
127
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
124 def format_currency(number, currency, format=None, locale=LC_NUMERIC):
135
5969b610d0ec Minor doc fixes.
cmlenz
parents: 129
diff changeset
125 u"""Return formatted currency value.
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
126
34
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
127 >>> format_currency(1099.98, 'USD', locale='en_US')
127
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
128 u'$1,099.98'
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
129 >>> format_currency(1099.98, 'USD', locale='es_CO')
235
d0cd235ede46 Upgraded to CLDR 1.5 and improved timezone formatting.
cmlenz
parents: 220
diff changeset
130 u'US$ 1.099,98'
127
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
131 >>> format_currency(1099.98, 'EUR', locale='de_DE')
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
132 u'1.099,98 \\u20ac'
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
133
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
134 The pattern can also be specified explicitly:
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
135
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
136 >>> format_currency(1099.98, 'EUR', u'\xa4\xa4 #,##0.00', locale='en_US')
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
137 u'EUR 1,099.98'
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
138
28
695884591af6 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime.
cmlenz
parents: 24
diff changeset
139 :param number: the number to format
34
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
140 :param currency: the currency code
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
141 :param locale: the `Locale` object or locale identifier
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
142 :return: the formatted currency value
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
143 :rtype: `unicode`
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
144 """
127
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
145 locale = Locale.parse(locale)
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
146 if not format:
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
147 format = locale.currency_formats.get(format)
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
148 pattern = parse_pattern(format)
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
149 return pattern.apply(number, locale, currency=currency)
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
150
28
695884591af6 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime.
cmlenz
parents: 24
diff changeset
151 def format_percent(number, format=None, locale=LC_NUMERIC):
103
1ba215a5774d Add wrapper class bundling the various formatting functions bound to a specific locale and time-zone.
cmlenz
parents: 74
diff changeset
152 """Return formatted percent value for a specific locale.
24
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
153
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
154 >>> format_percent(0.34, locale='en_US')
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
155 u'34%'
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
156 >>> format_percent(25.1234, locale='en_US')
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
157 u'2,512%'
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
158 >>> format_percent(25.1234, locale='sv_SE')
235
d0cd235ede46 Upgraded to CLDR 1.5 and improved timezone formatting.
cmlenz
parents: 220
diff changeset
159 u'2\\xa0512\\xa0%'
24
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
160
128
24a711a3c174 Add test for permille number format.
cmlenz
parents: 127
diff changeset
161 The format pattern can also be specified explicitly:
24a711a3c174 Add test for permille number format.
cmlenz
parents: 127
diff changeset
162
24a711a3c174 Add test for permille number format.
cmlenz
parents: 127
diff changeset
163 >>> format_percent(25.1234, u'#,##0\u2030', locale='en_US')
24a711a3c174 Add test for permille number format.
cmlenz
parents: 127
diff changeset
164 u'25,123\u2030'
24a711a3c174 Add test for permille number format.
cmlenz
parents: 127
diff changeset
165
24
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
166 :param number: the percent number to format
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
167 :param format:
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
168 :param locale: the `Locale` object or locale identifier
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
169 :return: the formatted percent number
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
170 :rtype: `unicode`
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
171 """
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
172 locale = Locale.parse(locale)
127
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
173 if not format:
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
174 format = locale.percent_formats.get(format)
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
175 pattern = parse_pattern(format)
28
695884591af6 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime.
cmlenz
parents: 24
diff changeset
176 return pattern.apply(number, locale)
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
177
28
695884591af6 * Reduce size of locale data pickles by only storing the data provided by each locale itself, and merging inherited data at runtime.
cmlenz
parents: 24
diff changeset
178 def format_scientific(number, locale=LC_NUMERIC):
128
24a711a3c174 Add test for permille number format.
cmlenz
parents: 127
diff changeset
179 # TODO: implement
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
180 raise NotImplementedError
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
181
34
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
182
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
183 class NumberFormatError(ValueError):
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
184 """Exception raised when a string cannot be parsed into a number."""
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
185
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
186
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
187 def parse_number(string, locale=LC_NUMERIC):
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
188 """Parse localized number string into a long integer.
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
189
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
190 >>> parse_number('1,099', locale='en_US')
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
191 1099L
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
192 >>> parse_number('1.099', locale='de_DE')
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
193 1099L
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
194
34
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
195 When the given string cannot be parsed, an exception is raised:
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
196
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
197 >>> parse_number('1.099,98', locale='de')
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
198 Traceback (most recent call last):
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
199 ...
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
200 NumberFormatError: '1.099,98' is not a valid number
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
201
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
202 :param string: the string to parse
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
203 :param locale: the `Locale` object or locale identifier
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
204 :return: the parsed number
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
205 :rtype: `long`
34
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
206 :raise `NumberFormatError`: if the string can not be converted to a number
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
207 """
34
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
208 try:
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
209 return long(string.replace(get_group_symbol(locale), ''))
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
210 except ValueError:
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
211 raise NumberFormatError('%r is not a valid number' % string)
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
212
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
213 def parse_decimal(string, locale=LC_NUMERIC):
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
214 """Parse localized decimal string into a float.
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
215
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
216 >>> parse_decimal('1,099.98', locale='en_US')
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
217 1099.98
34
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
218 >>> parse_decimal('1.099,98', locale='de')
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
219 1099.98
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
220
34
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
221 When the given string cannot be parsed, an exception is raised:
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
222
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
223 >>> parse_decimal('2,109,998', locale='de')
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
224 Traceback (most recent call last):
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
225 ...
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
226 NumberFormatError: '2,109,998' is not a valid decimal number
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
227
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
228 :param string: the string to parse
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
229 :param locale: the `Locale` object or locale identifier
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
230 :return: the parsed decimal number
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
231 :rtype: `float`
34
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
232 :raise `NumberFormatError`: if the string can not be converted to a
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
233 decimal number
3
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
234 """
e9eaddab598e Import of initial code base.
cmlenz
parents:
diff changeset
235 locale = Locale.parse(locale)
34
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
236 try:
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
237 return float(string.replace(get_group_symbol(locale), '')
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
238 .replace(get_decimal_symbol(locale), '.'))
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
239 except ValueError:
8b6804eac9e5 Started docs on number formatting/parsing.
cmlenz
parents: 28
diff changeset
240 raise NumberFormatError('%r is not a valid decimal number' % string)
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
241
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
242
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
243 PREFIX_END = r'[^0-9@#.,]'
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
244 NUMBER_TOKEN = r'[0-9@#.\-,E]'
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
245
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
246 PREFIX_PATTERN = r"(?P<prefix>(?:'[^']*'|%s)*)" % PREFIX_END
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
247 NUMBER_PATTERN = r"(?P<number>%s+)" % NUMBER_TOKEN
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
248 SUFFIX_PATTERN = r"(?P<suffix>.*)"
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
249
129
d6aef0675953 Add a couple of CLI tests.
cmlenz
parents: 128
diff changeset
250 number_re = re.compile(r"%s%s%s" % (PREFIX_PATTERN, NUMBER_PATTERN,
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
251 SUFFIX_PATTERN))
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
252
220
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
253 def split_number(value):
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
254 """Convert a number into a (intasstring, fractionasstring) tuple"""
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
255 if have_decimal and isinstance(value, Decimal):
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
256 text = str(value)
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
257 else:
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
258 text = ('%.9f' % value).rstrip('0')
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
259 if '.' in text:
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
260 a, b = text.split('.', 1)
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
261 if b == '0':
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
262 b = ''
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
263 else:
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
264 a, b = text, ''
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
265 return a, b
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
266
214
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
267 def bankersround(value, ndigits=0):
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
268 """Round a number to a given precision.
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
269
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
270 Works like round() except that the round-half-even (banker's rounding)
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
271 algorithm is used instead of round-half-up.
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
272
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
273 >>> bankersround(5.5, 0)
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
274 6.0
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
275 >>> bankersround(6.5, 0)
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
276 6.0
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
277 >>> bankersround(-6.5, 0)
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
278 -6.0
220
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
279 >>> bankersround(1234.0, -2)
214
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
280 1200.0
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
281 """
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
282 sign = int(value < 0) and -1 or 1
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
283 value = abs(value)
220
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
284 a, b = split_number(value)
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
285 digits = a + b
214
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
286 add = 0
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
287 i = len(a) + ndigits
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
288 if i < 0 or i >= len(digits):
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
289 pass
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
290 elif digits[i] > '5':
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
291 add = 1
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
292 elif digits[i] == '5' and digits[i-1] in '13579':
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
293 add = 1
220
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
294 scale = 10**ndigits
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
295 if have_decimal and isinstance(value, Decimal):
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
296 return Decimal(int(value * scale + add)) / scale * sign
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
297 else:
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
298 return float(int(value * scale + add)) / scale * sign
214
5f90da6265a9 Switched to using our own round() implementation.
jonas
parents: 213
diff changeset
299
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
300 # TODO:
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
301 # Filling
52
4df5e8994657 Added round-half-even (banker's rounding) support.
jonas
parents: 41
diff changeset
302 # Rounding increment in pattern
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
303 # Scientific notation
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
304 def parse_pattern(pattern):
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
305 """Parse number format patterns"""
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
306 if isinstance(pattern, NumberPattern):
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
307 return pattern
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
308
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
309 # Do we have a negative subpattern?
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
310 if ';' in pattern:
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
311 pattern, neg_pattern = pattern.split(';', 1)
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
312 pos_prefix, number, pos_suffix = number_re.search(pattern).groups()
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
313 neg_prefix, _, neg_suffix = number_re.search(neg_pattern).groups()
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
314 else:
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
315 pos_prefix, number, pos_suffix = number_re.search(pattern).groups()
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
316 neg_prefix = '-' + pos_prefix
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
317 neg_suffix = pos_suffix
213
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
318 if '@' in number:
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
319 if '.' in number and '0' in number:
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
320 raise ValueError('Significant digit patterns can not contain '
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
321 '"@" or "0"')
24
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
322 if '.' in number:
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
323 integer, fraction = number.rsplit('.', 1)
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
324 else:
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
325 integer = number
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
326 fraction = ''
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
327 min_frac = max_frac = 0
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
328
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
329 def parse_precision(p):
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
330 """Calculate the min and max allowed digits"""
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
331 min = max = 0
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
332 for c in p:
213
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
333 if c in '@0':
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
334 min += 1
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
335 max += 1
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
336 elif c == '#':
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
337 max += 1
213
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
338 elif c == ',':
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
339 continue
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
340 else:
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
341 break
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
342 return min, max
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
343
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
344 def parse_grouping(p):
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
345 """Parse primary and secondary digit grouping
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
346
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
347 >>> parse_grouping('##')
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
348 0, 0
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
349 >>> parse_grouping('#,###')
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
350 3, 3
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
351 >>> parse_grouping('#,####,###')
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
352 3, 4
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
353 """
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
354 width = len(p)
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
355 g1 = p.rfind(',')
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
356 if g1 == -1:
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
357 return 1000, 1000
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
358 g1 = width - g1 - 1
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
359 g2 = p[:-g1 - 1].rfind(',')
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
360 if g2 == -1:
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
361 return g1, g1
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
362 g2 = width - g1 - g2 - 2
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
363 return g1, g2
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
364
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
365 int_precision = parse_precision(integer)
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
366 frac_precision = parse_precision(fraction)
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
367 grouping = parse_grouping(integer)
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
368 return NumberPattern(pattern, (pos_prefix, neg_prefix),
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
369 (pos_suffix, neg_suffix), grouping,
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
370 int_precision, frac_precision)
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
371
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
372
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
373 class NumberPattern(object):
24
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
374
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
375 def __init__(self, pattern, prefix, suffix, grouping,
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
376 int_precision, frac_precision):
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
377 self.pattern = pattern
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
378 self.prefix = prefix
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
379 self.suffix = suffix
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
380 self.grouping = grouping
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
381 self.int_precision = int_precision
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
382 self.frac_precision = frac_precision
24
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
383 if '%' in ''.join(self.prefix + self.suffix):
220
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
384 self.scale = 100
24
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
385 elif u'‰' in ''.join(self.prefix + self.suffix):
220
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
386 self.scale = 1000
24
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
387 else:
220
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
388 self.scale = 1
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
389
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
390 def __repr__(self):
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
391 return '<%s %r>' % (type(self).__name__, self.pattern)
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
392
127
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
393 def apply(self, value, locale, currency=None):
24
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
394 value *= self.scale
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
395 negative = int(value < 0)
213
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
396 if '@' in self.pattern: # Is it a siginificant digits pattern?
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
397 text = self._format_sigdig(abs(value),
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
398 self.int_precision[0],
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
399 self.int_precision[1])
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
400 if '.' in text:
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
401 a, b = text.split('.')
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
402 a = self._format_int(a, 0, 1000, locale)
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
403 if b:
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
404 b = get_decimal_symbol(locale) + b
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
405 else:
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
406 a, b = self._format_int(text, 0, 1000, locale), ''
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
407 else: # A normal number pattern
220
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
408 a, b = split_number(bankersround(abs(value),
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
409 self.frac_precision[1]))
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
410 b = b or '0'
213
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
411 a = self._format_int(a, self.int_precision[0],
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
412 self.int_precision[1], locale)
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
413 b = self._format_frac(b, locale)
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
414 retval = u'%s%s%s%s' % (self.prefix[negative], a, b,
128
24a711a3c174 Add test for permille number format.
cmlenz
parents: 127
diff changeset
415 self.suffix[negative])
127
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
416 if u'¤' in retval:
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
417 retval = retval.replace(u'¤¤', currency.upper())
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
418 retval = retval.replace(u'¤', get_currency_symbol(currency, locale))
a72de8971819 Add currency formatting.
cmlenz
parents: 103
diff changeset
419 return retval
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
420
213
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
421 def _format_sigdig(self, value, min, max):
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
422 """Convert value to a string.
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
423
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
424 The resulting string will contain between (min, max) number of
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
425 significant digits.
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
426 """
220
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
427 a, b = split_number(value)
213
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
428 ndecimals = len(a)
220
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
429 if a == '0' and b != '':
213
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
430 ndecimals = 0
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
431 while b.startswith('0'):
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
432 b = b[1:]
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
433 ndecimals -= 1
220
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
434 a, b = split_number(bankersround(value, max - ndecimals))
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
435 digits = len((a + b).lstrip('0'))
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
436 if not digits:
213
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
437 digits = 1
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
438 # Figure out if we need to add any trailing '0':s
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
439 if len(a) >= max and a != '0':
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
440 return a
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
441 if digits < min:
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
442 b += ('0' * (min - digits))
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
443 if b:
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
444 return '%s.%s' % (a, b)
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
445 return a
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
446
b13f3bf4c208 Added support for siginificant digits in number patterns.
jonas
parents: 139
diff changeset
447 def _format_int(self, value, min, max, locale):
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
448 width = len(value)
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
449 if width < min:
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
450 value += '0' * (min - width)
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
451 gsize = self.grouping[0]
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
452 ret = ''
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
453 symbol = get_group_symbol(locale)
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
454 while len(value) > gsize:
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
455 ret = symbol + value[-gsize:] + ret
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
456 value = value[:-gsize]
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
457 gsize = self.grouping[1]
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
458 return value + ret
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
459
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
460 def _format_frac(self, value, locale):
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
461 min, max = self.frac_precision
220
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
462 if len(value) < min:
ce3ad60145db Added Decimal support to the number formatter.
jonas
parents: 214
diff changeset
463 value += ('0' * (min - len(value)))
24
6c2c9fc7d787 Implemented babel.numbers.format_percent
jonas
parents: 11
diff changeset
464 if max == 0 or (min == 0 and int(value) == 0):
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
465 return ''
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
466 width = len(value)
52
4df5e8994657 Added round-half-even (banker's rounding) support.
jonas
parents: 41
diff changeset
467 while len(value) > min and value[-1] == '0':
4df5e8994657 Added round-half-even (banker's rounding) support.
jonas
parents: 41
diff changeset
468 value = value[:-1]
11
11f64b232b04 Add basic support for number format patterns.
jonas
parents: 3
diff changeset
469 return get_decimal_symbol(locale) + value
Copyright (C) 2012-2017 Edgewall Software