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

روش‌ها

روش نوع بازگشتی شرح مختصر
add Event Action(eventAction) Widget رویدادی را اضافه می‌کند که می‌توان روی ویجت اجرا کرد.
set Field Name(fieldName) Date Time Picker نام فیلدی را تنظیم می‌کند که این انتخابگر را در شیء رویدادی که هنگام تعامل با رابط کاربری ایجاد می‌شود، مشخص می‌کند.
set Host App Data Source(hostAppDataSource) Date Time Picker در یک عامل Google Workspace Studio، متغیرهای ورودی می‌توانند خروجی‌های تاریخ و زمان را از مراحل دیگر عامل بپذیرند.
set Id(id) Widget شناسه منحصر به فرد اختصاص داده شده برای شناسایی ویجت مورد نظر برای تغییر را تنظیم می‌کند.
set On Change Action(action) Date Time Picker Action را تنظیم می‌کند که اسکریپت هر زمان که ورودی انتخابگر تغییر کند، انجام می‌دهد.
set Time Zone Offset In Mins(timeZoneOffsetMins) Date Time Picker تعداد دقایقی را که منطقه زمانی باید از UTC فاصله داشته باشد، تنظیم می‌کند.
set Title(title) Date Time Picker عنوانی را که در بالای فیلد ورودی نمایش داده می‌شود، تنظیم می‌کند.
set Value In Ms Since Epoch(valueMsEpoch) Date Time Picker مقدار از پیش پر شده‌ای را که باید در فیلد ورودی تنظیم شود، تنظیم می‌کند.
set Value In Ms Since Epoch(valueMsEpoch) Date Time Picker مقدار از پیش پر شده‌ای را که باید در فیلد ورودی تنظیم شود، تنظیم می‌کند.
set Visibility(visibility) Widget میزان نمایش ویجت را تنظیم می‌کند.

مستندات دقیق

add Event Action(eventAction)

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

پارامترها

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

بازگشت

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

set Field Name(fieldName)

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

پارامترها

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

بازگشت

Date Time Picker - این انتخابگر، برای زنجیره‌سازی.

set Host App Data Source(hostAppDataSource)

در یک عامل Google Workspace Studio، متغیرهای ورودی می‌توانند خروجی‌های تاریخ و زمان را از مراحل دیگر عامل بپذیرند. برای مثال، زمان ارسال یک پیام جیمیل یا تاریخی که یک رویداد تقویم برنامه‌ریزی شده است را دریافت کنید.

فقط برای افزونه‌های Google Workspace که Google Workspace Studio را توسعه می‌دهند، در دسترس است.

const workflowDataSource =
    CardService.newWorkflowDataSource().setIncludeVariables(true);

const hostAppDataSource =
    CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource);

const dateTimePicker = CardService.newDateTimePicker()
                          .setTitle('Enter the date and time.')
                          .setFieldName('date_time_field')
                          .setHostAppDataSource(hostAppDataSource);

پارامترها

نام نوع توضیحات
host App Data Source Host App Data Source منبع داده‌ها.

بازگشت

Date Time Picker - این انتخابگر، برای زنجیره‌سازی.

set Id(id)

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

پارامترها

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

بازگشت

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

set On Change Action(action)

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

پارامترها

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

بازگشت

Date Time Picker - این انتخابگر، برای زنجیره‌سازی.

set Time Zone Offset In Mins(timeZoneOffsetMins)

تعداد دقایقی را که منطقه زمانی باید از UTC فاصله داشته باشد، تنظیم می‌کند. در صورت تنظیم، تاریخ و زمان در منطقه زمانی مشخص شده نمایش داده می‌شود. در صورت تنظیم نکردن، زمان در منطقه زمانی کاربر نمایش داده می‌شود.

پارامترها

نام نوع توضیحات
time Zone Offset Mins Integer تعداد دقایقی که منطقه زمانی از UTC انحراف دارد.

بازگشت

Date Time Picker - این انتخابگر، برای زنجیره‌سازی.

set Title(title)

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

پارامترها

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

بازگشت

Date Time Picker - این انتخابگر، برای زنجیره‌سازی.

set Value In Ms Since Epoch(valueMsEpoch)

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

پارامترها

نام نوع توضیحات
value Ms Epoch Number مقدار پیش‌فرضی که به صورت یک عدد، بر حسب میلی‌ثانیه از زمان شروع، در ورودی قرار می‌گیرد. این مقدار همیشه به صورت یک رشته در پارامترهای فراخوانی نمایش داده می‌شود.

بازگشت

Date Time Picker - این انتخابگر، برای زنجیره‌سازی.

set Value In Ms Since Epoch(valueMsEpoch)

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

پارامترها

نام نوع توضیحات
value Ms Epoch String مقدار پیش‌فرضی که به صورت رشته، بر حسب میلی‌ثانیه از زمان شروع، در ورودی قرار می‌گیرد. این مقدار همیشه به صورت رشته در پارامترهای فراخوانی فرم نمایش داده می‌شود.

بازگشت

Date Time Picker - این انتخابگر، برای زنجیره‌سازی.

set Visibility(visibility)

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

پارامترها

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

بازگشت

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