Money
Stay organized with collections
Save and categorize content based on your preferences.
Represents an amount of money with its currency type.
| JSON representation |
{
"currencyCode": string,
"units": string,
"nanos": integer
} |
| Fields |
currencyCode |
string
The three-letter currency code defined in ISO 4217.
|
units |
string (int64 format)
The whole units of the amount. For example if currencyCode is "USD", then 1 unit is one US dollar.
|
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.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-27 UTC.
[null,null,["Last updated 2025-08-27 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. |"]]
