تتيح لك تنسيقات التاريخ والوقت والأرقام إمكانية التحكّم في كيفية ظهور بياناتك في ورقة البيانات. توفر جداول بيانات Google بعض التنسيقات الشائعة للاختيار من بينها، ولكن يمكنك أيضًا تحديد التنسيقات الخاصة بك.
في واجهة مستخدم "جداول بيانات Google"، يمكنك تطبيق تنسيقات الأرقام والتاريخ على الخلايا باستخدام قائمة
التنسيق > رقم. في Sheets API، يمكنك ضبط هذه التنسيقات باستخدام طريقة استدعاء
spreadsheets.batchUpdate
لإرسال
UpdateCellsRequest
أو
RepeatCellRequest.
توضّح هذه الصفحة كيفية تحديد أنماط جديدة لتنسيق التاريخ والوقت، والتي يمكنك تضمينها في طلب البيانات من واجهة برمجة التطبيقات. يعرض النموذج
ضبط تاريخ ووقت مخصّص أو تنسيق عشري لنطاق
كيفية ضبط نمط تنسيق باستخدام واجهة برمجة التطبيقات. يُرجى العِلم أنّ العرض الفعلي للتنسيق
يعتمد على locale في جدول البيانات. ويفترض هذا الدليل أنّ السمة locale هي en_US. يمكنك تحديد locale لجدول بيانات من خلال قراءة
SpreadsheetProperties
باستخدام طلب spreadsheets.get.
لمحة عن قيم التاريخ والوقت
تتعامل جداول البيانات، مثل معظم تطبيقات جداول البيانات الأخرى، مع قيم التاريخ والوقت كقيم عشرية. يتيح لك هذا إجراء العمليات الحسابية عليها في المعادلات، بحيث يمكنك زيادة الأيام أو الأسابيع، وإضافة أو طرح تاريخين وأوقات، وإجراء عمليات أخرى مماثلة.
تستخدم جداول البيانات نموذج تاريخ الحقبة الذي يشيع استخدامه في جداول البيانات. يحسب جزء العدد الصحيح من القيمة
(يسار العلامة العشرية) الأيام منذ 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). وبخلاف ذلك، يمثّل الشهر من السنة كرقم (بدون 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 |
الثلاثاء 5/4/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" مع هذه الأحرف على أنّها قيم حرفية ويعرضها بدون تغيير. |
التعليمات الوصفية
علاوة على ذلك، يمكن أن يتضمن كل قسم من أقسام التنسيق تعليمات وصفية اختيارية، ومحاطة بأحرف []، وتسبق التنسيق وتقدم إرشادات إضافية. هناك نوعان من التعليمات الوصفية ويمكن لقسم معين استخدام كليهما:
| مدرسة تعليم | الوصف |
|---|---|
[condition] |
لاستبدال المقارنة التلقائية الموجبة أو السالبة أو الصفرية للقسم بتعبير شرطي آخر. على سبيل المثال، تعرض [<100]”Low”;[>1000]”High”;000 كلمة "منخفض" للقيم أقل من 100 و"مرتفعة" للقيم التي تزيد عن 1000 ورقم مكوَّن من ثلاثة أرقام (مع 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 | #,### |
12,000 |
| 1230000 | 0.0,,"M" |
1.2 مليون |
| 1234500000 | 0.00e+00 |
1.23e+09 |
| 123114.15115 MyText |
###0.000;"TEXT: "_(@_) |
123114.151 النص: 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 |