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-08-31 UTC.
[null,null,["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003eJSON is used to represent monetary amounts with their currency type.\u003c/p\u003e\n"],["\u003cp\u003eThe representation includes the currency code (ISO 4217), whole units, and nano units for precision.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eunits\u003c/code\u003e and \u003ccode\u003enanos\u003c/code\u003e must adhere to specific rules based on their values to ensure accurate representation.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ecurrencyCode\u003c/code\u003e follows the ISO 4217 standard using a three-letter code.\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. |"]]