Class DateTimePicker

חלונית לבחירתתאריך

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

התכונה זמינה בתוספים של 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

שיטהסוג הערך המוחזרתיאור קצר
setFieldName(fieldName)DateTimePickerהגדרת שם השדה שמזהה את הבורר הזה באובייקט האירוע שנוצר כשיש אינטראקציה בממשק המשתמש.
setOnChangeAction(action)DateTimePickerהגדרת Action שהסקריפט מבצע בכל פעם שהקלט של הבורר משתנה.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerמגדיר את מספר הדקות שצריך להוסיף או לחסר לאזור הזמן כדי להגיע לשעון UTC.
setTitle(title)DateTimePickerהגדרת הכותרת שמוצגת מעל שדה הקלט.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerמגדיר את הערך שמילא מראש בשדה הקלט.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerמגדיר את הערך שמילא מראש בשדה הקלט.

מסמכים מפורטים

setFieldName(fieldName)

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

פרמטרים

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

חזרה

DateTimePicker – הבורר הזה, לשרשור.


setOnChangeAction(action)

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

פרמטרים

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

חזרה

DateTimePicker – הבורר הזה, לשרשור.


setTimeZoneOffsetInMins(timeZoneOffsetMins)

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

פרמטרים

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

חזרה

DateTimePicker – הבורר הזה, לשרשור.


setTitle(title)

הגדרת הכותרת שמוצגת מעל שדה הקלט.

פרמטרים

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

חזרה

DateTimePicker – הבורר הזה, לשרשור.


setValueInMsSinceEpoch(valueMsEpoch)

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

פרמטרים

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

חזרה

DateTimePicker – הבורר הזה, לשרשור.


setValueInMsSinceEpoch(valueMsEpoch)

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

פרמטרים

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

חזרה

DateTimePicker – הבורר הזה, לשרשור.