Money
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Représente un montant associé à un type de devise.
| Représentation JSON |
{
"currencyCode": string,
"units": string,
"nanos": integer
} |
| Champs |
currencyCode |
string
Code de devise à trois lettres défini dans la norme ISO 4217.
|
units |
string (int64 format)
Unités entières du montant. Par exemple, si currencyCode correspond à "USD", une unité correspond à un dollar américain.
|
nanos |
integer
Nombre de nano-unités (10^-9) du montant. La valeur doit être comprise entre -999 999 999 et +999 999 999 inclus. Si units est positif, nanos doit être positif ou nul. Si units est égal à zéro, nanos peut être positif, nul ou négatif. Si units est négatif, nanos doit être négatif ou nul. Par exemple, -1,75 $ est représenté par units=-1 et nanos=-750 000 000.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]
