שדה להזנת קלט שמאפשר למשתמשים להזין תאריך ושעה.
אפשר להשתמש בתוספים ל-Google Workspace ובאפליקציות של Google Chat.
var 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"));
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
setFieldName(fieldName) | DateTimePicker | שם השדה שמזהה את הבורר הזה באובייקט האירוע שנוצר כשיש אינטראקציה בממשק המשתמש. |
setOnChangeAction(action) | DateTimePicker | מגדיר Action שהסקריפט מבצע בכל פעם שהקלט של הבורר משתנה. |
setTimeZoneOffsetInMins(timeZoneOffsetMins) | DateTimePicker | ההגדרה הזו מגדירה את מספר הדקות שיש לקזז את אזור הזמן מ-UTC. |
setTitle(title) | DateTimePicker | מגדיר את הכותרת שמוצגת מעל לשדה הקלט. |
setValueInMsSinceEpoch(valueMsEpoch) | DateTimePicker | מגדיר את הערך שמולא מראש שיוגדר בשדה הקלט. |
setValueInMsSinceEpoch(valueMsEpoch) | DateTimePicker | מגדיר את הערך שמולא מראש שיוגדר בשדה הקלט. |
תיעוד מפורט
setFieldName(fieldName)
שם השדה שמזהה את הבורר הזה באובייקט האירוע שנוצר כשיש אינטראקציה בממשק המשתמש. שם השדה גלוי למשתמש. זהו שדה חובה, השם שלו צריך להיות ייחודי.
פרמטרים
שם | סוג | תיאור |
---|---|---|
fieldName | String | השם שצריך להקצות לקלט הזה. |
החזרות
DateTimePicker
– הבורר הזה, לשרשור.
setOnChangeAction(action)
מגדיר Action
שהסקריפט מבצע בכל פעם שהקלט של הבורר משתנה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
action | Action | הפעולה שצריך לבצע. |
החזרות
DateTimePicker
– הבורר הזה, לשרשור.
setTimeZoneOffsetInMins(timeZoneOffsetMins)
ההגדרה הזו מגדירה את מספר הדקות שיש לקזז את אזור הזמן מ-UTC. אם מגדירים את התאריך, התאריך והשעה מוצגים באזור הזמן שצוין. אם המדיניות לא מוגדרת, השעה מוצגת באזור הזמן של המשתמש.
פרמטרים
שם | סוג | תיאור |
---|---|---|
timeZoneOffsetMins | Integer | מספר הדקות שבהן אזור הזמן מקוזז מ-UTC. |
החזרות
DateTimePicker
– הבורר הזה, לשרשור.
setTitle(title)
מגדיר את הכותרת שמוצגת מעל לשדה הקלט.
פרמטרים
שם | סוג | תיאור |
---|---|---|
title | String | הכותרת של השדה להזנת הקלט. |
החזרות
DateTimePicker
– הבורר הזה, לשרשור.
setValueInMsSinceEpoch(valueMsEpoch)
מגדיר את הערך שמולא מראש שיוגדר בשדה הקלט.
פרמטרים
שם | סוג | תיאור |
---|---|---|
valueMsEpoch | Number | ערך ברירת המחדל שהוגדר בקלט כמספר, באלפיות השנייה מאז תחילת התהליך. הוא תמיד מיוצג כמחרוזת בפרמטרים של קריאה חוזרת בטופס. |
החזרות
DateTimePicker
– הבורר הזה, לשרשור.
setValueInMsSinceEpoch(valueMsEpoch)
מגדיר את הערך שמולא מראש שיוגדר בשדה הקלט.
פרמטרים
שם | סוג | תיאור |
---|---|---|
valueMsEpoch | String | ערך ברירת המחדל שהוצב בקלט כמחרוזת, באלפיות השנייה מאז תחילת התהליך. הוא תמיד מיוצג כמחרוזת בפרמטרים של קריאה חוזרת בטופס. |
החזרות
DateTimePicker
– הבורר הזה, לשרשור.