z3c.currency 2.0

货币字段

货币字段是一个数值字段，专门设计用于管理货币值。

>>> from z3c.currency import field, interfaces

>>> price = field.Currency(
...    title='Price',
...    description='The price of the item.')

除了常见的属性外，货币字段还提供了两个附加属性，精度和单位。精度用于指定值是提供的整数单位还是整个单位的1/100 - 在美元和分的情况下。默认情况下，此字段设置为分。

>>> price.precision is interfaces.CENTS
True

它可以设置为美元

>>> price.precision = interfaces.DOLLARS
>>> price.precision is interfaces.DOLLARS
True

对于财务应用，我们有时还需要子分

>>> price.precision = interfaces.SUBCENTS
>>> price.precision is interfaces.SUBCENTS
True

注意：是否有更“国际化”的词来表示货币的整个单位？

单位指定了所使用货币的符号。它也用于将数值格式化为字符串。

>>> price.unit
'$'
>>> price.unit = 'SEK'
>>> price.unit
'SEK'

当然，这两个属性都可作为构造函数参数使用

>>> price = field.Currency(
...    title='Price',
...    description='The price of the item.',
...    precision=interfaces.DOLLARS,
...    unit='SEK')

>>> price.precision is interfaces.DOLLARS
True
>>> price.unit
'SEK'

现在让我们看看验证。首先，值必须始终是十进制数

>>> import decimal
>>> price.validate(decimal.Decimal('12'))

>>> price.validate(12)
Traceback (most recent call last):
...
z3c.currency.interfaces.WrongCurrencyType: int

>>> price.validate(12.0)
Traceback (most recent call last):
...
z3c.currency.interfaces.WrongCurrencyType: float

此外，当精度设置为“美元”时，就像这里的情况，值必须是一个整数。

>>> price.validate(decimal.Decimal('12'))

>>> price.validate(decimal.Decimal('12.01'))
Traceback (most recent call last):
...
z3c.currency.interfaces.IncorrectValuePrecision: 0

>>> price.validate(decimal.Decimal('12.00'))
Traceback (most recent call last):
...
z3c.currency.interfaces.IncorrectValuePrecision: 0

当精度设置为“分”时，

>>> price.precision = interfaces.CENTS

则只接受有两位小数的值。

>>> price.validate(decimal.Decimal('12.00'))

>>> price.validate(decimal.Decimal('12'))
Traceback (most recent call last):
...
z3c.currency.interfaces.IncorrectValuePrecision: 1

>>> price.validate(decimal.Decimal('12.0'))
Traceback (most recent call last):
...
z3c.currency.interfaces.IncorrectValuePrecision: 1

如果我们允许小于分的金额，

>>> price.precision = interfaces.SUBCENTS

则允许任何精度。

>>> price.validate(decimal.Decimal('12.0'))
>>> price.validate(decimal.Decimal('12'))
>>> price.validate(decimal.Decimal('12.00001'))

如果该字段不是必需的，…

>>> price.required = False

确保验证仍然通过。

>>> price.validate(None)

请注意，IFromUnicode接口是故意不支持的。

>>> price.fromUnicode
Traceback (most recent call last):
...
AttributeError: 'Currency' object has no attribute 'fromUnicode'

变更记录