פורמטים של תאריכים ומספרים

הפורמטים 'תאריך ושעה' ו'מספר' מאפשרים לכם לקבוע איך הנתונים יופיעו בגיליון. ב-Google Sheets יש כמה פורמטים נפוצים שאפשר לבחור, אבל אתם יכולים גם להגדיר פורמטים משלכם.

בממשק המשתמש של Sheets, מחילים פורמטים של מספר ותאריך על תאים באמצעות התפריט עיצוב > מספר. ב-Sheets API, מגדירים את הפורמטים האלה באמצעות הפעלת method spreadsheets.batchUpdate כדי לשלוח UpdateCellsRequest או RepeatCellRequest.

בדף הזה נסביר איך מגדירים תבניות חדשות של תאריכים ומספרים, שאפשר לכלול בבקשת ה-API. הדוגמה לדוגמה הגדרת תאריך מותאם אישית של תאריך ושעה או פורמט עשרוני לטווח ממחישה איך להגדיר תבנית עיצוב באמצעות ה-API. שימו לב שהרינדור של הפורמט בפועל תלוי ב-locale של הגיליון האלקטרוני. במדריך הזה יוצאים מנקודת הנחה שהשדה locale הוא en_US. אפשר לקבוע את הערך locale של הגיליון האלקטרוני על ידי עיון בבקשה ב-SpreadsheetProperties באמצעות בקשת spreadsheets.get.

מידע על ערכי תאריכים ושעות

ב-Sheets, כמו ברוב האפליקציות האחרות של גיליונות אלקטרוניים, המערכת מתייחסת לערכים של תאריך ושעה כערכים עשרוניים. כך אפשר לבצע עליהם פעולות אריתמטיות בנוסחאות, כדי להגדיל ימים או שבועות, לחבר או לחסר שני תאריכים ושעות ולבצע פעולות דומות אחרות.

ב-Sheets נעשה שימוש בתאריך תקופה (epoch date) שבדרך כלל משתמשים בו בגיליונות אלקטרוניים. החלק השלם של הערך (בצד שמאל של המספר העשרוני) סופר את הימים מאז 30 בדצמבר 1899. החלק השבר (ימין למספר העשרוני) סופר את הזמן כשבר של יום אחד. לדוגמה, 1 בינואר 1900 בצהריים הוא 2.5, 2 כי התאריך הוא יומיים אחרי 30 בדצמבר 1899, ו-0.5 כי השעה היא חצי יום. 1 בפברואר 1900 בשעה 15:00 הוא 33.625.

Google Sheets מתייחס כראוי לשנת 1900 כשנה נפוצה, ולא כשנה מעוברת.

תבניות עיצוב של תאריך ושעה

דפוס של פורמט תאריך-שעה הוא מחרוזת של מחרוזות משנה של אסימונים, שכשמנתחים אותן מוחלפות ברכיבים התואמים של התאריך והשעה (כמו חודש או שעה).

אסימוני פורמט של תאריך ושעה

הטבלה הבאה מגדירה את מחרוזות המשנה של האסימון שבהן אפשר להשתמש בתבנית פורמט של תאריך ושעה. תו + מציין שהתו הקודם יכול להופיע פעם אחת או יותר ועדיין להתאים לדפוס. התווים שלא מופיעים בטבלה הבאה נחשבים מילוליים, והם מקבלים את הפלט ללא שינוי.

אסימון תיאור
h שעה ביום. מעבר בין הפורמט של 12 לפורמט של 24 שעות, בהתאם להצגת אינדיקטור של AM או PM
hh+ זהה לקוד הקודם, אבל עם 0 בהתחלה ל-1-9.
m אם האסימון הלא-ליטרל הקודם היה שעות או האסימון שאחריו הוא שניות, הוא מייצג את הדקות בשעה (בלי 0 בהתחלה). אחרת, הוא מייצג את החודש בשנה כמספר (ללא 0 בהתחלה).
M החודש בשנה בלי 0 בהתחלה. באסימון הזה אפשר לציין במפורש חודש במקום דקה.
mm זהה ל-m, אבל עם 0 בהתחלה בשני המקרים.
MM החודש בשנה עם 0 בהתחלה. באסימון הזה אפשר לציין במפורש חודש במקום דקה.
mmm קיצור של חודש בן שלוש אותיות (לדוגמה, "Feb").
mmmm השם המלא של החודש. גם mmmmmm+ תואם לערך הזה.
mmmmm האות הראשונה של החודש (לדוגמה, 'J' לחודש יוני).
s שניות בדקה בלי 0 בהתחלה.
ss שניות בדקה עם 0 בהתחלה.
[h+] מספר השעות שעברו במהלך פרק זמן מסוים. מספר האותיות מציין מספר ספרות מינימלי (מוסיף 0 בהתחלה).
[m+] מספר הדקות שחלפו בפרק זמן מסוים. מספר האותיות מציין מספר ספרות מינימלי (מוסיף 0 בהתחלה).
[s+] מספר השניות שחלפו בפרק זמן מסוים. מספר האותיות מציין מספר ספרות מינימלי (מוסיף 0 בהתחלה).
d היום בחודש, בלי 0 בהתחלה למספרים שנמוכים מ-10.
dd היום בחודש, עם 0 בהתחלה למספרים שנמוכים מ-10.
ddd יום בשבוע, קיצור בן שלוש אותיות (לדוגמה, "שני").
dddd+ היום בשבוע, שם מלא.
y שנה ב-2 ספרות.
yy
yyy שנה ב-4 ספרות.
yyyy+
a/p מציגה 'a' ל-AM ו-'p' ל-PM. שינוי גם של השעות לפורמט של 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 16:00, יום שלישי 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 ב-Sheets, התווים האלה מתייחסים לייצוגים מילוליים והם מוצגים ללא שינוי.

הוראות למטא-נתונים

בנוסף, לכל אחד מקטעי הפורמט יכולות להיות הוראות מטא אופציונליות, מוקפות בתווי [], שמקדמות את הפורמט ומספקות הוראות נוספות. יש שני סוגים של מטא-הוראה, ובמקטע נתון אפשר להשתמש בשניהם:

הוראות תיאור
[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 # ???/??? 1/8 5
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
נמוך
גבוהה