Decimal

تمثيل لقيمة عشرية، مثل 2.5 يمكن للعملاء تحويل القيم إلى تنسيقات عشرية متوافقة مع اللغة، مثل BigDecimal في Java أو decimal.Decimal في Python.

تمثيل JSON 
{
  "value": string
}
الحقول
value

string

القيمة العشرية، كسلسلة

يتألف التمثيل السلسلي من إشارة اختيارية، + (U+002B) أو - (U+002D)، متبوعة بسلسلة من صفر أو أكثر من الأرقام العشرية ("العدد الصحيح")، متبوعة بشكل اختياري بكسر، متبوعة بشكل اختياري بأس. يجب تفسير السلسلة الفارغة على أنّها 0.

يتألف الجزء الكسري من فاصلة عشرية متبوعة بصفر أو أكثر من الأرقام العشرية. يجب أن يحتوي السلسلة على رقم واحد على الأقل في العدد الصحيح أو الكسر. يُشار إلى الرقم المكوّن من العلامة والعدد الصحيح والكسر باسم الجزء الدال.

يتألف الأس من الحرف e (U+0065) أو E (U+0045) متبوعًا برقم عشري واحد أو أكثر.

يجب أن تعمل الخدمات على تسوية القيم العشرية قبل تخزينها من خلال:

  • إزالة علامة + تم توفيرها بشكلٍ صريح (+2.5 -> 2.5)
  • استبدال قيمة عدد صحيح بطول صفر بـ 0 (من .5 إلى 0.5)
  • تحويل حرف الأس إلى حرف كبير، مع إشارة صريحة (2.5e8 -> 2.5E+8).
  • إزالة الأسّ الصفري المقدَّم بشكلٍ صريح (2.5E0 -> 2.5)

قد تجري الخدمات تسوية إضافية استنادًا إلى احتياجاتها الخاصة وتنفيذها الداخلي للقيم العشرية المحدّدة، مثل نقل العلامة العشرية وقيمة الأس معًا (مثال: 2.5E-1 <-> 0.25). بالإضافة إلى ذلك، قد تحتفظ الخدمات بالأصفار اللاحقة في الكسر للإشارة إلى زيادة الدقة، ولكن ليس مطلوبًا منها ذلك.

يُرجى العِلم أنّه لا يمكن استخدام سوى الحرف . لتقسيم العدد الصحيح والكسر، , يجب عدم استخدامه بغض النظر عن اللغة. بالإضافة إلى ذلك، لا يجب أن تكون فواصل الآلاف متاحة. إذا كانت الخدمة تتيح استخدامها، يجب تنظيم القيم.

قواعد ENBF هي:

DecimalString =
  '' | [Sign] Significand [Exponent];

Sign = '+' | '-';

Significand =
  Digits ['.'] [Digits] | [Digits] '.' Digits;

Exponent = ('e' | 'E') [Sign] Digits;

Digits = { '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' };

يجب أن توثّق الخدمات بوضوح نطاق القيم المتوافقة والحد الأقصى للدقة المتوافقة (إجمالي عدد الأرقام)، والمقياس (عدد الأرقام بعد الفاصلة العشرية) إن كان ذلك منطبقًا، بالإضافة إلى طريقة عملها عند تلقّي قيم خارج النطاق.

يجوز للخدمات قبول القيم التي يتم تمريرها كمدخلات حتى عندما تكون القيمة ذات دقة أو مقياس أعلى مما تسمح به الخدمة، ويجب تقريب القيمة لتناسب المقياس المسموح به. بدلاً من ذلك، قد تعرض الخدمة الخطأ 400 Bad Request (INVALID_ARGUMENT في gRPC) إذا كان سيتم فقدان الدقة.

يجب أن تعرض الخدمات الخطأ 400 Bad Request (INVALID_ARGUMENT في gRPC) إذا تلقّت قيمة خارج النطاق المتوافق.