تنسيقات التاريخ والأرقام

تتيح لك تنسيقات التاريخ والوقت والأرقام إمكانية التحكّم في كيفية ظهور بياناتك في جدول بيانات. توفّر "جداول بيانات Google" بعض التنسيقات الشائعة للاختيار من بينها، ولكن يمكنك أيضًا تحديد تنسيقاتك الخاصة.

في واجهة مستخدم "جداول بيانات Google"، يمكنك تطبيق تنسيقات الأرقام والتواريخ على الخلايا باستخدام القائمة التنسيق > رقم. في Sheets API، يمكنك ضبط هذه التنسيقات باستخدام طلب طريقة spreadsheets.batchUpdate لإرسال UpdateCellsRequest أو RepeatCellRequest.

توضّح هذه الصفحة كيفية تحديد أنماط جديدة لتنسيقات التاريخ والأرقام، والتي يمكنك تضمينها في طلب البيانات من واجهة برمجة التطبيقات. يوضّح المثال ضبط تنسيق مخصّص للتاريخ والوقت أو تنسيق عشري لنطاق كيفية ضبط نمط تنسيق باستخدام واجهة برمجة التطبيقات. يُرجى العِلم أنّ العرض الفعلي للتنسيق يعتمد على locale في جدول البيانات. يفترض هذا الدليل أنّ قيمة locale هي en_US. يمكنك تحديد locale لجدول بيانات من خلال قراءة SpreadsheetProperties باستخدام طلب spreadsheets.get.

لمحة عن قيم التاريخ والوقت

تتعامل "جداول بيانات Google"، مثل معظم تطبيقات جداول البيانات الأخرى، مع قيم التاريخ والوقت كقيم عشرية. يتيح لك ذلك إجراء عمليات حسابية عليها في الصيغ، حتى تتمكّن من زيادة الأيام أو الأسابيع أو طرح تاريخَين ووقتَين أو جمعهما، وإجراء عمليات أخرى مماثلة.

تستخدم "جداول بيانات Google" نوعًا من تاريخ بدء الحقبة الشائع الاستخدام في جداول البيانات. يحتسب الجزء العددي الصحيح من القيمة (على يسار العلامة العشرية) عدد الأيام منذ 30 كانون الأول (ديسمبر) 1899. ويحتسب الجزء الكسري (على يمين العلامة العشرية) الوقت ككسر من يوم واحد. على سبيل المثال، يمثّل التاريخ 1 يناير 1900 عند الظهر القيمة 2.5، 2 لأنّه يقع بعد يومَين من 30 ديسمبر 1899، والقيمة 0.5 لأنّ الظهر هو نصف يوم. ‫1 فبراير 1900 الساعة 3 مساءً هي 33.625.

تعامل "جداول بيانات Google" مع العام 1900 على أنّه عام عادي وليس سنة كبيسة.

أنماط تنسيق التاريخ والوقت

نمط تنسيق التاريخ والوقت هو سلسلة من السلاسل الفرعية للرموز المميزة، وعند تحليلها، يتم استبدالها بعناصر التاريخ والوقت المقابلة (مثل الشهر أو الساعة).

رموز تنسيق التاريخ والوقت

يحدّد الجدول التالي السلاسل الفرعية للرموز المميزة التي يمكنك استخدامها في نمط تنسيق التاريخ والوقت. يشير الرمز + إلى أنّه يمكن أن يظهر الحرف السابق مرة واحدة أو أكثر مع استمرار تطابقه مع النمط. يتم التعامل مع الأحرف غير المدرَجة في الجدول أدناه على أنّها أحرف حرفية، ويتم إخراجها بدون تغييرات.

الرمز المميز الوصف
h ساعة من اليوم يتم التبديل بين تنسيقَي 12 ساعة و24 ساعة استنادًا إلى ما إذا كان مؤشر صباحًا أو مساءً متوفرًا في السلسلة.
hh+ كما في المثال السابق، ولكن مع إضافة 0 في البداية للأرقام من 1 إلى 9.
m إذا كانت الرمز المميز السابق غير الحرفي هو ساعات أو كان الرمز المميز اللاحق هو ثوانٍ، فإنّه يمثّل الدقائق في الساعة (بدون 0 في البداية). في ما عدا ذلك، تمثّل شهر السنة كرقم (بدون البدء بصفر).
M شهر السنة بدون البدء بصفر. استخدِم هذا الرمز المميّز لتحديد شهر بشكل صريح، بدلاً من دقيقة، في نمطك.
mm القيمة نفسها في m، ولكن مع إضافة 0 في البداية في كلتا الحالتين.
MM شهر السنة مع البدء بصفر استخدِم هذا الرمز المميّز لتحديد شهر بشكل صريح، بدلاً من دقيقة، في نمطك.
mmm اختصار الشهر المكوّن من ثلاثة أحرف (على سبيل المثال، "فبراير").
mmmm اسم الشهر الكامل يتطابق mmmmmm+ أيضًا مع هذا التعبير.
mmmmm الحرف الأول من الشهر (على سبيل المثال، "ي" لشهر يونيو).
s الثواني في الدقيقة بدون 0 بادئ
ss الثواني في الدقيقة مع إضافة 0 في البداية.
[h+] عدد الساعات المنقضية في مدة زمنية يشير عدد الأحرف إلى الحد الأدنى لعدد الأرقام (يضيف أصفارًا بادئة).
[m+] عدد الدقائق المنقضية في مدة زمنية يشير عدد الأحرف إلى الحد الأدنى لعدد الأرقام (يضيف أصفارًا بادئة).
[s+] عدد الثواني المنقضية في مدة زمنية يشير عدد الأحرف إلى الحد الأدنى لعدد الأرقام (يضيف أصفارًا بادئة).
d يوم الشهر، بدون صفر في بداية الأرقام الأقل من 10
dd اليوم من الشهر، مع إضافة 0 في البداية للأرقام الأقل من 10
ddd يوم من الأسبوع، اختصار من ثلاثة أحرف (على سبيل المثال، "الاثنين").
dddd+ يوم الأسبوع، الاسم الكامل
y السنة بتنسيق من رقمين
yy
yyy السنة بتنسيق من 4 أرقام
yyyy+
a/p تعرض هذه السمة "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 p
hh:mm A/P".M." ‫04:08 مساءً
yyyy-mm-dd 2016-04-05
mmmm d \[dddd\] ‫5 أبريل [الثلاثاء]
h PM, ddd mmm dd ‫4:00 مساءً، الثلاثاء 05 أبريل
dddd, m/d/yy at h:mm الثلاثاء، 5 أبريل 2016 الساعة 16:08
أنماط الوقت المنقضي 3 hours, 13 minutes, 41.255 seconds
[hh]:[mm]:[ss].000 03:13:41.255
[mmmm]:[ss].000 0193:41.255

أنماط تنسيق الأرقام

نمط تنسيق الأرقام هو سلسلة من السلاسل الفرعية للرموز المميزة التي يتم استبدالها، عند تحليلها، بتمثيلات الأرقام المقابلة. يمكن أن يتألف نمط تنسيق الأرقام من أربعة أقسام كحد أقصى، مفصولة بفواصل منقوطة، تحدد التنسيقات المنفصلة المستخدَمة للأرقام الموجبة والأرقام السالبة والصفر والنص (بهذا الترتيب):

[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]

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

[NUMBER FORMAT]
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT]
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]

ومع ذلك، إذا كان هناك قسمان أو أكثر وكان القسم الأخير بتنسيق نصي، يتم التعامل مع هذا القسم على أنّه بتنسيق نصي، ويتم التعامل مع الأقسام الأخرى كما لو كان هناك قسم أقل. وبالتالي، من خلال تضمين تنسيق نص نهائي، يمكن تحديد تنسيقات مثل:

[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT]
[NUMBER FORMAT];[TEXT FORMAT]

تتم عملية تحليل التنسيق إلى أقسام قبل أي عملية تحليل أخرى، لذا يمكن تضمين تنسيق تاريخ أو وقت كأحد الأقسام (مع أنّ فائدة ذلك محدودة).

رموز تنسيق الأرقام

يحدّد الجدول التالي السلاسل الفرعية للرموز المميزة التي يمكنك استخدامها في قسم التنسيق لتحديد كيفية تمثيل القيم لهذا القسم.

الرمز المميز الوصف
0 تمثّل رقمًا في العدد. إذا كان الرقم 0 ثانويًا، سيتم عرضه على أنّه 0. على سبيل المثال، يعرض تنسيق الأرقام 00.0 الرقم 3 على النحو التالي: "03.0".
# تمثّل رقمًا في العدد. إذا كان الرقم 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. يتم تجاهله حاليًا.
_ يتخطّى الرمز المميز للشرطة السفلية الحرف التالي ويعرض مسافة. يُستخدَم هذا الخيار لمحاذاة تنسيقات الأرقام التي تكون فيها القيمة السالبة محاطة بأقواس.
\ يتعامل مع الحرف التالي كقيمة حرفية وليس كأي معنى خاص قد يحمله. على سبيل المثال، يعرض تنسيق الأرقام \#0 الرقم 10 على النحو التالي: "#10".
"text" تعرض أي نص داخل علامات الاقتباس كقيمة حرفية.
@ إذا كانت الخلية تحتوي على نص مُدخَل، يتم إدراج النص الأولي للخلية. لا يتوافق مع أي من الرموز الخاصة الأخرى ولا يظهر للقيم الرقمية (التي يتم عرضها بتنسيق عام).
$ - + ( ) : space تتعامل "جداول بيانات Google" مع هذه الأحرف كقيم حرفية وتعرضها بدون تغيير.

التعليمات الوصفية

بالإضافة إلى ذلك، يمكن أن يحتوي كل قسم من أقسام التنسيق على تعليمات وصفية اختيارية، مضمّنة بين علامتَي []، تسبق التنسيق وتوفّر تعليمات إضافية. هناك نوعان من التعليمات الوصفية ويمكن لأي قسم استخدام كليهما:

مدرسة تعليم الوصف
[condition] يستبدل المقارنة التلقائية الموجبة أو السالبة أو الصفرية للقسم بتعبير شرطي آخر. على سبيل المثال، تعرض [<100]”Low”;[>1000]”High”;000 الكلمة "منخفض" للقيم الأقل من 100، و"مرتفع" للقيم الأعلى من 1000، ورقمًا من ثلاثة أرقام (مع أصفار بادئة) لأي قيمة بينهما. لا يمكن تطبيق الشروط إلا على التنسيقَين الفرعيَين الأولَين، وإذا تطابق رقم مع أكثر من تنسيق فرعي، سيتم استخدام التنسيق الأول الذي يتطابق معه. إذا كان هناك تنسيق ثالث، يتم استخدامه مع "كل ما عدا ذلك"، وإذا لم يتطابق رقم مع أي من التنسيقين، يتم عرضه على شكل علامات "#" تملأ عرض الخلية. إذا كان التنسيق الرابع متوفّرًا، يتم استخدامه دائمًا للنص.
[Color] or [Color#] تتسبّب هذه الصيغة الفرعية في ظهور أي قيمة يتم عرضها بلون النص المحدّد. القيم الصالحة لـ Color هي Black أو Blue أو Cyan أو Green أو Magenta أو Red أو White أو Yellow. القيم الصالحة للرمز "#" في Color# هي 1 إلى 56 (تعرض لوحة الألوان هذه قائمة بالألوان التي تتوافق مع كل رقم). تتجاوز ألوان تنسيق الأرقام أي ألوان أدخلها المستخدم في الخلية، ولكنها لا تتجاوز الألوان التي تم ضبطها باستخدام التنسيق الشرطي.

أمثلة على تنسيق الأرقام

يعرض الجدول التالي بعض الأمثلة على الأنماط وطريقة عرض الأرقام المنسّقة المقابلة:

العدد النمط القيمة المنسّقة
12345.125 ####.# 12345.1
12.34 000.0000 012.3400
12 #.0# 12.0
5.125 # ???/??? 5 1/8
12000 #,### 12,000
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