Money
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمثل مبلغًا من المال مع نوع العملة.
| تمثيل JSON |
{
"currencyCode": string,
"units": string,
"nanos": integer
} |
| الحقول |
currencyCode |
string
تمثّل هذه السمة رمز العملة المكوَّن من ثلاثة أحرف والمحدّد في ISO 4217.
|
units |
string (int64 format)
تمثّل هذه السمة الوحدات الكاملة للمبلغ. على سبيل المثال، إذا كانت قيمة السمة currencyCode هي "USD"، تكون قيمة الوحدة الواحدة دولار أمريكي واحد.
|
nanos |
integer
عدد وحدات نانو (10^-9) من الكمية. يجب أن تتراوح القيمة بين -999,999,999 و +999,999,999 أو أكثر. إذا كانت قيمة units موجبة، يجب أن تكون قيمة nanos موجبة أو صفرًا. إذا كانت قيمة units صفرًا، يمكن أن تكون قيمة nanos موجبة أو صفرية أو سالبة. إذا كانت units سالبة، يجب أن تكون قيمة nanos سالبة أو صفرًا. على سبيل المثال، يتم تمثيل $1.75 على النحو التالي: units=-1 وnanos=-750,000,000.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eJSON is used to represent monetary amounts with their currency type.\u003c/p\u003e\n"],["\u003cp\u003eThe representation includes the currency code (ISO 4217), whole units, and nano units for precision.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eunits\u003c/code\u003e and \u003ccode\u003enanos\u003c/code\u003e must adhere to specific rules based on their values to ensure accurate representation.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ecurrencyCode\u003c/code\u003e follows the ISO 4217 standard using a three-letter code.\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. |"]]
