Class DatePicker

DatePicker

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

זמין לתוספים ל-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

שיטהסוג הערך שמוחזרתיאור קצר
addEventAction(eventAction)Widgetמוסיף את פעולת האירוע שאפשר לבצע בווידג'ט.
setFieldName(fieldName)DatePickerמגדיר את שם השדה שמזהה את הכלי לבחירת תאריכים באובייקט האירוע שנוצר כשמתבצעת אינטראקציה עם ממשק המשתמש.
setId(id)Widgetמגדיר את המזהה הייחודי שהוקצה לשימוש בזיהוי הווידג'ט שצריך לשנות.
setOnChangeAction(action)DatePickerמגדיר Action שהסקריפט מבצע בכל פעם שמשתנה הקלט של הכלי לבחירת תאריכים.
setTitle(title)DatePickerמגדיר את הכותרת שמוצגת מעל שדה להזנת קלט.
setValueInMsSinceEpoch(valueMsEpoch)DatePickerמגדירים את הערך שיוזן מראש בשדה להזנת קלט.
setValueInMsSinceEpoch(valueMsEpoch)DatePickerמגדירים את הערך שיוזן מראש בשדה להזנת קלט.
setVisibility(visibility)Widgetההגדרה הזו קובעת את רמת החשיפה של הווידג'ט.

תיעוד מפורט

addEventAction(eventAction)

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

פרמטרים

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

חזרה

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


setFieldName(fieldName)

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

פרמטרים

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

חזרה

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


setId(id)

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

פרמטרים

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

חזרה

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


setOnChangeAction(action)

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

פרמטרים

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

חזרה

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


setTitle(title)

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

פרמטרים

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

חזרה

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


setValueInMsSinceEpoch(valueMsEpoch)

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

פרמטרים

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

חזרה

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


setValueInMsSinceEpoch(valueMsEpoch)

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

פרמטרים

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

חזרה

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


setVisibility(visibility)

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

פרמטרים

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

חזרה

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