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

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

תיעוד מפורט

addEventAction(eventAction)

הוספה של פעולת האירוע שאפשר לבצע בווידג'ט.

פרמטרים

שםסוגתיאור
eventActionEventActionה-EventAction שרוצים להוסיף.

חזרה

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


setFieldName(fieldName)

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

פרמטרים

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

חזרה

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


setHours(hours)

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

פרמטרים

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

חזרה

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


setId(id)

מגדיר את המזהה הייחודי שהוקצה ומשמש לזיהוי הווידג'ט שצריך לשנות. שינוי של ווידג'ט נתמך רק בתוספים.

פרמטרים

שםסוגתיאור
idStringהמזהה של הווידג'ט, עם מגבלה של 64 תווים ובפורמט ‎ `[a-zA-Z0-9-]+`‎.

חזרה

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


setMinutes(minutes)

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

פרמטרים

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

חזרה

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


setOnChangeAction(action)

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

פרמטרים

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

חזרה

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


setTitle(title)

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

פרמטרים

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

חזרה

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


setVisibility(visibility)

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

פרמטרים

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

חזרה

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