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

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

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

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

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

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

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

تتعامل "جداول بيانات Google" بشكل صحيح مع العام 1900 كعام عادي، وليس كعام كبيس.

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

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

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

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

الرمز المميز	الوصف
h	ساعة من اليوم للتبديل بين تنسيق 12 ساعة و24 ساعة استنادًا إلى ما إذا كان هناك مؤشر AM أو PM في السلسلة
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	اليوم من الشهر، مع البدء بصفر للأرقام التي تقل عن 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	الثلاثاء 5‏/4‏/2016 في الساعة 4:08 مساءً
أنماط الوقت المنقضي	3 hours, 13 minutes, 41.255 seconds
[hh]:[mm]:[ss].000	03:13:41.255
[mmmm]:[ss].000	0193:41.255

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

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

[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 هي أسود أو أزرق أو أزرق سماوي أو أخضر أو أرجواني أو أحمر أو أبيض أو أصفر. القيم الصالحة للرمز "#" في 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	مرتفع منخفض 0527