Class 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ערך ברירת המחדל שמוצב בקלט כמספר, באלפיות השנייה מאז תחילת התקופה של זמן מערכת. המערכת משתמשת רק בתאריך של זמן העידן, ומתעלמת מהשעה של זמן העידן. הוא תמיד מיוצג כמחרוזת בפרמטרים של הקריאה החוזרת של הטופס.

חזרה

DatePicker — הכלי הזה לבחירת תאריכים מאפשר לבחור תאריכים רצופים.


setValueInMsSinceEpoch(valueMsEpoch)

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

פרמטרים

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

חזרה

DatePicker — הכלי הזה לבחירת תאריכים מאפשר לשרשר תאריכים.


setVisibility(visibility)

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

פרמטרים

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

חזרה

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