Money

JSON representation

Represents an amount of money with its currency type.

JSON representation
{ "currencyCode" : string , "units" : string , "nanos" : integer }

Fields

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.

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-07-22 UTC.

Create a Mobile Website

View Site in Mobile | Classic

Share by:

Money Stay organized with collections Save and categorize content based on your preferences.

Money