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