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

روش‌ها

روش نوع بازگشتی شرح مختصر
set Field Name(fieldName) Date Time Picker نام فیلدی را تنظیم می‌کند که این انتخابگر را در شیء رویدادی که هنگام تعامل با رابط کاربری ایجاد می‌شود، مشخص می‌کند.
set Host App Data Source(hostAppDataSource) Date Time Picker در یک جریان کاری گوگل ورک‌اسپیس، به متغیرهای ورودی اجازه می‌دهد تا خروجی‌های تاریخ و زمان را از مراحل دیگر جریان بپذیرند.
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 Field Name(fieldName)

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

پارامترها

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

بازگشت

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

set Host App Data Source(hostAppDataSource)

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

فقط از طریق برنامه Gemini Alpha برای افزونه‌های Google Workspace که Google Workspace Flows را گسترش می‌دهند، در دسترس است.

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 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 - این انتخابگر، برای زنجیره‌سازی.