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/08/31 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]
