Money
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
JSON 表現 |
{
"currencyCode": string,
"units": string,
"nanos": integer
} |
フィールド |
currencyCode |
string
ISO 4217 で定義されている 3 文字の通貨コード。
|
units |
string (int64 format)
金額の整数部分。たとえば、currencyCode が "USD" の場合、1 単位は 1 米ドルです。
|
nanos |
integer
金額の小数部分をナノ(10^-9)単位で表した数。値は -999,999,999 以上 +999,999,999 以下でなければなりません。units が正の場合、nanos には正数または 0 を指定します。units がゼロの場合、nanos には正数、0、または負数を指定できます。units が負の場合、nanos は負数または 0 を指定します。たとえば、$-1.75 は units = -1、nanos = -750,000,000 と表されます。
|
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-26 UTC。
[null,null,["最終更新日 2025-07-26 UTC。"],[[["\u003cp\u003eMoney is represented using a JSON object with currency code, whole units, and nano units.\u003c/p\u003e\n"],["\u003cp\u003eCurrency is specified by a three-letter ISO 4217 code like "USD".\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eunits\u003c/code\u003e field stores the whole currency units, while \u003ccode\u003enanos\u003c/code\u003e stores fractional units (10^-9).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003enanos\u003c/code\u003e value must be within -999,999,999 to +999,999,999 and its sign must align with the sign of \u003ccode\u003eunits\u003c/code\u003e.\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. |"]]