שדה קלט שמאפשר למשתמשים להזין תאריך ושעה.
יש תמיכה באימות של שליחת טפסים. אם Action.setAllWidgetsAreRequired(allWidgetsAreRequired) מוגדר לערך
true או שהווידג'ט הזה מצוין באמצעות Action.addRequiredWidget(requiredWidget), פעולת השליחה נחסמת אלא אם נבחר ערך.
זמין לתוספים ל-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 | בזרימת עבודה ב-Google Workspace, משתני קלט יכולים לקבל פלט של תאריך ושעה משלבים אחרים בזרימת העבודה. |
set | Date | מגדיר Action שהסקריפט מבצע בכל פעם שמשתנה הקלט של הכלי לבחירת תאריך. |
set | Date | מגדיר את מספר הדקות שצריך להוסיף או להחסיר מאזור הזמן ביחס ל-UTC. |
set | Date | הגדרת הכותרת שמוצגת מעל שדה הקלט. |
set | Date | מגדיר את הערך שיוזן מראש בשדה הקלט. |
set | Date | מגדיר את הערך שיוזן מראש בשדה הקלט. |
תיעוד מפורט
set
מגדיר את שם השדה שמזהה את הכלי לבחירת תאריכים באובייקט האירוע שנוצר כשמתבצעת אינטראקציה עם ממשק המשתמש. שם השדה גלוי למשתמש. חובה; שם השדה שצוין חייב להיות ייחודי.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
field | String | השם שיוקצה לקלט הזה. |
חזרה
Date — הכלי הזה לבחירת תאריכים מאפשר לבחור תאריכים רצופים.
set
בזרימת עבודה ב-Google Workspace, משתני קלט יכולים לקבל פלט של תאריך ושעה משלבים אחרים בזרימת העבודה. לדוגמה, לקבל את השעה שבה הודעת Gmail נשלחה או את התאריך שבו אירוע ביומן מתוזמן.
האפשרות הזו זמינה רק דרך תוכנית Gemini אלפא לתוספים של Google Workspace שמרחיבים את האפשרויות של Google Workspace Flows.
const workflowDataSource = CardService.newWorkflowDataSource().setIncludeVariables(true); const hostAppDataSource = CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource); const dateTimePicker = CardService.newDateTimePicker() .setTitle('Enter the date and time.') .setFieldName('date_time_field') .setHostAppDataSource(hostAppDataSource);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
host | Host | מקור הנתונים. |
חזרה
Date — הכלי הזה לבחירת תאריכים מאפשר לבחור תאריכים רצופים.
set
מגדיר Action שהסקריפט מבצע בכל פעם שמשתנה הקלט של הכלי לבחירת תאריך.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
action | Action | הפעולה שצריך לבצע. |
חזרה
Date — הכלי הזה לבחירת תאריכים מאפשר לבחור תאריכים רצופים.
set
מגדיר את מספר הדקות שצריך להוסיף או להחסיר מאזור הזמן ביחס ל-UTC. אם מוגדר, התאריך והשעה מוצגים באזור הזמן שצוין. אם לא מגדירים את אזור הזמן, השעה מוצגת באזור הזמן של המשתמש.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
time | Integer | מספר הדקות שבהן אזור הזמן מוסט משעון UTC. |
חזרה
Date — הכלי הזה לבחירת תאריכים מאפשר לבחור תאריכים רצופים.
set
הגדרת הכותרת שמוצגת מעל שדה הקלט.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
title | String | הכותרת של השדה להזנת הקלט. |
חזרה
Date — הכלי הזה לבחירת תאריכים מאפשר לבחור תאריכים רצופים.
set
מגדיר את הערך שיוזן מראש בשדה הקלט.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
value | Number | ערך ברירת המחדל שמוצב בקלט כמספר, באלפיות השנייה מאז תחילת התקופה של זמן מערכת. הוא תמיד מיוצג כמחרוזת בפרמטרים של הקריאה החוזרת (callback) של הטופס. |
חזרה
Date — הכלי הזה לבחירת תאריכים מאפשר לבחור תאריכים רצופים.
set
מגדיר את הערך שיוזן מראש בשדה הקלט.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
value | String | ערך ברירת המחדל שמוצב בקלט כמחרוזת, באלפיות שנייה מאז תחילת התקופה של זמן מערכת. הוא תמיד מיוצג כמחרוזת בפרמטרים של הקריאה החוזרת (callback) של הטופס. |
חזרה
Date — הכלי הזה לבחירת תאריכים מאפשר לבחור תאריכים רצופים.