שדה קלט שמאפשר למשתמשים להזין תאריך ושעה.
יש תמיכה באימות של שליחת טפסים. אם הערך של 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
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
add | Widget | הוספה של פעולת האירוע שאפשר לבצע בווידג'ט. |
set | Date | מגדיר את שם השדה שמזהה את הכלי לבחירת תאריכים באובייקט האירוע שנוצר כשמתבצעת אינטראקציה עם ממשק המשתמש. |
set | Date | בסוכן Google Workspace Studio, אפשר להגדיר משתני קלט לקבלת פלט של תאריך ושעה משלבים אחרים בסוכן. |
set | Widget | מגדיר את המזהה הייחודי שהוקצה ומשמש לזיהוי הווידג'ט שצריך לשנות. |
set | Date | מגדיר Action שהסקריפט מבצע בכל פעם שמשתנה הקלט של הכלי לבחירת תאריכים. |
set | Date | מגדיר את מספר הדקות שצריך להוסיף או להחסיר מאזור הזמן ביחס ל-UTC. |
set | Date | הגדרת הכותרת שמוצגת מעל שדה הקלט. |
set | Date | מגדירים את הערך שיוזן מראש בשדה הקלט. |
set | Date | מגדירים את הערך שיוזן מראש בשדה הקלט. |
set | Widget | הגדרה של רמת החשיפה של הווידג'ט. |
תיעוד מפורט
add
הוספה של פעולת האירוע שאפשר לבצע בווידג'ט.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
event | Event | ה-Event שרוצים להוסיף. |
חזרה
Widget – האובייקט, לשרשור.
set
מגדיר את שם השדה שמזהה את הכלי לבחירת תאריכים באובייקט האירוע שנוצר כשמתבצעת אינטראקציה עם ממשק המשתמש. שם השדה גלוי למשתמש. חובה; שם השדה שצוין חייב להיות ייחודי.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
field | String | השם שיוקצה לקלט הזה. |
חזרה
Date — הכלי הזה לבחירת תאריכים מאפשר לבחור תאריכים רצופים.
set
בסוכן Google Workspace Studio, אפשר להגדיר משתני קלט לקבלת פלט של תאריך ושעה משלבים אחרים בסוכן. לדוגמה, לקבל את השעה שבה הודעת Gmail נשלחה או את התאריך שבו אירוע ביומן מתוזמן.
האפשרות הזו זמינה רק לתוספים ל-Google Workspace שמרחיבים את Google Workspace Studio.
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
מגדיר את המזהה הייחודי שהוקצה ומשמש לזיהוי הווידג'ט שצריך לשנות. שינוי של ווידג'ט נתמך רק בתוספים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
id | String | המזהה של הווידג'ט, עם מגבלה של 64 תווים ובפורמט `[a-zA-Z0-9-]+`. |
חזרה
Widget – האובייקט הזה, לשרשור.
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 — הכלי הזה לבחירת תאריכים מאפשר לבחור תאריכים רצופים.
set
הגדרה של רמת החשיפה של הווידג'ט. ערך ברירת המחדל הוא `VISIBLE`.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
visibility | Visibility | הVisibility של הווידג'ט. |
חזרה
Widget – האובייקט, לשרשור.