Money
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
| JSON 표현 |
{
"currencyCode": string,
"units": string,
"nanos": integer
} |
| 필드 |
currencyCode |
string
ISO 4217에 정의된 3자리 통화 코드입니다.
|
units |
string (int64 format)
금액의 전체 단위입니다. 예를 들어 currencyCode가 "USD"이면 단위 1개는 1달러(USD)입니다.
|
nanos |
integer
금액의 나노 (10^-9) 단위 숫자입니다. 값은 -999,999,999 ~ +999,999,999(포함) 사이여야 합니다. units가 양수이면 nanos는 양수 또는 0이어야 합니다. units가 0이면 nanos은 양수, 0 또는 음수일 수 있습니다. units가 음수이면 nanos는 음수 또는 0이어야 합니다. 예를 들어 $-1.75는 units=-1, nanos=-750,000,000으로 나타냅니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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. |"]]
