Class DateTimePicker

DateTimePicker

שדה להזנת קלט שמאפשר למשתמשים להזין תאריך ושעה.

יש תמיכה באימות של שליחת טפסים. אם 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

שיטה	סוג הערך שמוחזר	תיאור קצר
addEventAction(eventAction)	Widget	מוסיף את פעולת האירוע שאפשר לבצע בווידג'ט.
setFieldName(fieldName)	DateTimePicker	מגדיר את שם השדה שמזהה את הכלי לבחירת תאריכים באובייקט האירוע שנוצר כשמתבצעת אינטראקציה עם ממשק המשתמש.
setHostAppDataSource(hostAppDataSource)	DateTimePicker	בסוכן של Google Workspace Studio, משתני הקלט מקבלים פלט של תאריך ושעה משלבים אחרים בסוכן.
setId(id)	Widget	מגדיר את המזהה הייחודי שהוקצה לשימוש בזיהוי הווידג'ט שצריך לשנות.
setOnChangeAction(action)	DateTimePicker	מגדיר Action שהסקריפט מבצע בכל פעם שמשתנה הקלט של הכלי לבחירת תאריכים.
setTimeZoneOffsetInMins(timeZoneOffsetMins)	DateTimePicker	מגדיר את מספר הדקות שצריך לקזז מאזור הזמן ביחס ל-UTC.
setTitle(title)	DateTimePicker	מגדיר את הכותרת שמוצגת מעל שדה להזנת קלט.
setValueInMsSinceEpoch(valueMsEpoch)	DateTimePicker	מגדירים את הערך שיוזן מראש בשדה להזנת קלט.
setValueInMsSinceEpoch(valueMsEpoch)	DateTimePicker	מגדירים את הערך שיוזן מראש בשדה להזנת קלט.
setVisibility(visibility)	Widget	ההגדרה הזו קובעת את רמת החשיפה של הווידג'ט.

תיעוד מפורט

addEventAction(eventAction)

מוסיף את פעולת האירוע שאפשר לבצע בווידג'ט.

פרמטרים

שם	סוג	תיאור
eventAction	EventAction	ה-EventAction שרוצים להוסיף.

חזרה

‫Widget – האובייקט, לשרשור.

---

setFieldName(fieldName)

מגדיר את שם השדה שמזהה את הכלי לבחירת תאריכים באובייקט האירוע שנוצר כשמתבצעת אינטראקציה עם ממשק המשתמש. שם השדה גלוי למשתמש. חובה; שם השדה שצוין חייב להיות ייחודי.

פרמטרים

שם	סוג	תיאור
fieldName	String	השם שיוקצה לקלט הזה.

חזרה

‫DateTimePicker — הכלי לבחירת תאריכים, לשרשור.

---

setHostAppDataSource(hostAppDataSource)

בסוכן של 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);

פרמטרים

שם	סוג	תיאור
hostAppDataSource	HostAppDataSource	מקור הנתונים.

חזרה

‫DateTimePicker — הכלי לבחירת תאריכים, לשרשור.

---

setId(id)

מגדיר את המזהה הייחודי שהוקצה לשימוש בזיהוי הווידג'ט שצריך לשנות. שינוי של ווידג'ט נתמך רק בתוספים.

פרמטרים

שם	סוג	תיאור
id	String	המזהה של הווידג'ט, עם מגבלה של 64 תווים ובפורמט [a-zA-Z0-9-]+.

חזרה

‫Widget – האובייקט הזה, לשרשור.

---

setOnChangeAction(action)

מגדיר Action שהסקריפט מבצע בכל פעם שמשתנה הקלט של הכלי לבחירת תאריכים.

פרמטרים

שם	סוג	תיאור
action	Action	הפעולה שצריך לבצע.

חזרה

‫DateTimePicker — הכלי לבחירת תאריכים, לשרשור.

---

setTimeZoneOffsetInMins(timeZoneOffsetMins)

מגדיר את מספר הדקות שצריך לקזז מאזור הזמן ביחס ל-UTC. אם מוגדר, התאריך והשעה מוצגים באזור הזמן שצוין. אם לא מגדירים את אזור הזמן, השעה מוצגת באזור הזמן של המשתמש.

פרמטרים

שם	סוג	תיאור
timeZoneOffsetMins	Integer	מספר הדקות שבהן אזור הזמן מוסט משעון UTC.

חזרה

‫DateTimePicker — הכלי לבחירת תאריכים, לשרשור.

---

setTitle(title)

מגדיר את הכותרת שמוצגת מעל שדה להזנת קלט.

פרמטרים

שם	סוג	תיאור
title	String	הכותרת של השדה להזנת הקלט.

חזרה

‫DateTimePicker — הכלי לבחירת תאריכים, לשרשור.

---

setValueInMsSinceEpoch(valueMsEpoch)

מגדירים את הערך שיוזן מראש בשדה להזנת קלט.

פרמטרים

שם	סוג	תיאור
valueMsEpoch	Number	ערך ברירת המחדל שמוצב בקלט כמספר, באלפיות השנייה מאז תחילת התקופה של זמן מערכת. הוא תמיד מיוצג כמחרוזת בפרמטרים של הקריאה החוזרת (callback) של הטופס.

חזרה

‫DateTimePicker — הכלי לבחירת תאריכים, לשרשור.

---

setValueInMsSinceEpoch(valueMsEpoch)

מגדירים את הערך שיוזן מראש בשדה להזנת קלט.

פרמטרים

שם	סוג	תיאור
valueMsEpoch	String	ערך ברירת המחדל שמוצב בקלט כמחרוזת, באלפיות השנייה מאז תחילת התקופה של זמן מערכת. הוא תמיד מיוצג כמחרוזת בפרמטרים של הקריאה החוזרת (callback) של הטופס.

חזרה

‫DateTimePicker — הכלי לבחירת תאריכים, לשרשור.

---

setVisibility(visibility)

ההגדרה הזו קובעת את רמת החשיפה של הווידג'ט. ערך ברירת המחדל הוא `VISIBLE`.

פרמטרים

שם	סוג	תיאור
visibility	Visibility	הVisibility של הווידג'ט.

חזרה

‫Widget – האובייקט, לשרשור.