דף זה תורגם על ידי Cloud Translation API.

Class DateTimePicker

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

אפשר להשתמש בתוספים ל-Google Workspace ובאפליקציות של Google Chat.

var 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"));

שיטות

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

תיעוד מפורט

`setFieldName(fieldName)`

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