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

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

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

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

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

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

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

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

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

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

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

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

אסימון	תיאור
h	השעה ביום. מעבר בין פורמט 12 שעות לפורמט 24 שעות, בהתאם להופעה של אינדיקטור AM או PM במחרוזת.
hh+	כמו בשיטה הקודמת, אבל עם אפס בהתחלה עבור 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."	16: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 באפריל 2016 בשעה 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. החלק של החלק היחסי לא מוצג אם המונה הופך לאפס. המספר 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 ומספר בן שלוש ספרות (עם אפסים בהתחלה) לכל ערך אחר. אפשר להחיל תנאים רק על שני פורמט המשנה הראשונים, ואם מספר תואם ליותר מפורמט אחד, המערכת תשתמש בפורמט הראשון שאליו הוא תואם. אם יש פורמט שלישי, הוא משמש לכל שאר המקרים. אחרת, אם המספר לא תואם לאף אחד מהפורמטים, הוא מוצג כ-'#' עד שהוא ממלא את רוחב התא. אם הוא קיים, תמיד נעשה שימוש בפורמט הרביעי לטקסט.
[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