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

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

בממשק המשתמש של Sheets, מחילים פורמטים של מספרים ותאריך על תאים באמצעות פורמט > התפריט מספר. ב-Sheets API, אפשר להגדיר את הפורמטים האלה באמצעות 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 נמוך גבוהה