Class TimePicker

בורר זמן

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

התכונה זמינה בתוספים של Google Workspace ובאפליקציות של Google Chat.

const dateTimePicker =
    CardService.newTimePicker()
        .setTitle('Enter the time.')
        .setFieldName('time_field')
        // Set default value as 3:30 AM.
        .setHours(3)
        .setMinutes(30)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

Methods

שיטהסוג הערך המוחזרתיאור קצר
setFieldName(fieldName)TimePickerהגדרת שם השדה שמזהה את הבורר הזה באובייקט האירוע שנוצר כשיש אינטראקציה בממשק המשתמש.
setHours(hours)TimePickerהגדרת ערך שעות מוגדר מראש בשדה הקלט.
setMinutes(minutes)TimePickerהגדרת ערך מוגדר מראש לדקות שיצוין בשדה הקלט.
setOnChangeAction(action)TimePickerהגדרת Action שהסקריפט מבצע בכל פעם שהקלט של הבורר משתנה.
setTitle(title)TimePickerהגדרת הכותרת שמוצגת מעל שדה הקלט.

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

setFieldName(fieldName)

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

פרמטרים

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

חזרה

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


setHours(hours)

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

פרמטרים

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

חזרה

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


setMinutes(minutes)

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

פרמטרים

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

חזרה

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


setOnChangeAction(action)

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

פרמטרים

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

חזרה

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


setTitle(title)

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

פרמטרים

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

חזרה

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