Merge pull request #131 from Bernardoow/improve_doc_with_numbers_info

Added information about number functions

Author: TkTech

docs/index.rst

@@ -134,6 +134,62 @@ u'Donnerstag, 5. M\xe4rz 1987 17:12'
 
 For more format examples head over to the `babel`_ documentation.
 
+Formatting Numbers
+----------------
+
+To format numbers you can use the :func:`format_number`,
+:func:`format_decimal`, :func:`format_currency`, :func:`format_percent` and :func:`format_scientific`
+functions.
+
+To play with the date formatting from the console, you can use the
+:meth:`~flask.Flask.test_request_context` method:
+
+>>> app.test_request_context().push()
+
+Here are some examples:
+
+>>> from flask_babel import format_number
+>>> format_number(1099)
+'1,099'
+
+>>> from flask_babel import format_decimal
+>>> format_decimal(1.2346)
+u'1.235'
+
+>>> from flask_babel import format_currency
+>>> format_currency(1099.98, 'USD')
+'$1,099.98'
+
+>>> from flask_babel import format_percent
+>>> format_percent(0.34)
+'34%'
+
+>>> from flask_babel import format_scientific
+>>> format_scientific(10000)
+'1E4'
+
+And again with a different language:
+
+>>> app.config['BABEL_DEFAULT_LOCALE'] = 'de'
+>>> from flask_babel import refresh; refresh()
+
+>>> format_number(1099)
+'1.099'
+
+>>> format_decimal(1.2346)
+'1,235'
+
+>>> format_currency(1099.98, 'USD')
+'1.099,98\xa0$'
+
+>>> format_percent(0.34)
+'34\xa0%'
+
+>>> format_scientific(10000)
+'1E4'
+
+For more format examples head over to the `babel`_ documentation.
+
 Using Translations
 ------------------
 
@@ -276,6 +332,19 @@ Datetime Functions
 
 .. autofunction:: format_timedelta
 
+Number Functions
+``````````````````
+
+.. autofunction:: format_number
+
+.. autofunction:: format_decimal
+
+.. autofunction:: format_currency
+
+.. autofunction:: format_percent
+
+.. autofunction:: format_scientific
+
 Gettext Functions
 `````````````````