שדה קלט שמאפשר למשתמשים להזין תאריך ושעה.
התכונה זמינה בתוספים של Google Workspace ובאפליקציות של Google Chat.
const dateTimePicker = CardService.newDateTimePicker() .setTitle('Enter the date and time.') .setFieldName('date_time_field') // Set default value as Jan 1, 2018, 3:00 AM UTC. Either a number or // string is acceptable. .setValueInMsSinceEpoch(1514775600) // EDT time is 5 hours behind UTC. .setTimeZoneOffsetInMins(-5 * 60) .setOnChangeAction( CardService.newAction().setFunctionName('handleDateTimeChange'), );
Methods
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
set | Date | הגדרת שם השדה שמזהה את הבורר הזה באובייקט האירוע שנוצר כשיש אינטראקציה בממשק המשתמש. |
set | Date | הגדרת Action שהסקריפט מבצע בכל פעם שהקלט של הבורר משתנה. |
set | Date | מגדיר את מספר הדקות שצריך להוסיף או לחסר לאזור הזמן כדי להגיע לשעון UTC. |
set | Date | הגדרת הכותרת שמוצגת מעל שדה הקלט. |
set | Date | מגדיר את הערך שמילא מראש בשדה הקלט. |
set | Date | מגדיר את הערך שמילא מראש בשדה הקלט. |
מסמכים מפורטים
set Field Name(fieldName)
הגדרת שם השדה שמזהה את הבורר הזה באובייקט האירוע שנוצר כשיש אינטראקציה בממשק המשתמש. שם השדה גלוי למשתמש. חובה. שם השדה שצוין חייב להיות ייחודי.
פרמטרים
שם | סוג | תיאור |
---|---|---|
field | String | השם שרוצים להקצות לקלט הזה. |
חזרה
Date
– הבורר הזה, לשרשור.
set On Change Action(action)
הגדרת Action
שהסקריפט מבצע בכל פעם שהקלט של הבורר משתנה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
action | Action | הפעולה שצריך לבצע. |
חזרה
Date
– הבורר הזה, לשרשור.
set Time Zone Offset In Mins(timeZoneOffsetMins)
מגדיר את מספר הדקות שצריך להוסיף או לחסר לאזור הזמן כדי להגיע לשעון UTC. אם מגדירים אותו, התאריך והשעה יוצגו באזור הזמן שצוין. אם לא תגדירו את השעה, היא תוצג באזור הזמן של המשתמש.
פרמטרים
שם | סוג | תיאור |
---|---|---|
time | Integer | מספר הדקות שבהן אזור הזמן שונה משעון UTC. |
חזרה
Date
– הבורר הזה, לשרשור.
set Title(title)
הגדרת הכותרת שמוצגת מעל שדה הקלט.
פרמטרים
שם | סוג | תיאור |
---|---|---|
title | String | כותרת השדה להזנת הקלט. |
חזרה
Date
– הבורר הזה, לשרשור.
set Value In Ms Since Epoch(valueMsEpoch)
מגדיר את הערך שמילא מראש בשדה הקלט.
פרמטרים
שם | סוג | תיאור |
---|---|---|
value | Number | ערך ברירת המחדל שמופיע בקלט כמספר, באלפיות שנייה מאז תחילת התקופה של זמן המערכת. הוא תמיד מיוצג כמחרוזת בפרמטרים של קריאה חוזרת (callback) של הטופס. |
חזרה
Date
– הבורר הזה, לשרשור.
set Value In Ms Since Epoch(valueMsEpoch)
מגדיר את הערך שמילא מראש בשדה הקלט.
פרמטרים
שם | סוג | תיאור |
---|---|---|
value | String | ערך ברירת המחדל שמופיע בקלט כמחרוזת, באלפיות שנייה מאז תחילת התקופה של זמן המערכת. הוא תמיד מיוצג כמחרוזת בפרמטרים של קריאה חוזרת (callback) של הטופס. |
חזרה
Date
– הבורר הזה, לשרשור.