Money
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Representa um montante em dinheiro com o respectivo tipo de moeda.
Representação JSON |
{
"currencyCode": string,
"units": string,
"nanos": integer
} |
Campos |
currencyCode |
string
É o código de moeda de três letras definido no ISO 4217.
|
units |
string (int64 format)
As unidades inteiras do montante. Por exemplo, se currencyCode for "USD" , 1 unidade equivalerá a um dólar americano.
|
nanos |
integer
Número de unidades nano (10^-9) do montante. É necessário que o valor fique entre -999.999.999 e +999.999.999 (inclusive os dois limites). Se units for positivo, nanos precisará ser positivo ou zero. Se units for zero, nanos poderá ser positivo, zero ou negativo. Se units for negativo, nanos precisará ser negativo ou zero. Por exemplo,US $-1,75 é representado como units =-1 e nanos =-750.000.000.
|
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 2025-07-26 UTC."],[[["\u003cp\u003eMoney is represented using a JSON object with currency code, whole units, and nano units.\u003c/p\u003e\n"],["\u003cp\u003eCurrency is specified by a three-letter ISO 4217 code like "USD".\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eunits\u003c/code\u003e field stores the whole currency units, while \u003ccode\u003enanos\u003c/code\u003e stores fractional units (10^-9).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003enanos\u003c/code\u003e value must be within -999,999,999 to +999,999,999 and its sign must align with the sign of \u003ccode\u003eunits\u003c/code\u003e.\u003c/p\u003e\n"]]],["The core content defines a JSON structure for representing monetary amounts. It includes three fields: `currencyCode` (a string for the three-letter currency code), `units` (a string representing whole units of the currency), and `nanos` (an integer for the fractional nano-units). The `nanos` value must adhere to constraints based on the sign of `units` and is used for precision in amounts. The amount value is based on those three elements.\n"],null,["# Money\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nRepresents an amount of money with its currency type.\n\n| JSON representation |\n|-----------------------------------------------------------------------|\n| ``` { \"currencyCode\": string, \"units\": string, \"nanos\": integer } ``` |\n\n| Fields ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `currencyCode` | `string` The three-letter currency code defined in ISO 4217. |\n| `units` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The whole units of the amount. For example if `currencyCode` is `\"USD\"`, then 1 unit is one US dollar. |\n| `nanos` | `integer` Number of nano (10\\^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. |"]]