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