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'),
        );

روش‌ها

روش نوع بازگشتی شرح مختصر
add Event Action(eventAction) Widget رویدادی را اضافه می‌کند که می‌توان روی ویجت اجرا کرد.
set Field Name(fieldName) Time Picker نام فیلدی را تنظیم می‌کند که این انتخابگر را در شیء رویدادی که هنگام تعامل با رابط کاربری ایجاد می‌شود، مشخص می‌کند.
set Hours(hours) Time Picker مقدار ساعات از پیش پر شده را برای تنظیم در فیلد ورودی تنظیم می‌کند.
set Id(id) Widget شناسه منحصر به فرد اختصاص داده شده برای شناسایی ویجت مورد نظر برای تغییر را تنظیم می‌کند.
set Minutes(minutes) Time Picker مقدار دقیقه از پیش پر شده را برای تنظیم در فیلد ورودی تنظیم می‌کند.
set On Change Action(action) Time Picker Action را تنظیم می‌کند که اسکریپت هر زمان که ورودی انتخابگر تغییر کند، انجام می‌دهد.
set Title(title) Time Picker عنوانی را که در بالای فیلد ورودی نمایش داده می‌شود، تنظیم می‌کند.
set Visibility(visibility) Widget میزان نمایش ویجت را تنظیم می‌کند.

مستندات دقیق

addEventAction(eventAction)

رویدادی را اضافه می‌کند که می‌توان روی ویجت اجرا کرد.

پارامترها

نام نوع توضیحات
event Action Event Action Event Action که قرار است اضافه شود.

بازگشت

Widget — شیء، برای زنجیره‌سازی.

setFieldName(fieldName)

نام فیلدی را که این انتخابگر را در شیء رویدادی که هنگام تعامل با رابط کاربری ایجاد می‌شود، مشخص می‌کند، تنظیم می‌کند. نام فیلد برای کاربر قابل مشاهده است. الزامی؛ نام فیلد مشخص شده باید منحصر به فرد باشد.

پارامترها

نام نوع توضیحات
field Name String نامی که قرار است به این ورودی اختصاص داده شود.

بازگشت

TimePicker — این انتخابگر، برای زنجیره‌سازی.

setHours(hours)

مقدار ساعات از پیش پر شده را برای تنظیم در فیلد ورودی تنظیم می‌کند.

پارامترها

نام نوع توضیحات
hours Integer مقدار پیش‌فرض ساعت که در ورودی قرار می‌گیرد، از ۰ تا ۲۳ متغیر است. این مقدار همیشه به صورت یک رشته در پارامترهای فراخوانی فرم نمایش داده می‌شود.

بازگشت

TimePicker — این انتخابگر، برای زنجیره‌سازی.

setId(id)

شناسه منحصر به فردی که برای شناسایی ویجت مورد نظر برای تغییر استفاده می‌شود را تنظیم می‌کند. تغییر ویجت فقط در افزونه‌ها پشتیبانی می‌شود.

پارامترها

نام نوع توضیحات
id String شناسه‌ی ویجت، با محدودیت ۶۴ کاراکتر و با فرمت `[a-zA-Z0-9-]+`.

بازگشت

Widget - این شیء، برای زنجیره‌سازی.

setMinutes(minutes)

مقدار دقیقه از پیش پر شده را برای تنظیم در فیلد ورودی تنظیم می‌کند.

پارامترها

نام نوع توضیحات
minutes Integer مقدار پیش‌فرض دقیقه که در ورودی قرار می‌گیرد، از ۰ تا ۵۹ متغیر است. این مقدار همیشه به صورت یک رشته در پارامترهای فراخوانی فرم نمایش داده می‌شود.

بازگشت

TimePicker — این انتخابگر، برای زنجیره‌سازی.

setOnChangeAction(action)

Action را تنظیم می‌کند که اسکریپت هر زمان که ورودی انتخابگر تغییر کند، انجام می‌دهد.

پارامترها

نام نوع توضیحات
action Action اقدامی که باید انجام شود.

بازگشت

TimePicker — این انتخابگر، برای زنجیره‌سازی.

setTitle(title)

عنوانی را که در بالای فیلد ورودی نمایش داده می‌شود، تنظیم می‌کند.

پارامترها

نام نوع توضیحات
title String عنوان فیلد ورودی.

بازگشت

TimePicker — این انتخابگر، برای زنجیره‌سازی.

setVisibility(visibility)

میزان نمایش ویجت را تنظیم می‌کند. مقدار پیش‌فرض آن `VISIBLE` است.

پارامترها

نام نوع توضیحات
visibility Visibility Visibility ویجت.

بازگشت

Widget — شیء، برای زنجیره‌سازی.