يوضّح هذا المستند كيفية تحديد أنماط جديدة لتنسيق التاريخ والأرقام، والتي يمكنك تضمينها في طلب البيانات من واجهة برمجة التطبيقات.
تتيح لك تنسيقات التاريخ والوقت والأرقام التحكّم في كيفية ظهور بياناتك في ورقة بيانات. توفّر "جداول بيانات Google" بعض التنسيقات الشائعة للاختيار من بينها، ولكن يمكنك أيضًا تحديد تنسيقاتك الخاصة.
في واجهة مستخدم "جداول بيانات Google"، يمكنك تطبيق تنسيقات الأرقام والتواريخ على الخلايا
باستخدام قائمة التنسيق > الرقم. في Google Sheets API، يمكنك ضبط هذه التنسيقات باستخدام طلب إجراء spreadsheets.batchUpdate لإرسال UpdateCellsRequest أو RepeatCellRequest.
في الطلب، يمكنك ضبط عنصر
NumberFormat
من خلال تحديد
NumberFormatType
(مثل NUMBER أو CURRENCY أو PERCENT أو DATE أو TIME) وسلسلة
pattern اختيارية. في حال حذف pattern، تستخدم "جداول بيانات Google" نمط التنسيق التلقائي لـ type المحدّد استنادًا إلى locale جدول البيانات (على سبيل المثال، $1,000.12 لـ CURRENCY في en_US).
يوضّح النموذج ضبط تنسيق مخصّص للتاريخ والوقت أو تنسيق عشري لنطاق كيفية ضبط نمط تنسيق باستخدام Sheets API. يُرجى العِلم أنّ العرض الفعلي للتنسيق يعتمد على locale في جدول البيانات.
يفترض هذا المستند أنّ locale هو en_US. يمكنك تحديد locale
جدول بيانات من خلال قراءة العنصر
SpreadsheetProperties
باستخدام طريقة
spreadsheets.get
في المورد
spreadsheets.
لمزيد من النماذج، يُرجى الاطّلاع على التنسيق الأساسي والتنسيق الشرطي.
لمحة عن قيم التاريخ والوقت
تتعامل "جداول بيانات Google"، مثل معظم تطبيقات جداول البيانات الأخرى، مع قيم التاريخ والوقت كقيم عشرية. يتيح لك ذلك إجراء عمليات حسابية عليها في الصيغ، بحيث يمكنك زيادة الأيام أو الأسابيع، وإضافة تاريخين ووقتين أو طرحهما، وإجراء عمليات أخرى مماثلة.
تستخدم "جداول بيانات Google" شكلاً من أشكال تاريخ
العصر الذي يشيع استخدامه في
جداول البيانات. يحتسب الجزء الصحيح من القيمة (على يسار الفاصلة العشرية) عدد الأيام منذ 30 ديسمبر 1899. ويحتسب الجزء الكسري (على يمين الفاصلة العشرية)
الوقت كجزء من يوم واحد. على سبيل المثال، 1 يناير 1900 عند الظهر
هو 2.5، 2 لأنه بعد يومين من 30 ديسمبر 1899، و0.5 لأن
الظهر هو نصف يوم. 1 فبراير 1900 في الساعة 3 بعد الظهر هو 33.625.
تتعامل "جداول بيانات Google" بشكل صحيح مع عام 1900 على أنّه سنة بسيطة وليس سنة كبيسة. لا تخزّن الأرقام التسلسلية للتاريخ والوقت فرق المنطقة الزمنية. بدلاً من ذلك،
تستند إلى
timeZone
جدول البيانات،
والتي يمكنك قراءتها من الكائن
SpreadsheetProperties
باستخدام الطريقة
spreadsheets.get.
أنماط تنسيق التاريخ والوقت
نمط تنسيق التاريخ والوقت هو سلسلة من السلاسل الفرعية للرموز المميّزة التي يستبدلها تطبيق "جداول بيانات Google" بعناصر التاريخ والوقت المقابلة (مثل الشهر أو الساعة) عند تحليلها.
رموز تنسيق التاريخ والوقت
يحدّد الجدول التالي السلاسل الفرعية للرموز المميّزة التي يمكنك استخدامها في نمط تنسيق التاريخ والوقت. يشير الرمز + إلى أنّ الحرف السابق يمكن أن يظهر مرة واحدة أو أكثر مع استمرار تطابقه مع النمط. تتعامل "جداول بيانات Google" مع الأحرف غير المدرَجة في هذا الجدول على أنّها أحرف حرفية وتُخرجها بدون تغييرات.
| الرمز المميز | الوصف |
|---|---|
h |
ساعة من اليوم يتم التبديل بين تنسيق 12 ساعة و24 ساعة بناءً على ما إذا كان مؤشر صباحًا أو مساءً موجودًا في السلسلة. |
hh+ |
مثل الخيار السابق، ولكن مع إضافة صفر في البداية للأرقام من 1 إلى 9. |
m |
إذا كان الرمز السابق غير الحرفي هو الساعات أو الرمز اللاحق هو الثواني، يمثّل هذا الرمز الدقائق في الساعة (بدون 0 في البداية). وإلا، فإنها تمثل شهر السنة كرقم (بدون 0 في البداية). |
M |
الشهر من السنة بدون صفر في البداية استخدِم هذا الرمز المميّز لتحديد شهر صراحةً، بدلاً من دقيقة، في النمط. |
mm |
هو مطابق لـ m، ولكن مع إضافة 0 في بداية كلتا الحالتَين. |
MM |
الشهر من السنة مع البدء بصفر. استخدِم هذا الرمز المميّز لتحديد شهر صراحةً، بدلاً من دقيقة، في النمط. |
mmm |
اختصار الشهر المكوّن من ثلاثة أحرف (على سبيل المثال، "Feb"). |
mmmm |
اسم الشهر الكامل يتطابق "mmmmmm+" أيضًا مع هذا الطلب. |
mmmmm |
الحرف الأول من الشهر (على سبيل المثال، "ي" لشهر يونيو). |
s |
الثواني في الدقيقة بدون صفر بادئ |
ss |
الثواني في الدقيقة مع صفر بادئ. |
[h+] |
عدد الساعات المنقضية في مدة زمنية معيّنة يشير عدد الأحرف إلى الحد الأدنى لعدد الأرقام (يضيف أصفارًا بادئة). |
[m+] |
عدد الدقائق المنقضية في مدة زمنية معيّنة يشير عدد الأحرف إلى الحد الأدنى لعدد الأرقام (يضيف أصفارًا بادئة). |
[s+] |
عدد الثواني المنقضية في مدة زمنية معيّنة يشير عدد الأحرف إلى الحد الأدنى لعدد الأرقام (يضيف أصفارًا بادئة). |
d |
يوم من الشهر، بدون صفر في البداية للأرقام الأقل من 10. |
dd |
يوم الشهر، مع البدء بالرقم 0 للأرقام الأقل من 10. |
ddd |
يوم من الأسبوع، اختصار من ثلاثة أحرف (على سبيل المثال، "Mon"). |
dddd+ |
يوم من الأسبوع، الاسم الكامل |
y |
السنة بتنسيق من رقمَين |
yy |
|
yyy |
السنة بتنسيق من 4 أرقام |
yyyy+ |
|
a/p |
لعرض "ص" للإشارة إلى صباحًا و "م" للإشارة إلى مساءً يؤدي أيضًا إلى تغيير الساعات إلى تنسيق 12 ساعة. إذا كان حرف الرمز المميز مكتوبًا بأحرف كبيرة، فسيتم أيضًا كتابة الإخراج بأحرف كبيرة. |
am/pm |
كما هو موضّح أعلاه، ولكن يعرض "صباحًا" أو "مساءً" بدلاً من ذلك، ويكون دائمًا بحروف كبيرة. |
0 |
أجزاء من الثانية يمكنك زيادة الدقة إلى رقمَين باستخدام 00 أو ثلاثة أرقام (أجزاء من الثانية) باستخدام 000. |
\ |
يتعامل مع الحرف التالي كقيمة حرفية وليس كأي معنى خاص قد يكون له. |
"text" |
لعرض أي نص داخل علامتي الاقتباس كقيمة حرفية |
أمثلة على تنسيق التاريخ والوقت
بالنظر إلى التاريخ والوقت Tuesday, April 5, 2016, 4:08:53.528 PM، يعرض الجدول التالي بعض الأمثلة على الأنماط وطريقة عرض التاريخ والوقت المقابلة. يعرض القسم الثاني من الجدول أمثلة على تنسيقات الوقت المنقضي
للوقت المنقضي الذي يبلغ 3 hours, 13 minutes, 41.255 seconds:
| أنماط التاريخ والوقت | Tuesday, April 5, 2016, 4:08:53.528 PM |
|---|---|
h:mm:ss.00 a/p |
4:08:53.53 بعد الظهر |
hh:mm A/P".M." |
4:08 بعد الظهر |
yyyy-mm-dd |
2016-04-05 |
mmmm d \[dddd\] |
5 أبريل [الثلاثاء] |
h PM, ddd mmm dd |
4 مساءً، الثلاثاء 5 أبريل |
dddd, m/d/yy at h:mm |
الثلاثاء 5/4/16 في 16:08 |
| أنماط الوقت المنقضي | 3 hours, 13 minutes, 41.255 seconds |
[hh] |
03 |
[mmmm] |
0193 |
[ss] |
11621 |
أنماط تنسيق الأرقام
نمط تنسيق الأرقام هو سلسلة من السلاسل الفرعية للرموز المميّزة التي يستبدلها تطبيق "جداول بيانات Google" بتمثيلات الأرقام المقابلة عند تحليلها. يمكن أن يتكوّن نمط تنسيق الأرقام من أربعة أقسام كحد أقصى، تفصل بينها فواصل منقوطة، وتحدّد التنسيقات المنفصلة المستخدَمة للأرقام الموجبة والأرقام السالبة والصفر والنص (بهذا الترتيب):
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]
ليس عليك تضمين جميع الأقسام الأربعة في التنسيق. إذا قمت بتضمين قسم واحد فقط، فستستخدم "جداول بيانات Google" هذا التنسيق لجميع القيم. يؤدي استخدام قسمين إلى تطبيق التنسيق الأول على الصفر والأرقام الموجبة والتنسيق الثاني على الأرقام السالبة. يؤدي استخدام ثلاثة أقسام إلى تحديد تنسيقات منفصلة للأرقام الموجبة والسالبة والصفرية. على سبيل المثال:
[NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]
ومع ذلك، إذا كان هناك قسمان أو أكثر وكان القسم الأخير بتنسيق نصي، فإن "جداول بيانات Google" تتعامل مع هذا القسم على أنه التنسيق النصي وتتصرف الأقسام الأخرى كما لو كان هناك قسم واحد أقل. وبالتالي، من خلال تضمين تنسيق نص نهائي، يمكن تحديد تنسيقات مثل:
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT] [NUMBER FORMAT];[TEXT FORMAT]
يتم تحليل التنسيق إلى أقسام قبل أي تحليل آخر، لذا من الممكن تضمين تنسيق التاريخ أو الوقت كأحد الأقسام (على الرغم من أن هذا مفيد بشكل محدود).
رموز تنسيق الأرقام
يحدّد الجدول التالي السلاسل الفرعية للرموز المميّزة التي يمكنك استخدامها في قسم التنسيق لتحديد كيفية تمثيل القيم لهذا القسم.
| الرمز المميز | الوصف |
|---|---|
0 |
يمثّل رقمًا في العدد. إذا كان الرقم هو 0 ثانوي،
يتم عرضه على أنه 0. على سبيل المثال، تنسيق الرقم 00.0 يعرض الرقم 3 على النحو التالي: "03.0". |
# |
يمثّل رقمًا في العدد. إذا كان الرقم صفرًا ثانويًا، لن يتم عرضه. على سبيل المثال، تنسيق الأرقام ##0
يعرض الرقم 12 على النحو التالي: "12". |
? |
يمثّل رقمًا في العدد. إذا كان الرقم هو 0 ثانوي،
سيتم عرضه كمسافة. يُستخدم هذا الخيار غالبًا لمحاذاة النقطة العشرية في
عمود عند استخدام خطوط ذات عرض ثابت. على سبيل المثال، تنسيق الأرقام
???.??? يعرض الرقم 12.4 على النحو التالي:
" 12.4 ". |
. |
تمثّل النقطة الأولى النقطة العشرية في الرقم. ويتم عرض الفترات اللاحقة كقيم حرفية. إذا أدرجت نقطة عشرية في التنسيق، يتم عرضها دائمًا، حتى للأعداد الصحيحة. على سبيل المثال،
تعرض السمة #0.# الرقم 3 على النحو التالي: "3.". |
% |
يظهر كقيمة حرفية، ولكنه يؤدي أيضًا إلى ضرب الأرقام الحالية في 100 قبل عرضها لجعل النسب المئوية أكثر قابلية للقراءة. على سبيل المثال، تنسيق الأرقام #%
يعرض الرقم 0.25 على النحو التالي: "25%". |
, |
إذا ظهر بين حرفَين من رقمَين (0 أو # أو ?)، يتم عرض الرقم بالكامل مع فواصل التجميع (التجميع بالآلاف). إذا كانت تتبع
الأحرف الرقمية، فإنها تزيد الأرقام بمقدار ألف لكل
فاصلة (على سبيل المثال، يعرض التنسيق #0.0,, الرقم
12,200,000 على النحو التالي: 12.2). |
E- |
لعرض الرقم بالتنسيق العلمي، مع استخدام التنسيق على يمين E للجزء غير الأسي والتنسيق على يسار E للجزء الأسي. تعرض الدالة E+ علامة + للأسس الموجبة. يعرض E- علامة للأسس السالبة فقط. إذا تم استخدام أحرف صغيرة، سيكون الناتج e بأحرف صغيرة أيضًا.
على سبيل المثال، تنسيق الأرقام ##0.00#E+##
يعرض الرقم 0.0000001 على النحو التالي: "100.00E-9". |
E+ |
|
e- |
|
e+ |
|
/ |
إذا ظهرت بين حرفَين رقميَّين (0 أو # أو ?)، يتم التعامل مع هذه المجموعات الرقمية على أنّها تنسيق كسري. على سبيل المثال، يعرض تنسيق الأرقام 0 #/# الرقم 23.25 على النحو التالي: 23 1/4. يمكن أن يكون المقام أيضًا عددًا صحيحًا حرفيًا، وفي هذه الحالة يفرض هذا العدد الصحيح كمقام. يعرض تنسيق الأرقام 0 #/8
الرقم 23.25 على النحو التالي: 23 2/8. لا يتم عرض الجزء الكسري إذا أصبح البسط 0. يتم عرض الرقم 23.1 بتنسيق الأرقام 0 #/3 على النحو التالي: 23 (لأنّه يتم تقريب 0.1 إلى 0/3). لا يتوافق / مع التنسيق العلمي أو التنسيق الذي يتضمّن نقطة عشرية. |
* |
مضمّنة للتوافق مع تنسيقات الأرقام في Microsoft Excel. يتجاهل تطبيق "جداول بيانات Google" هذا الرمز المميّز. |
_ |
لتخطّي الحرف التالي وعرض مسافة استخدِم هذا الرمز لمواءمة تنسيقات الأرقام التي تحيط فيها الأقواس بالقيمة السالبة. |
\ |
يتعامل مع الحرف التالي كقيمة حرفية وليس كأي معنى خاص قد يكون له. على سبيل المثال، تنسيق الأرقام \#0
يعرض الرقم 10 على النحو التالي: "#10". |
"text" |
لعرض أي نص داخل علامتي الاقتباس كقيمة حرفية |
@ |
إذا كانت الخلية تحتوي على نص، يتم إدراج النص الأولي للخلية. لا يتوافق مع أي من الأحرف الخاصة الأخرى ولا يتم عرضه للقيم الرقمية (التي يتم عرضها كتنسيق عام). |
$ - + ( ) : space |
تتعامل "جداول بيانات Google" مع هذه الأحرف ورموز العملات الشائعة (مثل $ و€ و£ و¥) كسلاسل نصية وتعرضها بدون تغيير. |
تعليمات Meta
بالإضافة إلى ذلك، يمكن أن يتضمّن كل قسم من أقسام التنسيق تعليمات وصفية اختيارية،
مُحاطة بأحرف []، تسبق التنسيق وتوفّر تعليمات إضافية:
| مدرسة تعليم | الوصف |
|---|---|
[condition] |
يستبدل المقارنة التلقائية الموجبة أو السالبة أو الصفرية للقسم بتعبير شرطي آخر. على سبيل المثال،
يعرض [<100]"Low";[>1000]"High";000 الكلمة
"منخفض" للقيم التي تقل عن 100، و"مرتفع" للقيم التي تزيد عن 1000، ورقمًا مكونًا من ثلاثة أرقام (مع أصفار بادئة) لأي قيمة بينهما. يمكنك تطبيق الشروط على أول تنسيقين فرعيين فقط، وإذا تطابق رقم مع أكثر من تنسيق، تستخدم "جداول بيانات Google" التطابق الأول. إذا كان هناك تنسيق ثالث، تستخدمه "جداول بيانات Google" لـ "كل شيء آخر"، وإلا إذا لم يتطابق الرقم مع أي من التنسيقين، تعرض "جداول بيانات Google" جميع أحرف "#" على مستوى عرض الخلية. في حال توفّره، يتم دائمًا استخدام التنسيق الرابع للنص. |
[Color] or [Color#] |
يؤدي إلى ظهور أي قيمة يعرضها هذا التنسيق الفرعي بلون النص المحدّد. القيم الصالحة للسمة Color هي Black أو Blue أو Cyan أو Green أو Magenta أو Red أو White أو Yellow.
القيم الصالحة لـ "#" في Color# هي من 1 إلى 56. تتجاوز ألوان تنسيق الأرقام أي ألوان أدخلها المستخدم في الخلية، ولكنها لا تتجاوز الألوان التي تم ضبطها من خلال التنسيق الشرطي. تعرض
لوحة الألوان
هذه قائمة بالألوان التي تتوافق مع كل رقم. وتستند إلى السمة ColorIndex في Microsoft Excel. |
[$currency] |
تعرض رمز العملة المحدّد أو الرمز كقيمة حرفية (على سبيل المثال، [$€]#,##0.00 أو [$CAD]#,##0.00). إذا قمت بتضمين رمز لغة اختياري بعد واصلة (مثل [$CAD-1009])، يتجاهل تطبيق "جداول بيانات Google" رمز اللغة. |
أمثلة على تنسيق الأرقام
يوضّح الجدول التالي بعض الأمثلة على الأنماط وطريقة عرض الأرقام المنسَّقة المقابلة لها:
| العدد | نمط | القيمة المنسَّقة |
|---|---|---|
| 12345.125 | ####.# |
12345.1 |
| 12.34 | 000.0000 |
012.3400 |
| 12 | #.0# |
12.0 |
| 5.125 | # ???/??? |
5 1/8 |
| 12000 | #,### |
12,000 |
| 1234.56 -1234.56 |
$#,##0.00;($#,##0.00) |
$1,234.56 ($1,234.56) |
| 1230000 | 0.0,,"M" |
1.2 مليون |
| 1234500000 | 0.00e+00 |
1.23e+09 |
| 123114.15115 MyText |
###0.000;"TEXT: "_(@_) |
123114.151 TEXT: MyText |
| 1234 -1234 0 MyText |
[Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_) |
1,234 1,234 0.0 MyText |
| 1005 32 527 |
[>1000]"HIGH";[Color43][<=200]"LOW";0000 |
HIGH LOW 0527 |