Money

  • The JSON representation for money includes the currency code, whole units, and nano units.

  • The currencyCode field uses the three-letter ISO 4217 standard.

  • The units field represents the whole amount, while nanos represents the fractional part in billionths.

  • The nanos field has constraints on its value based on whether the units field is positive, zero, or negative.

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.