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

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

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

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

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

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

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

يتعامل تطبيق "جداول بيانات Google" بشكل صحيح مع عام 1900 على أنه عام مشترك، وليس على أنه عام كبيس.

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

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

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

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

الرمز المميز الوصف
h ساعة من اليوم. للتبديل بين تنسيق 12 و24 ساعة استنادًا إلى ما إذا كان هناك مؤشر AM أو PM في السلسلة.
hh+ مثل السابق، ولكن بفارق 0 في الترتيب من 1 إلى 9.
m أما إذا كان الرمز المميّز السابق غير الحرفي هو ساعات أو كان الرمز التالي بالثواني، فإنه يمثّل الدقائق بالساعة (بدون 0 في البداية). وبخلاف ذلك، يمثّل الشهر من السنة كرقم (بدون 0 في البداية).
M شهر من السنة بدون 0 في البداية. ويمكنك استخدام هذا الرمز المميّز لتحديد شهر صراحةً بدلاً من دقيقة واحدة في النقش.
mm مثل m، ولكن ببادئة 0 في كلتا الحالتين.
MM شهر من السنة بتصدر 0. ويمكنك استخدام هذا الرمز المميّز لتحديد شهر صراحةً بدلاً من دقيقة واحدة في النقش.
mmm اختصار الأشهر المكوّن من ثلاثة أحرف (مثل "فبراير").
mmmm اسم الشهر بالكامل mmmmmm+ يطابق هذا أيضًا.
mmmmm الحرف الأول من الشهر (على سبيل المثال، "J" لشهر حزيران (يونيو)).
s الثواني في الدقيقة بدون 0 بادئة.
ss الثواني في الدقيقة بفارق 0 في الصدارة.
[h+] عدد الساعات المنقضية في مدة زمنية معيّنة. يشير عدد الأحرف إلى أقل عدد من الأرقام (يضيف 0 في البداية).
[m+] عدد الدقائق المنقضية في مدة زمنية معيّنة. يشير عدد الأحرف إلى أقل عدد من الأرقام (يضيف 0 في البداية).
[s+] عدد الثواني المنقضية في مدة زمنية معيّنة. يشير عدد الأحرف إلى أقل عدد من الأرقام (يضيف 0 في البداية).
d يوم من الشهر، بدون البادئة 0 للأرقام الأقل من 10.
dd يوم من الشهر، مع إدراج 0 في البداية للأرقام الأقل من 10.
ddd يوم من الأسبوع، اختصار مكوّن من ثلاثة أحرف (مثل "اثنين").
dddd+ يوم من الأسبوع، الاسم الكامل
y سنة مكونة من رقمين.
yy
yyy سنة مكونة من 4 أرقام.
yyyy+
a/p عرض "a" لصباحًا و "p" لصباح اليوم. يتم أيضًا تغيير الساعات إلى تنسيق 12 ساعة. وإذا كان حرف الرمز المميّز مكتوبًا بالأحرف الكبيرة، تكون النتيجة أيضًا.
am/pm على النحو الوارد أعلاه، ولكن يعرض "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 بعد الظهر، الثلاثاء 5 نيسان (أبريل)
dddd, m/d/yy at h:mm الثلاثاء، 4/5/16 الساعة 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" مع هذه الأحرف على أنّها قيم حرفية وتعرضها بدون تغيير.

تعليمات Meta

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

مدرسة تعليم الوصف
[condition] يستبدل المقارنة التلقائية الموجبة أو السالبة أو الصفرية للقسم بتعبير شرطي آخر. على سبيل المثال، يعرض [<100]”Low”;[>1000]”High”;000 الكلمة "منخفض" للقيم الأقل من 100، و"مرتفع" للقيم الأكبر من 1,000، ورقم مكون من ثلاثة أرقام (مع 0 بادئ) لأي قيمة بينهما. لا يمكن تطبيق الشروط إلا على أول تنسيقَين فرعيَين. وإذا كان الرقم يتطابق مع أكثر من تنسيق، يستخدم الرقم الأول الذي يتطابق معه. وإذا كان هناك تنسيق ثالث، يتم استخدامه لكل شيء آخر، وفي حال عدم تطابق الرقم مع أي من التنسيقَين، يتم عرضه على أنّه جميع "#" التي تملأ عرض الخلية. وفي حال توفّرها، يتم دائمًا استخدام التنسيق الرابع مع النص.
[Color] or [Color#] يؤدي إلى ظهور أي قيمة يعرضها هذا التنسيق الفرعي مع لون النص المعنيّ. والقيم الصالحة للسمة Color هي الأسود أو الأزرق أو السماوي أو الأخضر أو الأرجواني أو الأحمر أو الأبيض أو الأصفر. القيم الصالحة للسمة "#" في Color# هي 0&ndash1;56 (تعرض لوحة الألوان هذه قائمة بالألوان المناسبة لكل رقم). تلغي ألوان تنسيق الأرقام أي ألوان أدخلها المستخدم في الخلية، ولكنها لا تلغي الألوان التي تم ضبطها بواسطة التنسيق الشرطي.

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

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

العدد النمط القيمة المنسّقة
12345.125 ####.# 12345.1
12.34 000.0000 012.3400
12 #.0# 12.0
5.125 # ???/??? 5 1/8
12000 #,### 12000
1230000 0.0,,"M" ‫1.2 مليون
1234500000 0.00e+00 1.23e+09
123114.15115
نصي
###0.000;"TEXT: "_(@_) 123114.151
النص: MyText
1234
-1234
0
نصي
[Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_) 1,234
1,234
0.0
MyText
1005
32
527
[>1000]"HIGH";[Color43][<=200]"LOW";0000 مرتفع
منخفض
0527