تتيح لك تنسيقات التاريخ والوقت والأرقام إمكانية التحكّم في كيفية ظهور بياناتك في ورقة بيانات. توفّر "جداول بيانات 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." |
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/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 |