793 lines
63 KiB
Plaintext
793 lines
63 KiB
Plaintext
|
Ë
|
|||
|
|
gÀjí÷ ã óB — d Z ddlmZ ddlZddlZddlZddlZddlmZm Z m
|
|||
|
|
Z
|
|||
|
|
m Z ddl m
|
|||
|
|
Z
|
|||
|
|
mZmZ ddlmZ ed« Z ed« Z G d „ d
|
|||
|
|
e« Zd=d>d „Zd=d?d „Zd=d@d
|
|||
|
|
„Zd=dAd„Z dB dCd„Zd=dDd„ZdEd„Z dB dCd„Z e dF dGd„« Z e dF dHd„« Z dI dJd„Z dK dLd„Z ddœ dMd„Z G d„ de« Z! d=ddœ dNd „Z" d=ddœ dNd „Z# d=ddœ dNd „Z$ d=ddœ dNd „Z% d=ddœ dNd „Z& d=ddœ dNd!„Z' d= dOd"„Z(dPd#„Z)dQd$„Z* dRddœ dSd%„Z+d&dddd'œ dTd(„Z, dUd)„Z- G d*„ d+e.« Z/ dVddœ dWd,„Z0 dXd-„Z1d&dddd'œ dYd.„Z2 dRddœ dSd/„Z3 dZddœ d[d0„Z4 G d1„ d2e5« Z6h d3£Z7 ejp d4js e7« « Z: d=ddœ d\d5„Z; d]ddœ d^d6„Z<d_d7„Z= ejp d8« Z>d`d9„Z?dad;„Z@ G d<„ d:« ZAy)ba–
|
|||
|
|
babel.numbers
|
|||
|
|
~~~~~~~~~~~~~
|
|||
|
|
|
|||
|
|
Locale dependent formatting and parsing of numeric data.
|
|||
|
|
|
|||
|
|
The default locale for the functions in this module is determined by the
|
|||
|
|
following environment variables, in that order:
|
|||
|
|
|
|||
|
|
* ``LC_MONETARY`` for currency related functions,
|
|||
|
|
* ``LC_NUMERIC``, and
|
|||
|
|
* ``LC_ALL``, and
|
|||
|
|
* ``LANG``
|
|||
|
|
|
|||
|
|
:copyright: (c) 2013-2026 by the Babel Team.
|
|||
|
|
:license: BSD, see LICENSE for more details.
|
|||
|
|
é )Ú annotationsN)ÚAnyÚLiteralÚcastÚoverload)ÚLocaleÚdefault_localeÚ
|
|||
|
|
get_global)ÚLocaleDataDict)Ú LC_MONETARYÚ
|
|||
|
|
LC_NUMERICr
|
|||
|
|
c ó — e Zd ZdZdd„Zy)ÚUnknownCurrencyErrorzMException thrown when a currency is requested for which no data is available.c óF — t j | d|›d�« || _ y)zkCreate the exception.
|
|||
|
|
:param identifier: the identifier string of the unsupported currency
|
|||
|
|
zUnknown currency ú.N)Ú ExceptionÚ__init__Ú
|
|||
|
|
identifier)Úselfr s úP/home/antigravity/intellecton/venv/lib/python3.12/site-packages/babel/numbers.pyr z UnknownCurrencyError.__init__( s' € ô ×ј4Ð#4°Z°NÀ!Ð!DÔEð %ˆ�ó N)r ÚstrÚreturnÚNone)Ú__name__Ú
|
|||
|
|
__module__Ú __qualname__Ú__doc__r © r r r r % s
|
|||
|
|
„ ÙWô%r r c ó~ — | r(t t j | « j « S t t d« « S )aL Return a `set` of normalized currency codes.
|
|||
|
|
|
|||
|
|
.. versionadded:: 2.5.0
|
|||
|
|
|
|||
|
|
:param locale: filters returned currency codes by the provided locale.
|
|||
|
|
Expected to be a locale instance or code. If no locale is
|
|||
|
|
provided, returns the list of all currencies from all
|
|||
|
|
locales.
|
|||
|
|
Úall_currencies)Úsetr ÚparseÚ
|
|||
|
|
currenciesr
|
|||
|
|
©Úlocales r Úlist_currenciesr' 2 s2 € ñ Ü”6—<‘< Ó'×2Ñ2Ó3Ð3Ü ŒzÐ*Ó+Ó ,Ð,r c ó4 — | t |« vr t | « ‚y)a Check the currency code is recognized by Babel.
|
|||
|
|
|
|||
|
|
Accepts a ``locale`` parameter for fined-grained validation, working as
|
|||
|
|
the one defined above in ``list_currencies()`` method.
|
|||
|
|
|
|||
|
|
Raises a `UnknownCurrencyError` exception if the currency is unknown to Babel.
|
|||
|
|
N)r' r ©Úcurrencyr& s r Úvalidate_currencyr+ B s! € ð ” vÓ.Ñ.Ü" 8Ó,Ð,ð /r c ób — | rt | t « sy t | |« y# t $ r Y yw xY w)zxReturns `True` only if a currency is recognized by Babel.
|
|||
|
|
|
|||
|
|
This method always return a Boolean and never raise.
|
|||
|
|
FT)Ú
|
|||
|
|
isinstancer r+ r r) s r Ú is_currencyr. N s; € ñ
|
|||
|
|
œ: h´Ô4Øðܘ( FÔ+ð øô ò Ùðús • " ¢ ..c ó` — t | t « r| j « } t | |« sy| S )zûReturns the normalized identifier of any currency code.
|
|||
|
|
|
|||
|
|
Accepts a ``locale`` parameter for fined-grained validation, working as
|
|||
|
|
the one defined above in ``list_currencies()`` method.
|
|||
|
|
|
|||
|
|
Returns None if the currency is unknown to Babel.
|
|||
|
|
N)r- r Úupperr. r) s r Únormalize_currencyr1 \ s, € ô �(œCÔ Ø—>‘>Ó#ˆÜ �x Ô (ØØ €Or c ó — t j |xs t « }|�< |j |« }|j d }| |v r|| }||v r|| S d|v r|d S |j j | | « S # t t
|
|||
|
|
f$ r d}Y ŒYw xY w)aÛ Return the name used by the locale for the specified currency.
|
|||
|
|
|
|||
|
|
>>> get_currency_name('USD', locale='en_US')
|
|||
|
|
'US Dollar'
|
|||
|
|
|
|||
|
|
.. versionadded:: 0.9.4
|
|||
|
|
|
|||
|
|
:param currency: the currency code.
|
|||
|
|
:param count: the optional count. If provided the currency name
|
|||
|
|
will be pluralized to that number if possible.
|
|||
|
|
:param locale: the `Locale` object or locale identifier.
|
|||
|
|
Defaults to the system currency locale or numeric locale.
|
|||
|
|
ÚotherÚcurrency_names_plural) r r# r Ú plural_formÚ
|
|||
|
|
OverflowErrorÚ
|
|||
|
|
ValueErrorÚ_datar$ Úget)r* Úcountr& Úlocr5 Ú plural_namesÚcurrency_plural_namess r Úget_currency_namer> k s® € ô$ �,‰,�vÒ,¤Ó
|
|||
|
|
-€CØ Ðð "Ø Ÿ/™/¨%Ó0ˆKð —y‘yÐ!8Ñ9ˆ Ø �|Ñ #Ø$0°Ñ$:Ð !ØÐ 3Ñ3Ø,¨[Ñ9Ð9ØÐ/Ñ/Ø,¨WÑ5Ð5Ø �>‰>× Ñ ˜h¨Ó 1Ð1øô œzÐ*ò "Ø!ŠKð "ús ¡A8 Á8B Â B c óp — t j |xs t « j j | | « S )a4 Return the symbol used by the locale for the specified currency.
|
|||
|
|
|
|||
|
|
>>> get_currency_symbol('USD', locale='en_US')
|
|||
|
|
'$'
|
|||
|
|
|
|||
|
|
:param currency: the currency code.
|
|||
|
|
:param locale: the `Locale` object or locale identifier.
|
|||
|
|
Defaults to the system currency locale or numeric locale.
|
|||
|
|
)r r# r Úcurrency_symbolsr9 r) s r Úget_currency_symbolrA � s+ € ô �<‰<˜Ò-¤+Ó .× ?Ñ ?× CÑ CÀHÈhÓ WÐWr c óH — t d« }|j | |d « d S )zÔReturn currency's precision.
|
|||
|
|
|
|||
|
|
Precision is the number of decimals found after the decimal point in the
|
|||
|
|
currency's format pattern.
|
|||
|
|
|
|||
|
|
.. versionadded:: 2.5.0
|
|||
|
|
|
|||
|
|
:param currency: the currency code.
|
|||
|
|
Úcurrency_fractionsÚDEFAULTr )r
|
|||
|
|
r9 )r* Ú
|
|||
|
|
precisionss r Úget_currency_precisionrF š s* € ô Ð 0Ó1€JØ �>‰>˜( J¨yÑ$9Ó :¸1Ñ =Ð=r c óÊ — t j |xs t « }|�$|j |« } |j d | S |j d d S # t
|
|||
|
|
$ r Y Œ w xY w)a¢
|
|||
|
|
Return the unit pattern used for long display of a currency value
|
|||
|
|
for a given locale.
|
|||
|
|
This is a string containing ``{0}`` where the numeric part
|
|||
|
|
should be substituted and ``{1}`` where the currency long display
|
|||
|
|
name should be substituted.
|
|||
|
|
|
|||
|
|
>>> get_currency_unit_pattern('USD', locale='en_US', count=10)
|
|||
|
|
'{0} {1}'
|
|||
|
|
|
|||
|
|
.. versionadded:: 2.7.0
|
|||
|
|
|
|||
|
|
:param currency: the currency code.
|
|||
|
|
:param count: the optional count. If provided the unit
|
|||
|
|
pattern for that number will be returned.
|
|||
|
|
:param locale: the `Locale` object or locale identifier.
|
|||
|
|
Defaults to the system currency locale or numeric locale.
|
|||
|
|
Úcurrency_unit_patternsr3 )r r# r r5 r8 Ú LookupError)r* r: r& r; r5 s r Úget_currency_unit_patternrJ ¨ sp € ô. �,‰,�vÒ,¤Ó
|
|||
|
|
-€CØ ÐØ—o‘o eÓ,ˆ ð Ø—9‘9Ð 5Ñ6°{ÑCÐ Cð
|
|||
|
|
�9‰9Ð-Ñ .¨wÑ 7Ð7øô ò á ð ús ²A Á A"Á!A"c ó — y ©Nr ©Ú territoryÚ
|
|||
|
|
start_dateÚend_dateÚtenderÚ
|
|||
|
|
non_tenderÚinclude_detailss r Úget_territory_currenciesrT Ë s € ð r c ó — y rL r rM s r rT rT Ö s € ð r c óH ‡‡— t d« }‰€ t j j « Šn*t ‰t j « r‰j « Š‰€‰Šn*t ‰t j « r‰j « Š|j | j
|
|||
|
|
« d« }ˆˆfd„}g } |D ]m \ }
|
|||
|
|
} } }
|
|||
|
|
| rt j | Ž } | rt j | Ž } |
|
|||
|
|
r|s|
|
|||
|
|
rŒ7|sŒ: || | « sŒD|r| j |
|
|||
|
|
| | |
|
|||
|
|
dœ« Œ]| j |
|
|||
|
|
« Œo | S )as Returns the list of currencies for the given territory that are valid for
|
|||
|
|
the given date range. In addition to that the currency database
|
|||
|
|
distinguishes between tender and non-tender currencies. By default only
|
|||
|
|
tender currencies are returned.
|
|||
|
|
|
|||
|
|
The return value is a list of all currencies roughly ordered by the time
|
|||
|
|
of when the currency became active. The longer the currency is being in
|
|||
|
|
use the more to the left of the list it will be.
|
|||
|
|
|
|||
|
|
The start date defaults to today. If no end date is given it will be the
|
|||
|
|
same as the start date. Otherwise a range can be defined. For instance
|
|||
|
|
this can be used to find the currencies in use in Austria between 1995 and
|
|||
|
|
2011:
|
|||
|
|
|
|||
|
|
>>> from datetime import date
|
|||
|
|
>>> get_territory_currencies('AT', date(1995, 1, 1), date(2011, 1, 1))
|
|||
|
|
['ATS', 'EUR']
|
|||
|
|
|
|||
|
|
Likewise it's also possible to find all the currencies in use on a
|
|||
|
|
single date:
|
|||
|
|
|
|||
|
|
>>> get_territory_currencies('AT', date(1995, 1, 1))
|
|||
|
|
['ATS']
|
|||
|
|
>>> get_territory_currencies('AT', date(2011, 1, 1))
|
|||
|
|
['EUR']
|
|||
|
|
|
|||
|
|
By default the return value only includes tender currencies. This
|
|||
|
|
however can be changed:
|
|||
|
|
|
|||
|
|
>>> get_territory_currencies('US')
|
|||
|
|
['USD']
|
|||
|
|
>>> get_territory_currencies('US', tender=False, non_tender=True,
|
|||
|
|
... start_date=date(2014, 1, 1))
|
|||
|
|
['USN', 'USS']
|
|||
|
|
|
|||
|
|
.. versionadded:: 2.0
|
|||
|
|
|
|||
|
|
:param territory: the name of the territory to find the currency for.
|
|||
|
|
:param start_date: the start date. If not given today is assumed.
|
|||
|
|
:param end_date: the end date. If not given the start date is assumed.
|
|||
|
|
:param tender: controls whether tender currencies should be included.
|
|||
|
|
:param non_tender: controls whether non-tender currencies should be
|
|||
|
|
included.
|
|||
|
|
:param include_details: if set to `True`, instead of returning currency
|
|||
|
|
codes the return value will be dictionaries
|
|||
|
|
with detail information. In that case each
|
|||
|
|
dictionary will have the keys ``'currency'``,
|
|||
|
|
``'from'``, ``'to'``, and ``'tender'``.
|
|||
|
|
Úterritory_currenciesr c ó4 •— | d u xs | ‰k xr |d u xs |‰k\ S rL r )ÚstartÚendrP rO s €€r Ú
|
|||
|
|
_is_activez,get_territory_currencies.<locals>._is_active' s* ø€ ؘ�
|
|||
|
|
Ò2 ¨(Ñ!2ÒZ¸À¸Ò9YÈÈzÑHYÐZr )r* ÚfromÚtorQ )r
|
|||
|
|
ÚdatetimeÚdateÚtodayr- r9 r0 Úappend)rN rO rP rQ rR rS r$ Úcursr[ ÚresultÚ
|
|||
|
|
currency_coderY rZ Ú is_tenders `` r rT rT á s ù€ ôr Ð 2Ó3€JØÐÜ —]‘]×(Ñ(Ó*‰
|
|||
|
|
Ü �J¤× 1Ñ 1Ô 2Ø —_‘_Ó&ˆ
|
|||
|
|
ØÐØ ‰Ü �Hœh× /Ñ /Ô 0Ø—=‘=“?ˆà �>‰>˜)Ÿ/™/Ó+¨RÓ 0€Dõ[ð €FØ04ò -Ñ,ˆ
|
|||
|
|
�u˜c 9Ù Ü —M‘M 5Ð)ˆEÙ Ü—-‘- Ð%ˆCÙ
|
|||
|
|
™6ª9ºÉ*Ø Ø õK
|
|||
|
|
ñ Ø—
|
|||
|
|
‘
|
|||
|
|
à$1Ø %Ø !Ø"+ñ õð —
|
|||
|
|
‘
|
|||
|
|
˜mÕ,ð'-ð* €Mr Úlatnc ó( — |dk( r | j S |S )NÚdefault)Údefault_numbering_system©r& Únumbering_systems r Ú_get_numbering_systemrl C s € ð ˜9Ò$Ø×.Ñ.Ð.à Ð r ©rk c ó‚ — t | |« } | j | S # t $ r}t d|› d| › d�« |‚d }~ww xY w)NzUnknown numbering system z for Locale r )rl Únumber_symbolsÚKeyErrorÚ UnsupportedNumberingSystemError)r& rk Úerrors r Ú_get_number_symbolsrs M s] € ô
|
|||
|
|
-¨VÐ5EÓFÐðØ×$Ñ$Ð%5Ñ6Ð6øÜ ò Ü-Ø'Ð(8Ð'9¸ ÀfÀXÈQÐ Oó
|
|||
|
|
àð ûðús Ž � >¦9¹>c ó — e Zd ZdZy)rq zXException thrown when an unsupported numbering system is requested for the given Locale.N©r r r r r r r rq rq [ s „ Ùbàr rq c óv — t j | xs t « } t | |¬« j dd« S )u Return the symbol used by the locale to separate decimal fractions.
|
|||
|
|
|
|||
|
|
>>> get_decimal_symbol('en_US')
|
|||
|
|
'.'
|
|||
|
|
>>> get_decimal_symbol('ar_EG', numbering_system='default')
|
|||
|
|
'Ù«'
|
|||
|
|
>>> get_decimal_symbol('ar_EG', numbering_system='latn')
|
|||
|
|
'.'
|
|||
|
|
|
|||
|
|
:param locale: the `Locale` object or locale identifier. Defaults to the system numeric locale.
|
|||
|
|
:param numbering_system: The numbering system used for fetching the symbol. Defaults to "latn".
|
|||
|
|
The special value "default" will use the default numbering system of the locale.
|
|||
|
|
:raise `UnsupportedNumberingSystemError`: If the numbering system is not supported by the locale.
|
|||
|
|
rm Údecimalr ©r r# r
|
|||
|
|
rs r9 rj s r Úget_decimal_symbolry a s3 € ô& �\‰\˜&Ò.¤JÓ
|
|||
|
|
/€FÜ ˜vÐ8HÔ I× MÑ MÈiÐY\Ó ]Ð]r c óv — t j | xs t « } t | |¬« j dd« S )a¥ Return the plus sign symbol used by the current locale.
|
|||
|
|
|
|||
|
|
>>> get_plus_sign_symbol('en_US')
|
|||
|
|
'+'
|
|||
|
|
>>> get_plus_sign_symbol('ar_EG', numbering_system='default')
|
|||
|
|
'\u061c+'
|
|||
|
|
>>> get_plus_sign_symbol('ar_EG', numbering_system='latn')
|
|||
|
|
'\u200e+'
|
|||
|
|
|
|||
|
|
:param locale: the `Locale` object or locale identifier. Defaults to the system numeric locale.
|
|||
|
|
:param numbering_system: The numbering system used for fetching the symbol. Defaults to "latn".
|
|||
|
|
The special value "default" will use the default numbering system of the locale.
|
|||
|
|
:raise `UnsupportedNumberingSystemError`: if the numbering system is not supported by the locale.
|
|||
|
|
rm ÚplusSignú+rx rj s r Úget_plus_sign_symbolr} x s3 € ô& �\‰\˜&Ò.¤JÓ
|
|||
|
|
/€FÜ ˜vÐ8HÔ I× MÑ MÈjÐZ]Ó ^Ð^r c óv — t j | xs t « } t | |¬« j dd« S )a¨ Return the plus sign symbol used by the current locale.
|
|||
|
|
|
|||
|
|
>>> get_minus_sign_symbol('en_US')
|
|||
|
|
'-'
|
|||
|
|
>>> get_minus_sign_symbol('ar_EG', numbering_system='default')
|
|||
|
|
'\u061c-'
|
|||
|
|
>>> get_minus_sign_symbol('ar_EG', numbering_system='latn')
|
|||
|
|
'\u200e-'
|
|||
|
|
|
|||
|
|
:param locale: the `Locale` object or locale identifier. Defaults to the system numeric locale.
|
|||
|
|
:param numbering_system: The numbering system used for fetching the symbol. Defaults to "latn".
|
|||
|
|
The special value "default" will use the default numbering system of the locale.
|
|||
|
|
:raise `UnsupportedNumberingSystemError`: if the numbering system is not supported by the locale.
|
|||
|
|
rm Ú minusSignú-rx rj s r Úget_minus_sign_symbolr� � s3 € ô& �\‰\˜&Ò.¤JÓ
|
|||
|
|
/€FÜ ˜vÐ8HÔ I× MÑ MÈkÐ[^Ó _Ð_r c óv — t j | xs t « } t | |¬« j dd« S )u² Return the symbol used by the locale to separate mantissa and exponent.
|
|||
|
|
|
|||
|
|
>>> get_exponential_symbol('en_US')
|
|||
|
|
'E'
|
|||
|
|
>>> get_exponential_symbol('ar_EG', numbering_system='default')
|
|||
|
|
'أس'
|
|||
|
|
>>> get_exponential_symbol('ar_EG', numbering_system='latn')
|
|||
|
|
'E'
|
|||
|
|
|
|||
|
|
:param locale: the `Locale` object or locale identifier. Defaults to the system numeric locale.
|
|||
|
|
:param numbering_system: The numbering system used for fetching the symbol. Defaults to "latn".
|
|||
|
|
The special value "default" will use the default numbering system of the locale.
|
|||
|
|
:raise `UnsupportedNumberingSystemError`: if the numbering system is not supported by the locale.
|
|||
|
|
rm Ú exponentialÚErx rj s r Úget_exponential_symbolr… ¦ s3 € ô& �\‰\˜&Ò.¤JÓ
|
|||
|
|
/€FÜ ˜vÐ8HÔ I× MÑ MÈmÐ]`Ó aÐar c óv — t j | xs t « } t | |¬« j dd« S )uœ Return the symbol used by the locale to separate groups of thousands.
|
|||
|
|
|
|||
|
|
>>> get_group_symbol('en_US')
|
|||
|
|
','
|
|||
|
|
>>> get_group_symbol('ar_EG', numbering_system='default')
|
|||
|
|
'Ù¬'
|
|||
|
|
>>> get_group_symbol('ar_EG', numbering_system='latn')
|
|||
|
|
','
|
|||
|
|
|
|||
|
|
:param locale: the `Locale` object or locale identifier. Defaults to the system numeric locale.
|
|||
|
|
:param numbering_system: The numbering system used for fetching the symbol. Defaults to "latn".
|
|||
|
|
The special value "default" will use the default numbering system of the locale.
|
|||
|
|
:raise `UnsupportedNumberingSystemError`: if the numbering system is not supported by the locale.
|
|||
|
|
rm Úgroupú,rx rj s r Úget_group_symbolr‰ ½ s3 € ô& �\‰\˜&Ò.¤JÓ
|
|||
|
|
/€FÜ ˜vÐ8HÔ I× MÑ MÈgÐWZÓ [Ð[r c óv — t j | xs t « } t | |¬« j dd« S )u Return the symbol used by the locale to represent infinity.
|
|||
|
|
|
|||
|
|
>>> get_infinity_symbol('en_US')
|
|||
|
|
'∞'
|
|||
|
|
>>> get_infinity_symbol('ar_EG', numbering_system='default')
|
|||
|
|
'∞'
|
|||
|
|
>>> get_infinity_symbol('ar_EG', numbering_system='latn')
|
|||
|
|
'∞'
|
|||
|
|
|
|||
|
|
:param locale: the `Locale` object or locale identifier. Defaults to the system numeric locale.
|
|||
|
|
:param numbering_system: The numbering system used for fetching the symbol. Defaults to "latn".
|
|||
|
|
The special value "default" will use the default numbering system of the locale.
|
|||
|
|
:raise `UnsupportedNumberingSystemError`: if the numbering system is not supported by the locale.
|
|||
|
|
rm Úinfinityu ∞rx rj s r Úget_infinity_symbolrŒ Ô s3 € ô& �\‰\˜&Ò.¤JÓ
|
|||
|
|
/€FÜ ˜vÐ8HÔ I× MÑ MÈjÐZ_Ó `Ð`r c óT — t j dt d¬« t | |¬« S )a° Return the given number formatted for a specific locale.
|
|||
|
|
|
|||
|
|
>>> format_number(1099, locale='en_US') # doctest: +SKIP
|
|||
|
|
'1,099'
|
|||
|
|
>>> format_number(1099, locale='de_DE') # doctest: +SKIP
|
|||
|
|
'1.099'
|
|||
|
|
|
|||
|
|
.. deprecated:: 2.6.0
|
|||
|
|
|
|||
|
|
Use babel.numbers.format_decimal() instead.
|
|||
|
|
|
|||
|
|
:param number: the number to format
|
|||
|
|
:param locale: the `Locale` object or locale identifier. Defaults to the system numeric locale.
|
|||
|
|
|
|||
|
|
|
|||
|
|
z+Use babel.numbers.format_decimal() instead.é ©Ú
|
|||
|
|
stacklevelr% )ÚwarningsÚwarnÚDeprecationWarningÚformat_decimal)Únumberr& s r Ú
|
|||
|
|
format_numberr– ë s( € ô(
|
|||
|
|
‡M�MØ5ÜØõô
|
|||
|
|
˜&¨Ô 0Ð0r c óô — t | t j « sJ ‚| j « j « }t |j
|
|||
|
|
t « r|j
|
|||
|
|
dk\ ryt |j
|
|||
|
|
« S )z�Return maximum precision of a decimal instance's fractional part.
|
|||
|
|
|
|||
|
|
Precision is extracted from the fractional part only.
|
|||
|
|
r )r- rw ÚDecimalÚ normalizeÚas_tupleÚexponentÚintÚabs)r• Ú
|
|||
|
|
decimal_tuples r Úget_decimal_precisionrŸ sa € ô �fœgŸo™oÔ .Ð.Ð .Ø×$Ñ$Ó&×/Ñ/Ó1€Mä �m×,Ñ,¬cÔ 2°m×6LÑ6LÐPQÒ6QØÜ ˆ}×%Ñ%Ó &Ð&r c óx — t | t t j f« sJ ‚t j d« | z S )z<Return minimal quantum of a number, as defined by precision.é
|
|||
|
|
)r- rœ rw r˜ )Ú precisions r Úget_decimal_quantumr£ s1 € ä �i¤#¤w§¡Ð!7Ô 8Ð8Ð 8Ü �?‰?˜2Ó I :Ñ .Ð.r c ó — t j |xs t « }|€|j | }t |« }|j | ||||¬« S )uÆ Return the given decimal number formatted for a specific locale.
|
|||
|
|
|
|||
|
|
>>> format_decimal(1.2345, locale='en_US')
|
|||
|
|
'1.234'
|
|||
|
|
>>> format_decimal(1.2346, locale='en_US')
|
|||
|
|
'1.235'
|
|||
|
|
>>> format_decimal(-1.2346, locale='en_US')
|
|||
|
|
'-1.235'
|
|||
|
|
>>> format_decimal(1.2345, locale='sv_SE')
|
|||
|
|
'1,234'
|
|||
|
|
>>> format_decimal(1.2345, locale='de')
|
|||
|
|
'1,234'
|
|||
|
|
>>> format_decimal(1.2345, locale='ar_EG', numbering_system='default')
|
|||
|
|
'1Ù«234'
|
|||
|
|
>>> format_decimal(1.2345, locale='ar_EG', numbering_system='latn')
|
|||
|
|
'1.234'
|
|||
|
|
|
|||
|
|
The appropriate thousands grouping and the decimal separator are used for
|
|||
|
|
each locale:
|
|||
|
|
|
|||
|
|
>>> format_decimal(12345.5, locale='en_US')
|
|||
|
|
'12,345.5'
|
|||
|
|
|
|||
|
|
By default the locale is allowed to truncate and round a high-precision
|
|||
|
|
number by forcing its format pattern onto the decimal part. You can bypass
|
|||
|
|
this behavior with the `decimal_quantization` parameter:
|
|||
|
|
|
|||
|
|
>>> format_decimal(1.2346, locale='en_US')
|
|||
|
|
'1.235'
|
|||
|
|
>>> format_decimal(1.2346, locale='en_US', decimal_quantization=False)
|
|||
|
|
'1.2346'
|
|||
|
|
>>> format_decimal(12345.67, locale='fr_CA', group_separator=False)
|
|||
|
|
'12345,67'
|
|||
|
|
>>> format_decimal(12345.67, locale='en_US', group_separator=True)
|
|||
|
|
'12,345.67'
|
|||
|
|
|
|||
|
|
:param number: the number to format
|
|||
|
|
:param format:
|
|||
|
|
:param locale: the `Locale` object or locale identifier. Defaults to the system numeric locale.
|
|||
|
|
:param decimal_quantization: Truncate and round high-precision numbers to
|
|||
|
|
the format pattern. Defaults to `True`.
|
|||
|
|
:param group_separator: Boolean to switch group separator on/off in a locale's
|
|||
|
|
number format.
|
|||
|
|
:param numbering_system: The numbering system used for formatting number symbols. Defaults to "latn".
|
|||
|
|
The special value "default" will use the default numbering system of the locale.
|
|||
|
|
:raise `UnsupportedNumberingSystemError`: If the numbering system is not supported by the locale.
|
|||
|
|
©Údecimal_quantizationÚgroup_separatorrk )r r# r
|
|||
|
|
Údecimal_formatsÚ
|
|||
|
|
parse_patternÚapply©r• Úformatr& r¦ r§ rk Úpatterns r r” r” s\ € ôp �\‰\˜&Ò.¤JÓ
|
|||
|
|
/€FØ
|
|||
|
|
€~Ø×'Ñ'¨Ñ/ˆÜ˜FÓ#€GØ �=‰=ØØØ 1Ø'Ø)ð ó ð r Úshort)Ú format_typer& Úfraction_digitsrk c óÞ — t j |xs t « }|j | }t | |||« \ } }|€|j
|
|||
|
|
d }t
|
|||
|
|
|« }|j | |d|¬« S )uˆ Return the given decimal number formatted for a specific locale in compact form.
|
|||
|
|
|
|||
|
|
>>> format_compact_decimal(12345, format_type="short", locale='en_US')
|
|||
|
|
'12K'
|
|||
|
|
>>> format_compact_decimal(12345, format_type="long", locale='en_US')
|
|||
|
|
'12 thousand'
|
|||
|
|
>>> format_compact_decimal(12345, format_type="short", locale='en_US', fraction_digits=2)
|
|||
|
|
'12.34K'
|
|||
|
|
>>> format_compact_decimal(1234567, format_type="short", locale="ja_JP")
|
|||
|
|
'123万'
|
|||
|
|
>>> format_compact_decimal(2345678, format_type="long", locale="mk")
|
|||
|
|
'2 милиони'
|
|||
|
|
>>> format_compact_decimal(21000000, format_type="long", locale="mk")
|
|||
|
|
'21 милион'
|
|||
|
|
>>> format_compact_decimal(12345, format_type="short", locale='ar_EG', fraction_digits=2, numbering_system='default')
|
|||
|
|
'12٫34\xa0أل�'
|
|||
|
|
|
|||
|
|
:param number: the number to format
|
|||
|
|
:param format_type: Compact format to use ("short" or "long")
|
|||
|
|
:param locale: the `Locale` object or locale identifier. Defaults to the system numeric locale.
|
|||
|
|
:param fraction_digits: Number of digits after the decimal point to use. Defaults to `0`.
|
|||
|
|
:param numbering_system: The numbering system used for formatting number symbols. Defaults to "latn".
|
|||
|
|
The special value "default" will use the default numbering system of the locale.
|
|||
|
|
:raise `UnsupportedNumberingSystemError`: If the numbering system is not supported by the locale.
|
|||
|
|
NF©r¦ rk )r r# r
|
|||
|
|
Úcompact_decimal_formatsÚ_get_compact_formatr¨ r© rª )r• r¯ r& r° rk Úcompact_formatr¬ r s r Úformat_compact_decimalr¶ ` s} € ôB �\‰\˜&Ò.¤JÓ
|
|||
|
|
/€FØ×3Ñ3°KÑ@€NÜ(¨° ÀÈ ÓY�N€FˆFà
|
|||
|
|
€~Ø×'Ñ'¨Ñ-ˆÜ˜FÓ#€GØ �=‰=ØØØ "Ø)ð ó ð r c
|
|||
|
|
óÐ — t | t j « s t j t | « « } | j « s| j « r| dfS d}t
|
|||
|
|
|d D �cg c]
|
|||
|
|
}t |« ‘Œ c}d¬« D ]Ö }t | « |k\ sŒ|d t |« }t |« j }|dk( r | |fS t t j | |d|j d« dz
|
|||
|
|
z z z « } t | |« }|j t | « « } | |vrd} | dk( rd|v rd} t |« || vrd} || t |« }|} | |fS | |fS c c}w ) zÑReturns the number after dividing by the unit and the format pattern to use.
|
|||
|
|
The algorithm is described here:
|
|||
|
|
https://www.unicode.org/reports/tr35/tr35-45/tr35-numbers.html#Compact_Number_Formats.
|
|||
|
|
Nr3 T)ÚreverseÚ0r¡ é Ú1)r- rw r˜ r Úis_nanÚ is_infiniteÚsortedrœ r� r© r r r: Úroundr5 )
|
|||
|
|
r• rµ r& r° r¬ ÚmÚ magnituder Úroundedr5 s
|
|||
|
|
r r´ r´ � sx € ô �fœgŸo™oÔ .Ü— ‘ ¤ V£Ó-ˆØ
|
|||
|
|
‡}�}„˜&×,Ñ,Ô.Ø�tˆ|ÐØ
|
|||
|
|
€Fܨ^¸GÑ-DÖ E¨œS �VÒ EÈtÔTò ˆ Ü ˆv‹;˜)Ó #à# GÑ,¬S°«^Ñ<ˆFÜ# FÓ+×3Ñ3ˆGà˜#Š~Øð( �6ˆ>Ðô# Ü—‘ؘ)¨¨w¯}©}¸SÓ/AÀAÑ/EÑ(FÑGÑHóˆFô
|
|||
|
|
˜F OÓ4ˆGà ×,Ñ,¬S°«[Ó9ˆKØ .Ñ0Ø %� ؘŠ{˜s nÑ 4Ø !� Ü�9‹~ ^°KÑ%@Ñ@Ø %� Ø# KÑ0´°Y³ Ñ@ˆFØ ˆFØ Ø �6ˆ>Ðð7ð6 �6ˆ>Ðùò7 Fs Á+E#c ó — e Zd ZdZy)ÚUnknownCurrencyFormatErrorz>Exception raised when an unknown currency format is requested.Nru r r r rÄ rÄ ½ s „ ÚHr rÄ c
|
|||
|
|
ó — t j |xs t « }|dk( rt | |||||||¬« S |r t |« } n |j
|
|||
|
|
| } | j | ||||||¬« S # t $ r t |›d�« d‚w xY w)uò Return formatted currency value.
|
|||
|
|
|
|||
|
|
>>> format_currency(1099.98, 'USD', locale='en_US')
|
|||
|
|
'$1,099.98'
|
|||
|
|
>>> format_currency(1099.98, 'USD', locale='es_CO')
|
|||
|
|
'US$1.099,98'
|
|||
|
|
>>> format_currency(1099.98, 'EUR', locale='de_DE')
|
|||
|
|
'1.099,98\xa0\u20ac'
|
|||
|
|
>>> format_currency(1099.98, 'EGP', locale='ar_EG', numbering_system='default')
|
|||
|
|
'\u200f1٬099٫98\xa0ج.م.\u200f'
|
|||
|
|
|
|||
|
|
The format can also be specified explicitly. The currency is
|
|||
|
|
placed with the '¤' sign. As the sign gets repeated the format
|
|||
|
|
expands (¤ being the symbol, ¤¤ is the currency abbreviation and
|
|||
|
|
¤¤¤ is the full name of the currency):
|
|||
|
|
|
|||
|
|
>>> format_currency(1099.98, 'EUR', '\xa4\xa4 #,##0.00', locale='en_US')
|
|||
|
|
'EUR 1,099.98'
|
|||
|
|
>>> format_currency(1099.98, 'EUR', '#,##0.00 \xa4\xa4\xa4', locale='en_US')
|
|||
|
|
'1,099.98 euros'
|
|||
|
|
|
|||
|
|
Currencies usually have a specific number of decimal digits. This function
|
|||
|
|
favours that information over the given format:
|
|||
|
|
|
|||
|
|
>>> format_currency(1099.98, 'JPY', locale='en_US')
|
|||
|
|
'\xa51,100'
|
|||
|
|
>>> format_currency(1099.98, 'COP', '#,##0.00', locale='es_ES')
|
|||
|
|
'1.099,98'
|
|||
|
|
|
|||
|
|
However, the number of decimal digits can be overridden from the currency
|
|||
|
|
information, by setting the last parameter to ``False``:
|
|||
|
|
|
|||
|
|
>>> format_currency(1099.98, 'JPY', locale='en_US', currency_digits=False)
|
|||
|
|
'\xa51,099.98'
|
|||
|
|
>>> format_currency(1099.98, 'COP', '#,##0.00', locale='es_ES', currency_digits=False)
|
|||
|
|
'1.099,98'
|
|||
|
|
|
|||
|
|
If a format is not specified the type of currency format to use
|
|||
|
|
from the locale can be specified:
|
|||
|
|
|
|||
|
|
>>> format_currency(1099.98, 'EUR', locale='en_US', format_type='standard')
|
|||
|
|
'\u20ac1,099.98'
|
|||
|
|
|
|||
|
|
When the given currency format type is not available, an exception is
|
|||
|
|
raised:
|
|||
|
|
|
|||
|
|
>>> format_currency('1099.98', 'EUR', locale='root', format_type='unknown')
|
|||
|
|
Traceback (most recent call last):
|
|||
|
|
...
|
|||
|
|
UnknownCurrencyFormatError: "'unknown' is not a known currency format type"
|
|||
|
|
|
|||
|
|
>>> format_currency(101299.98, 'USD', locale='en_US', group_separator=False)
|
|||
|
|
'$101299.98'
|
|||
|
|
|
|||
|
|
>>> format_currency(101299.98, 'USD', locale='en_US', group_separator=True)
|
|||
|
|
'$101,299.98'
|
|||
|
|
|
|||
|
|
You can also pass format_type='name' to use long display names. The order of
|
|||
|
|
the number and currency name, along with the correct localized plural form
|
|||
|
|
of the currency name, is chosen according to locale:
|
|||
|
|
|
|||
|
|
>>> format_currency(1, 'USD', locale='en_US', format_type='name')
|
|||
|
|
'1.00 US dollar'
|
|||
|
|
>>> format_currency(1099.98, 'USD', locale='en_US', format_type='name')
|
|||
|
|
'1,099.98 US dollars'
|
|||
|
|
>>> format_currency(1099.98, 'USD', locale='ee', format_type='name')
|
|||
|
|
'us ga dollar 1,099.98'
|
|||
|
|
|
|||
|
|
By default the locale is allowed to truncate and round a high-precision
|
|||
|
|
number by forcing its format pattern onto the decimal part. You can bypass
|
|||
|
|
this behavior with the `decimal_quantization` parameter:
|
|||
|
|
|
|||
|
|
>>> format_currency(1099.9876, 'USD', locale='en_US')
|
|||
|
|
'$1,099.99'
|
|||
|
|
>>> format_currency(1099.9876, 'USD', locale='en_US', decimal_quantization=False)
|
|||
|
|
'$1,099.9876'
|
|||
|
|
|
|||
|
|
:param number: the number to format
|
|||
|
|
:param currency: the currency code
|
|||
|
|
:param format: the format string to use
|
|||
|
|
:param locale: the `Locale` object or locale identifier.
|
|||
|
|
Defaults to the system currency locale or numeric locale.
|
|||
|
|
:param currency_digits: use the currency's natural number of decimal digits
|
|||
|
|
:param format_type: the currency format type to use
|
|||
|
|
:param decimal_quantization: Truncate and round high-precision numbers to
|
|||
|
|
the format pattern. Defaults to `True`.
|
|||
|
|
:param group_separator: Boolean to switch group separator on/off in a locale's
|
|||
|
|
number format.
|
|||
|
|
:param numbering_system: The numbering system used for formatting number symbols. Defaults to "latn".
|
|||
|
|
The special value "default" will use the default numbering system of the locale.
|
|||
|
|
:raise `UnsupportedNumberingSystemError`: If the numbering system is not supported by the locale.
|
|||
|
|
Úname)r& r¬ Úcurrency_digitsr¦ r§ rk z$ is not a known currency format typeN©r* rÇ r¦ r§ rk ) r r# r Ú_format_currency_long_namer© Úcurrency_formatsrp rÄ rª )
|
|||
|
|
r• r* r¬ r& rÇ r¯ r¦ r§ rk r s
|
|||
|
|
r Úformat_currencyrË Á s € ôP �\‰\˜&Ò/¤KÓ
|
|||
|
|
0€Fà�fÒ Ü)Ø Ø ØØØ +Ø!5Ø +Ø -ô
|
|||
|
|
ð
|
|||
|
|
ñ Ü Ó'‰ð Ø ×-Ñ-¨kÑ:ˆGð �=‰=ØØØØ'Ø 1Ø'Ø)ð ó ð øô ò Ü,Ø �/Ð!EÐFóàð
|
|||
|
|
ð ús ÁA, Á,Bc ó — t | t « r t | « n| }t |||¬« } t |||¬« }
|
|||
|
|
|s|j
|
|||
|
|
d }t
|
|||
|
|
|« } | j | ||||||¬« } | j | |
|
|||
|
|
« S )N)r: r& rÈ ) r- r ÚfloatrJ r> r¨ r© rª r¬ )
|
|||
|
|
r• r* r& r¬ rÇ r¦ r§ rk Únumber_nÚ unit_patternÚ display_namer Ú number_parts
|
|||
|
|
r rÉ rÉ L s” € ô( !+¨6´3Ô 7Œu�VŒ}¸V€Hô -¨X¸XÈfÔU€Lô % X°XÀfÔM€Lñ Ø×'Ñ'¨Ñ-ˆä˜FÓ#€Gà—-‘-ØØØØ'Ø 1Ø'Ø)ð ó €Kð × Ñ ˜{¨LÓ 9Ð9r c óö — t j |xs t « } |j | }t
|
|||
|
|
| |||« \ } }|�
|
|||
|
|
dt |« vr^|d D ]V } |d | j }d|vrŒt j dd|« }t j dd|« j « } n |€ t d « ‚t |« }
|
|||
|
|
|
|
|||
|
|
j | ||d
|
|||
|
|
d
|
|||
|
|
|¬ « S # t $ r}t |›d�« |‚d}~ww xY w) u Format a number as a currency value in compact form.
|
|||
|
|
|
|||
|
|
>>> format_compact_currency(12345, 'USD', locale='en_US')
|
|||
|
|
'$12K'
|
|||
|
|
>>> format_compact_currency(123456789, 'USD', locale='en_US', fraction_digits=2)
|
|||
|
|
'$123.46M'
|
|||
|
|
>>> format_compact_currency(123456789, 'EUR', locale='de_DE', fraction_digits=1)
|
|||
|
|
'123,5\xa0Mio.\xa0€'
|
|||
|
|
|
|||
|
|
:param number: the number to format
|
|||
|
|
:param currency: the currency code
|
|||
|
|
:param format_type: the compact format type to use. Defaults to "short".
|
|||
|
|
:param locale: the `Locale` object or locale identifier.
|
|||
|
|
Defaults to the system currency locale or numeric locale.
|
|||
|
|
:param fraction_digits: Number of digits after the decimal point to use. Defaults to `0`.
|
|||
|
|
:param numbering_system: The numbering system used for formatting number symbols. Defaults to "latn".
|
|||
|
|
The special value "default" will use the default numbering system of the locale.
|
|||
|
|
:raise `UnsupportedNumberingSystemError`: If the numbering system is not supported by the locale.
|
|||
|
|
z, is not a known compact currency format typeNõ ¤r3 u [^0\s\¤]Ú z(\s)\s+z\1zANo compact currency format found for the given number and locale.F)r* rÇ r¦ rk )r r# r Úcompact_currency_formatsrp rÄ r´ r r ÚreÚsubÚstripr7 r© rª ) r• r* r¯ r& r° rk rµ rr r¬ rÁ r s r Úformat_compact_currencyrÙ { s( € ô8 �\‰\˜&Ò/¤KÓ
|
|||
|
|
0€FðØ ×8Ñ8¸ÑEˆô
|
|||
|
|
)¨° ÀÈ ÓY�N€FˆFà
|
|||
|
|
€~˜¤S¨£[Ñ0à'¨Ñ0ò ˆIØ# GÑ,¨YÑ7×?Ñ?ˆFؘ6Ñ!Øä—V‘V˜L¨"¨fÓ5ˆFä—V‘V˜J¨¨vÓ6×<Ñ<Ó>ˆFÙ ð ð €~ÜÐ\Ó]Ð]ܘFÓ#€GØ �=‰=ØØØØ Ø "Ø)ð
|
|||
|
|
ó ð øô) ò Ü(؈oÐ IÐ Jó
|
|||
|
|
àð ûðús ŸC à C8Ã$C3Ã3C8c ó — t j |xs t « }|s|j d }t |« }|j | ||||¬« S )uþ Return formatted percent value for a specific locale.
|
|||
|
|
|
|||
|
|
>>> format_percent(0.34, locale='en_US')
|
|||
|
|
'34%'
|
|||
|
|
>>> format_percent(25.1234, locale='en_US')
|
|||
|
|
'2,512%'
|
|||
|
|
>>> format_percent(25.1234, locale='sv_SE')
|
|||
|
|
'2\xa0512\xa0%'
|
|||
|
|
>>> format_percent(25.1234, locale='ar_EG', numbering_system='default')
|
|||
|
|
'2Ù¬512%'
|
|||
|
|
|
|||
|
|
The format pattern can also be specified explicitly:
|
|||
|
|
|
|||
|
|
>>> format_percent(25.1234, '#,##0\u2030', locale='en_US')
|
|||
|
|
'25,123‰'
|
|||
|
|
|
|||
|
|
By default the locale is allowed to truncate and round a high-precision
|
|||
|
|
number by forcing its format pattern onto the decimal part. You can bypass
|
|||
|
|
this behavior with the `decimal_quantization` parameter:
|
|||
|
|
|
|||
|
|
>>> format_percent(23.9876, locale='en_US')
|
|||
|
|
'2,399%'
|
|||
|
|
>>> format_percent(23.9876, locale='en_US', decimal_quantization=False)
|
|||
|
|
'2,398.76%'
|
|||
|
|
|
|||
|
|
>>> format_percent(229291.1234, locale='pt_BR', group_separator=False)
|
|||
|
|
'22929112%'
|
|||
|
|
|
|||
|
|
>>> format_percent(229291.1234, locale='pt_BR', group_separator=True)
|
|||
|
|
'22.929.112%'
|
|||
|
|
|
|||
|
|
:param number: the percent number to format
|
|||
|
|
:param format:
|
|||
|
|
:param locale: the `Locale` object or locale identifier. Defaults to the system numeric locale.
|
|||
|
|
:param decimal_quantization: Truncate and round high-precision numbers to
|
|||
|
|
the format pattern. Defaults to `True`.
|
|||
|
|
:param group_separator: Boolean to switch group separator on/off in a locale's
|
|||
|
|
number format.
|
|||
|
|
:param numbering_system: The numbering system used for formatting number symbols. Defaults to "latn".
|
|||
|
|
The special value "default" will use the default numbering system of the locale.
|
|||
|
|
:raise `UnsupportedNumberingSystemError`: If the numbering system is not supported by the locale.
|
|||
|
|
Nr¥ )r r# r
|
|||
|
|
Úpercent_formatsr© rª r« s r Úformat_percentrÜ ¸ sZ € ôf �\‰\˜&Ò.¤JÓ
|
|||
|
|
/€FÙ Ø×'Ñ'¨Ñ-ˆÜ˜FÓ#€GØ �=‰=ØØØ 1Ø'Ø)ð ó ð r c óž — t j |xs t « }|s|j d }t |« }|j | |||¬« S )up Return value formatted in scientific notation for a specific locale.
|
|||
|
|
|
|||
|
|
>>> format_scientific(10000, locale='en_US')
|
|||
|
|
'1E4'
|
|||
|
|
>>> format_scientific(10000, locale='ar_EG', numbering_system='default')
|
|||
|
|
'1أس4'
|
|||
|
|
|
|||
|
|
The format pattern can also be specified explicitly:
|
|||
|
|
|
|||
|
|
>>> format_scientific(1234567, '##0.##E00', locale='en_US')
|
|||
|
|
'1.23E06'
|
|||
|
|
|
|||
|
|
By default the locale is allowed to truncate and round a high-precision
|
|||
|
|
number by forcing its format pattern onto the decimal part. You can bypass
|
|||
|
|
this behavior with the `decimal_quantization` parameter:
|
|||
|
|
|
|||
|
|
>>> format_scientific(1234.9876, '#.##E0', locale='en_US')
|
|||
|
|
'1.23E3'
|
|||
|
|
>>> format_scientific(1234.9876, '#.##E0', locale='en_US', decimal_quantization=False)
|
|||
|
|
'1.2349876E3'
|
|||
|
|
|
|||
|
|
:param number: the number to format
|
|||
|
|
:param format:
|
|||
|
|
:param locale: the `Locale` object or locale identifier. Defaults to the system numeric locale.
|
|||
|
|
:param decimal_quantization: Truncate and round high-precision numbers to
|
|||
|
|
the format pattern. Defaults to `True`.
|
|||
|
|
:param numbering_system: The numbering system used for formatting number symbols. Defaults to "latn".
|
|||
|
|
The special value "default" will use the default numbering system of the locale.
|
|||
|
|
:raise `UnsupportedNumberingSystemError`: If the numbering system is not supported by the locale.
|
|||
|
|
Nr² )r r# r
|
|||
|
|
Úscientific_formatsr© rª )r• r¬ r& r¦ rk r s r Úformat_scientificrß ø sW € ôL �\‰\˜&Ò.¤JÓ
|
|||
|
|
/€FÙ Ø×*Ñ*¨4Ñ0ˆÜ˜FÓ#€GØ �=‰=ØØØ 1Ø)ð ó ð r c ó& ‡ — e Zd ZdZddˆ fd„
|
|||
|
|
Zˆ xZS )ÚNumberFormatErrorz>Exception raised when a string cannot be parsed into a number.c ó2 •— t ‰| � |« || _ y rL )Úsuperr Ú suggestions)r Úmessagerä Ú __class__s €r r zNumberFormatError.__init__- s ø€ Ü
|
|||
|
|
‰Ñ˜Ô!à&ˆÕr rL )rå r rä zlist[str] | Noner r )r r r r r Ú
|
|||
|
|
__classcell__)ræ s @r rá rá * s ø„ ÙH÷'ò 'r rá > õ  õ  ú ú|c ó — t ||¬« }|t v r/|| vr+t j | « rt j || « } t | j
|
|||
|
|
|d« « S # t $ r}t | ›d�« |‚d}~ww xY w)a¹ Parse localized number string into an integer.
|
|||
|
|
|
|||
|
|
>>> parse_number('1,099', locale='en_US')
|
|||
|
|
1099
|
|||
|
|
>>> parse_number('1.099', locale='de_DE')
|
|||
|
|
1099
|
|||
|
|
|
|||
|
|
When the given string cannot be parsed, an exception is raised:
|
|||
|
|
|
|||
|
|
>>> parse_number('1.099,98', locale='de')
|
|||
|
|
Traceback (most recent call last):
|
|||
|
|
...
|
|||
|
|
NumberFormatError: '1.099,98' is not a valid number
|
|||
|
|
|
|||
|
|
:param string: the string to parse
|
|||
|
|
:param locale: the `Locale` object or locale identifier. Defaults to the system numeric locale.
|
|||
|
|
:param numbering_system: The numbering system used for formatting number symbols. Defaults to "latn".
|
|||
|
|
The special value "default" will use the default numbering system of the locale.
|
|||
|
|
:return: the parsed number
|
|||
|
|
:raise `NumberFormatError`: if the string can not be converted to a number
|
|||
|
|
:raise `UnsupportedNumberingSystemError`: if the numbering system is not supported by the locale.
|
|||
|
|
rm rÔ z is not a valid numberN) r‰ Ú SPACE_CHARSÚSPACE_CHARS_REÚsearchr× rœ Úreplacer7 rá )Ústringr& rk Ú group_symbolÚves r Ú parse_numberrô < sˆ € ô8 $ FÐ=MÔN€Lð œ Ñ#à Ñ &ä × !Ñ ! &Ô )ô ×#Ñ# L°&Ó9ˆðMÜ�6—>‘> ,°Ó3Ó4Ð4øÜ ò MÜ 6 *Ð,BÐ CÓDÈ"ÐLûðMús ÁA! Á! A>Á*A9Á9A>c óD — t j |xs t « }t ||¬« }t ||¬« }|s7|t
|
|||
|
|
v r/|| vr+t j | « rt j || « } t j | j |d« j |d« « }|r�|| v r™t ||d|¬« }| |k7 r…|t | |« k7 rv t j | j |d« j |d« « } t | |d|¬« }
|
|||
|
|
|
|
|||
|
|
|k( rt | ›d|›d �|g¬
|
|||
|
|
« ‚t | ›d|›d |
|
|||
|
|
›d �||
|
|||
|
|
g¬
|
|||
|
|
« ‚|S # t j $ r}t | ›d�« |‚d}~ww xY w# t j $ r}t | ›d|›d �|g¬
|
|||
|
|
« |‚d}~ww xY w) u6 Parse localized decimal string into a decimal.
|
|||
|
|
|
|||
|
|
>>> parse_decimal('1,099.98', locale='en_US')
|
|||
|
|
Decimal('1099.98')
|
|||
|
|
>>> parse_decimal('1.099,98', locale='de')
|
|||
|
|
Decimal('1099.98')
|
|||
|
|
>>> parse_decimal('12 345,123', locale='ru')
|
|||
|
|
Decimal('12345.123')
|
|||
|
|
>>> parse_decimal('1Ù¬099Ù«98', locale='ar_EG', numbering_system='default')
|
|||
|
|
Decimal('1099.98')
|
|||
|
|
|
|||
|
|
When the given string cannot be parsed, an exception is raised:
|
|||
|
|
|
|||
|
|
>>> parse_decimal('2,109,998', locale='de')
|
|||
|
|
Traceback (most recent call last):
|
|||
|
|
...
|
|||
|
|
NumberFormatError: '2,109,998' is not a valid decimal number
|
|||
|
|
|
|||
|
|
If `strict` is set to `True` and the given string contains a number
|
|||
|
|
formatted in an irregular way, an exception is raised:
|
|||
|
|
|
|||
|
|
>>> parse_decimal('30.00', locale='de', strict=True)
|
|||
|
|
Traceback (most recent call last):
|
|||
|
|
...
|
|||
|
|
NumberFormatError: '30.00' is not a properly formatted decimal number. Did you mean '3.000'? Or maybe '30,00'?
|
|||
|
|
|
|||
|
|
>>> parse_decimal('0.00', locale='de', strict=True)
|
|||
|
|
Traceback (most recent call last):
|
|||
|
|
...
|
|||
|
|
NumberFormatError: '0.00' is not a properly formatted decimal number. Did you mean '0'?
|
|||
|
|
|
|||
|
|
:param string: the string to parse
|
|||
|
|
:param locale: the `Locale` object or locale identifier. Defaults to the system numeric locale.
|
|||
|
|
:param strict: controls whether numbers formatted in a weird way are
|
|||
|
|
accepted or rejected
|
|||
|
|
:param numbering_system: The numbering system used for formatting number symbols. Defaults to "latn".
|
|||
|
|
The special value "default" will use the default numbering system of the locale.
|
|||
|
|
:raise NumberFormatError: if the string can not be converted to a
|
|||
|
|
decimal number
|
|||
|
|
:raise UnsupportedNumberingSystemError: if the numbering system is not supported by the locale.
|
|||
|
|
rm rÔ r z is not a valid decimal numberNF)r& r¦ rk z: is not a properly formatted decimal number. Did you mean ú?)rä z ? Or maybe )r r# r
|
|||
|
|
r‰ ry rí rî rï r× rw r˜ rð ÚInvalidOperationrá r” Ú$_remove_trailing_zeros_after_decimal) rñ r& Ústrictrk rò Údecimal_symbolÚparsedÚexcÚproperÚ
|
|||
|
|
parsed_altÚ
|
|||
|
|
proper_alts r Ú
|
|||
|
|
parse_decimalr k sø € ô` �\‰\˜&Ò.¤JÓ
|
|||
|
|
/€FÜ# FÐ=MÔN€LÜ'¨ÐAQÔR€Ná Øœ Ñ#Ø Ñ &ä × !Ñ ! &Ô )ô ×#Ñ# L°&Ó9ˆðVÜ— ‘ § ¡ ° ¸bÓ!A×!IÑ!IÈ.ÐZ]Ó!^Ó_ˆñ �, &Ñ(Ü Ø ØØ!&Ø -ô
|
|||
|
|
ˆð �VÒ Ô*NÈvÐWeÓ*fÒ fð
|
|||
|
|
Ü $Ÿ_™_Ø—N‘N >°2Ó6×>Ñ>¸|ÈSÓQó �
|
|||
|
|
ô ,Ø Ø!Ø).Ø%5ô �
|
|||
|
|
ð Ò'Ü+Ø!˜*ð %(Ø(. z°ð4à%+ Hôð ô ,Ø!˜*ð %(Ø(. z°¸Z¸NÈ!ðMà%+¨ZÐ$8ôð ð
|
|||
|
|
€MøôO × #Ñ #ò VÜ 6 *Ð,JÐ KÓLÐRUÐUûðVûô ×+Ñ+ò
|
|||
|
|
Ü'Ø �jð !$Ø$* :¨Qð0à!' ôð ð ûð
|
|||
|
|
ús0 Á25E Ã5E2 ÅE/ÅE*Å*E/Å2F ÆFÆF c ón — | j |« \ }}}|r |j d« }|r||z |z S |S | S )a½
|
|||
|
|
Remove trailing zeros from the decimal part of a numeric string.
|
|||
|
|
|
|||
|
|
This function takes a string representing a numeric value and a decimal symbol.
|
|||
|
|
It removes any trailing zeros that appear after the decimal symbol in the number.
|
|||
|
|
If the decimal part becomes empty after removing trailing zeros, the decimal symbol
|
|||
|
|
is also removed. If the string does not contain the decimal symbol, it is returned unchanged.
|
|||
|
|
|
|||
|
|
:param string: The numeric string from which to remove trailing zeros.
|
|||
|
|
:type string: str
|
|||
|
|
:param decimal_symbol: The symbol used to denote the decimal point.
|
|||
|
|
:type decimal_symbol: str
|
|||
|
|
:return: The numeric string with trailing zeros removed from its decimal part.
|
|||
|
|
:rtype: str
|
|||
|
|
|
|||
|
|
Example:
|
|||
|
|
>>> _remove_trailing_zeros_after_decimal("123.4500", ".")
|
|||
|
|
'123.45'
|
|||
|
|
>>> _remove_trailing_zeros_after_decimal("100.000", ".")
|
|||
|
|
'100'
|
|||
|
|
>>> _remove_trailing_zeros_after_decimal("100", ".")
|
|||
|
|
'100'
|
|||
|
|
r¹ )Ú partitionÚrstrip)rñ rú Ú integer_partÚ_Ú decimal_parts r rø rø Ô sL € ð0 %+×$4Ñ$4°^Ó$DÑ!€L�!�\áØ#×*Ñ*¨3Ó/ˆ Ù Ø .Ñ0°<Ñ?Ð ?ØÐà €Mr zJ(?P<prefix>(?:[^'0-9@#.,]|'[^']*')*)(?P<number>[0-9@#.,E+]*)(?P<suffix>.*)c ó¶ — t | « }| j d« }|dk( ry||z
|
|||
|
|
dz
|
|||
|
|
}| d| dz
|
|||
|
|
j d« }|dk( r||fS ||z
|
|||
|
|
|z
|
|||
|
|
dz
|
|||
|
|
}||fS )z¹Parse primary and secondary digit grouping
|
|||
|
|
|
|||
|
|
>>> parse_grouping('##')
|
|||
|
|
(1000, 1000)
|
|||
|
|
>>> parse_grouping('#,###')
|
|||
|
|
(3, 3)
|
|||
|
|
>>> parse_grouping('#,####,###')
|
|||
|
|
(3, 4)
|
|||
|
|
rˆ éÿÿÿÿ)éè r rº NrŽ )ÚlenÚrfind)ÚpÚwidthÚg1Úg2s r Úparse_groupingr þ sx € ô
|
|||
|
|
�‹F€EØ
|
|||
|
|
�‰�‹ €BØ ˆR‚xØØ �‰�a‰ €BØ
|
|||
|
|
ˆ9ˆbˆS�1‰Wˆ × Ñ ˜CÓ €BØ ˆR‚xØ�2ˆvˆ
|
|||
|
|
Ø �‰�b‰ ˜1Ñ €BØ
|
|||
|
|
ˆrˆ6€Mr Ú
|
|||
|
|
NumberPatternc ó( — t | t « r| S d„ }| }d| v r.| j dd« \ }} ||« \ }}} ||« \ }}} n ||« \ }}}d|› �}|} d|v r|j dd« \ }}
|
|||
|
|
nd}
|
|||
|
|
d|v rd|v rd |v r t d
|
|||
|
|
« ‚d|v r|j dd« \ } } n|} d } d „ }
|
|||
|
|
|
|
|||
|
|
| « } |
|
|||
|
|
| « }|
|
|||
|
|
r+|
|
|||
|
|
j d
|
|||
|
|
« }|
|
|||
|
|
j
|
|||
|
|
d
|
|||
|
|
« }
|
|||
|
|
|
|
|||
|
|
|
|
|||
|
|
« }nd}d}t | « }t | ||f|| f||||||« S )z Parse number format patternsc ól — t j | « }|€t d| ›�« ‚|j « S )NzInvalid number pattern )Ú_number_pattern_rerï r7 Úgroups)r Úrvs r Ú
|
|||
|
|
_match_numberz$parse_pattern.<locals>._match_number s6 € Ü
|
|||
|
|
×
|
|||
|
|
&Ñ
|
|||
|
|
& wÓ
|
|||
|
|
/ˆØ
|
|||
|
|
ˆ:Ü Ð 6°w°kÐ BÓCÐ CØ�y‰y‹{Ðr ú;rº r€ r„ Nú@r r¹ z5Significant digit patterns can not contain "@" or "0"rÔ c óh — dx}}| D ]& }|dv r |dz
|
|||
|
|
}|dz
|
|||
|
|
}Œ|dk( r|dz
|
|||
|
|
}Œ |dk( rŒ# ||fS ||fS )z(Calculate the min and max allowed digitsr z@0rº ú#rˆ r )r ÚminÚmaxÚcs r Úparse_precisionz&parse_pattern.<locals>.parse_precision6 sd € àˆ
|
|||
|
|
ˆˆcØò ˆAØ�D‰yØ�q‘�Ø�q‘‘Ø�c’Ø�q‘‘Ø�c’ØàØ�Cˆxˆð ð �Cˆxˆr r| )r- r Úsplitr7 ÚrsplitÚ
|
|||
|
|
startswithÚlstripr )r r Ú pos_patternÚ neg_patternÚ
|
|||
|
|
pos_prefixr• Ú
|
|||
|
|
pos_suffixÚ
|
|||
|
|
neg_prefixr Ú
|
|||
|
|
neg_suffixÚexpÚintegerÚfractionr Úint_precÚ frac_precÚexp_plusÚexp_precÚgroupings r r© r© sm € ä�'œ=Ô)؈òð €Kð ˆg�~Ø#*§=¡=°°aÓ#8Ñ ˆ �[Ù)6°{Ó)CÑ&ˆ
|
|||
|
|
�F˜JÙ$1°+Ó$>Ñ!ˆ
|
|||
|
|
�A‘zá)6°{Ó)CÑ&ˆ
|
|||
|
|
�F˜Jؘ˜ Ð%ˆ
|
|||
|
|
Ø ˆ
|
|||
|
|
Ø
|
|||
|
|
ˆf�}Ø —l‘l 3¨Ó*‰ ˆ‘àˆØ
|
|||
|
|
ˆf�}˜ ™ ¨3°&©=ÜÐPÓQÐQØ
|
|||
|
|
ˆf�}Ø "ŸM™M¨#¨qÓ 1ш‘àˆØˆò
|
|||
|
|
ñ ˜wÓ'€HÙ Ó)€IÙ
|
|||
|
|
Ø—>‘> #Ó&ˆØ�j‰j˜‹oˆÙ" 3Ó'‰àˆØˆÜ ˜gÓ&€HÜ ØØ �ZÐ Ø �ZÐ ØØØØØØó
|
|||
|
|
ð
|
|||
|
|
r c ó — e Zd Z d
|
|||
|
|
dd„Zdd„Zdd„Zddœ dd„Z dddœ dd„Zdd „Z dd
|
|||
|
|
„Z dd „Z
|
|||
|
|
d
|
|||
|
|
dd „Z y)r Nc
|
|||
|
|
ó¬ — || _ || _ || _ | | _ || _ || _ || _ || _ || _ | j « | _
|
|||
|
|
y rL ) r ÚprefixÚsuffixÚnumber_patternr1 r- r. r0 r/ Ú
|
|||
|
|
compute_scaleÚscale)
|
|||
|
|
r r r4 r5 r1 r- r. r0 r/ r6 s
|
|||
|
|
r r zNumberPattern.__init__] sT € 𠈌 Ø ˆŒ Ø ˆŒ Ø ,ˆÔØ ˆŒ
|
|||
|
|
Ø ˆŒ
|
|||
|
|
Ø"ˆŒØ ˆŒ
|
|||
|
|
Ø ˆŒ
|
|||
|
|
Ø×'Ñ'Ó)ˆ�
|
|||
|
|
r c óN — dt | « j › d| j ›d�S )Nú<rê ú>)Útyper r )r s r Ú__repr__zNumberPattern.__repr__u s' € Ø”4˜“:×&Ñ&Ð' q¨¯ © Ð(8¸Ð:Ð:r c ó¾ — d}ddj | j | j z « v rd}|S ddj | j | j z « v rd}|S )u Return the scaling factor to apply to the number before rendering.
|
|||
|
|
|
|||
|
|
Auto-set to a factor of 2 or 3 if presence of a ``%`` or ``‰`` sign is
|
|||
|
|
detected in the prefix or suffix of the pattern. Default is to not mess
|
|||
|
|
with the scale at all and keep it to 0.
|
|||
|
|
r ú%rÔ rŽ u ‰é )Újoinr4 r5 )r r8 s r r7 zNumberPattern.compute_scalex s] € ð ˆØ �"—'‘'˜$Ÿ+™+¨¯ © Ñ3Ó4Ñ 4؈Eð ˆ ð �b—g‘g˜dŸk™k¨D¯K©KÑ 7Ó8Ñ
|
|||
|
|
8؈E؈ r rf rm c óR — |j « }|t |« z }|j « dk( sJ ‚t dt | j « g« dz
|
|||
|
|
}||z
|
|||
|
|
}|t | « z }d}|dk rt ||¬« }n| j r
|
|||
|
|
t ||¬« }t |« }|||fS )z=Returns normalized scientific notation components of a value.r rº rÔ rm ) Úadjustedr£ r r r- r� r/ r} r� )r Úvaluer& rk r* Ú
|
|||
|
|
lead_shiftÚexp_signs r Ú scientific_notation_elementsz*NumberPattern.scientific_notation_elements† s· € ð �n‰nÓ ˆØÔ+¨CÓ0Ñ0ˆØ�~‰~Ó 1Ò$Ð$Ð$ô
|
|||
|
|
˜!œS § ¡ Ó /Ð0Ó1°AÑ5ˆ
|
|||
|
|
Ø�JÑ ˆØÔ+¨Z¨KÓ8Ñ8ˆð ˆØ �Š7Ü,¨VÐFVÔW‰HØ
|
|||
|
|
�]Š]Ü+¨FÐEUÔVˆHô �#‹hˆà�c˜8Ð#Ð#r c ó¼ — t |t j « s t j t |« « }|j | j
|