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

Class DateTimePicker

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

תמיכה באימות שליחת טפסים. כשהאפשרות Action.setAllWidgetsAreRequired(allWidgetsAreRequired) מוגדרת לערך true או שהווידג'ט הזה צוין באמצעות Action.addRequiredWidget(requiredWidget), פעולת השליחה חסומה אלא אם בוחרים ערך.

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

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