שדה להזנת קלט שמאפשר להזין תאריך.
זמין לתוספים ל-Google Workspace ולאפליקציות ל-Google Chat.
const dateTimePicker = CardService.newDatePicker() .setTitle('Enter the date.') .setFieldName('date_field') // Set default value as Jan 1, 2018 UTC. Either a number or string is // acceptable. .setValueInMsSinceEpoch(1514775600) .setOnChangeAction( CardService.newAction().setFunctionName('handleDateTimeChange'), );
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
add | Widget | מוסיף את פעולת האירוע שאפשר לבצע בווידג'ט. |
set | Date | מגדיר את שם השדה שמזהה את הכלי לבחירת תאריכים באובייקט האירוע שנוצר כשמתבצעת אינטראקציה עם ממשק המשתמש. |
set | Widget | מגדיר את המזהה הייחודי שהוקצה לשימוש בזיהוי הווידג'ט שצריך לשנות. |
set | Date | מגדיר Action שהסקריפט מבצע בכל פעם שמשתנה הקלט של הכלי לבחירת תאריכים. |
set | Date | מגדיר את הכותרת שמוצגת מעל שדה להזנת קלט. |
set | Date | מגדירים את הערך שיוזן מראש בשדה להזנת קלט. |
set | Date | מגדירים את הערך שיוזן מראש בשדה להזנת קלט. |
set | Widget | ההגדרה הזו קובעת את רמת החשיפה של הווידג'ט. |
תיעוד מפורט
addEventAction(eventAction)
מוסיף את פעולת האירוע שאפשר לבצע בווידג'ט.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
event | Event | ה-Event שרוצים להוסיף. |
חזרה
Widget – האובייקט, לשרשור.
setFieldName(fieldName)
מגדיר את שם השדה שמזהה את הכלי לבחירת תאריכים באובייקט האירוע שנוצר כשמתבצעת אינטראקציה עם ממשק המשתמש. שם השדה גלוי למשתמש. חובה; שם השדה שצוין חייב להיות ייחודי.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
field | String | השם שיוקצה לקלט הזה. |
חזרה
DatePicker — הכלי לבחירת תאריכים, לשרשור.
setId(id)
מגדיר את המזהה הייחודי שהוקצה לשימוש בזיהוי הווידג'ט שצריך לשנות. שינוי של ווידג'ט נתמך רק בתוספים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
id | String | המזהה של הווידג'ט, עם מגבלה של 64 תווים ובפורמט [a-zA-Z0-9-]+. |
חזרה
Widget – האובייקט הזה, לשרשור.
setOnChangeAction(action)
מגדיר Action שהסקריפט מבצע בכל פעם שמשתנה הקלט של הכלי לבחירת תאריכים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
action | Action | הפעולה שצריך לבצע. |
חזרה
DatePicker — הכלי לבחירת תאריכים, לשרשור.
setTitle(title)
מגדיר את הכותרת שמוצגת מעל שדה להזנת קלט.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
title | String | הכותרת של השדה להזנת הקלט. |
חזרה
DatePicker — הכלי לבחירת תאריכים, לשרשור.
setValueInMsSinceEpoch(valueMsEpoch)
מגדירים את הערך שיוזן מראש בשדה להזנת קלט.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
value | Number | ערך ברירת המחדל שמוצב בקלט כמספר, באלפיות השנייה מאז תחילת התקופה של זמן מערכת. המערכת משתמשת רק בתאריך של זמן העידן, ומתעלמת מהשעה של זמן העידן. הוא תמיד מיוצג כמחרוזת בפרמטרים של הקריאה החוזרת (callback) של הטופס. |
חזרה
DatePicker — הכלי לבחירת תאריכים, לשרשור.
setValueInMsSinceEpoch(valueMsEpoch)
מגדירים את הערך שיוזן מראש בשדה להזנת קלט.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
value | String | ערך ברירת המחדל שמוצב בקלט כמחרוזת, באלפיות השנייה מאז תחילת התקופה של זמן מערכת. המערכת משתמשת רק בתאריך של זמן העידן, ומתעלמת מהשעה של זמן העידן. הוא תמיד מיוצג כמחרוזת בפרמטרים של הקריאה החוזרת (callback) של הטופס. |
חזרה
DatePicker — הכלי לבחירת תאריכים, לשרשור.
setVisibility(visibility)
ההגדרה הזו קובעת את רמת החשיפה של הווידג'ט. ערך ברירת המחדל הוא `VISIBLE`.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
visibility | Visibility | הVisibility של הווידג'ט. |
חזרה
Widget – האובייקט, לשרשור.