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-05-21 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-05-21 UTC."],[[["\u003cp\u003eRepresents an amount of money with its currency type using a JSON object.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON object includes fields for the currency code (ISO 4217), whole units of the amount, and nano units for fractional amounts.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eunits\u003c/code\u003e represents the whole monetary value, while \u003ccode\u003enanos\u003c/code\u003e handles fractional amounts with a precision of 10^-9.\u003c/p\u003e\n"],["\u003cp\u003eThe combination of \u003ccode\u003eunits\u003c/code\u003e and \u003ccode\u003enanos\u003c/code\u003e allows for precise representation of monetary values, including positive, negative, and zero values, ensuring accuracy.\u003c/p\u003e\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. |"]]