Class DateTimePicker

ডেটটাইমপিকার

একটি ইনপুট ফিল্ড যা ব্যবহারকারীদের তারিখ ও সময় ইনপুট করার সুযোগ দেয়।

ফর্ম জমা দেওয়ার বৈধতা যাচাই সমর্থন করে। যখন Action.setAllWidgetsAreRequired(allWidgetsAreRequired) true সেট করা হয় অথবা Action.addRequiredWidget(requiredWidget) এর মাধ্যমে এই উইজেটটি নির্দিষ্ট করা হয়, তখন কোনো মান নির্বাচন না করা পর্যন্ত জমা দেওয়ার প্রক্রিয়াটি অবরুদ্ধ থাকে।

গুগল ওয়ার্কস্পেস অ্যাড-অন এবং গুগল চ্যাট অ্যাপের জন্য উপলব্ধ।

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 UI ইন্টারঅ্যাকশনের ফলে যে ইভেন্ট অবজেক্টটি তৈরি হয়, তাতে এই পিকারটিকে শনাক্তকারী ফিল্ডের নাম সেট করে।
set Host App Data Source(hostAppDataSource) Date Time Picker গুগল ওয়ার্কস্পেস স্টুডিও এজেন্টে, ইনপুট ভেরিয়েবলগুলোকে এজেন্টের অন্যান্য ধাপ থেকে ডেটটাইম আউটপুট গ্রহণ করতে দেওয়া হয়।
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 উইজেটটির দৃশ্যমানতা নির্ধারণ করে।

বিস্তারিত ডকুমেন্টেশন

addEventAction(eventAction)

উইজেটটিতে সম্পাদনযোগ্য ইভেন্ট অ্যাকশনটি যোগ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
event Action Event Action Event Action যোগ করা হবে।

ফেরত

Widget — শৃঙ্খলিত করার জন্য ব্যবহৃত অবজেক্ট।


setFieldName(fieldName)

UI ইন্টারঅ্যাকশনের ফলে তৈরি হওয়া ইভেন্ট অবজেক্টে এই পিকারটিকে শনাক্তকারী ফিল্ডের নাম সেট করে। ফিল্ডের নামটি ব্যবহারকারীর কাছে দৃশ্যমান থাকে। আবশ্যক; নির্দিষ্ট ফিল্ডের নামটি অবশ্যই অনন্য হতে হবে।

প্যারামিটার

নাম প্রকার বর্ণনা
field Name String এই ইনপুটটির জন্য নির্ধারিত নাম।

ফেরত

DateTimePicker — এটি চেইনিংয়ের জন্য ব্যবহৃত পিকার।


setHostAppDataSource(hostAppDataSource)

গুগল ওয়ার্কস্পেস স্টুডিও এজেন্টে, ইনপুট ভেরিয়েবলগুলো এজেন্টের অন্যান্য ধাপ থেকে ডেটটাইম আউটপুট গ্রহণ করতে পারে। উদাহরণস্বরূপ, একটি জিমেইল বার্তা পাঠানোর সময় বা একটি ক্যালেন্ডার ইভেন্ট নির্ধারিত হওয়ার তারিখ গ্রহণ করা যায়।

শুধুমাত্র সেইসব 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 তথ্যের উৎস।

ফেরত

DateTimePicker — এটি চেইনিংয়ের জন্য ব্যবহৃত পিকার।


setId(id)

যে উইজেটটি পরিবর্তন করা হবে, সেটিকে শনাক্ত করার জন্য একটি অনন্য আইডি নির্ধারণ করে। উইজেট পরিবর্তন শুধুমাত্র অ্যাড-অন-এ সমর্থিত।

প্যারামিটার

নাম প্রকার বর্ণনা
id String উইজেটের আইডি, যা সর্বোচ্চ ৬৪ অক্ষরের হতে হবে এবং এর ফরম্যাট হবে `[a-zA-Z0-9-]+`।

ফেরত

Widget — এই অবজেক্টটি, চেইন করার জন্য ব্যবহৃত হয়।


setOnChangeAction(action)

এমন একটি Action নির্ধারণ করে যা পিকার ইনপুট পরিবর্তিত হলেই স্ক্রিপ্টটি সম্পাদন করে।

প্যারামিটার

নাম প্রকার বর্ণনা
action Action করণীয় পদক্ষেপ।

ফেরত

DateTimePicker — এটি চেইনিংয়ের জন্য ব্যবহৃত পিকার।


setTimeZoneOffsetInMins(timeZoneOffsetMins)

UTC থেকে টাইম জোনের মিনিটের ব্যবধান নির্ধারণ করে। সেট করা থাকলে, তারিখ ও সময় নির্দিষ্ট টাইম জোনে প্রদর্শিত হয়। সেট করা না থাকলে, সময় ব্যবহারকারীর টাইম জোনে প্রদর্শিত হয়।

প্যারামিটার

নাম প্রকার বর্ণনা
time Zone Offset Mins Integer UTC থেকে টাইম জোনের মিনিটের ব্যবধান।

ফেরত

DateTimePicker — এটি চেইনিংয়ের জন্য ব্যবহৃত পিকার।


setTitle(title)

ইনপুট ফিল্ডের উপরে প্রদর্শিত শিরোনাম নির্ধারণ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
title String ইনপুট ফিল্ডের শিরোনাম।

ফেরত

DateTimePicker — এটি চেইনিংয়ের জন্য ব্যবহৃত পিকার।


setValueInMsSinceEpoch(valueMsEpoch)

ইনপুট ফিল্ডে সেট করার জন্য আগে থেকে পূরণ করা মান নির্ধারণ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
value Ms Epoch Number ডিফল্ট মানটি ইনপুটে একটি সংখ্যা হিসাবে রাখা হয়, যা ইপক থেকে মিলিসেকেন্ডে পরিমাপ করা থাকে। ফর্ম কলব্যাক প্যারামিটারগুলিতে এটি সর্বদা একটি স্ট্রিং হিসাবে উপস্থাপিত হয়।

ফেরত

DateTimePicker — এটি চেইনিংয়ের জন্য ব্যবহৃত পিকার।


setValueInMsSinceEpoch(valueMsEpoch)

ইনপুট ফিল্ডে সেট করার জন্য আগে থেকে পূরণ করা মান নির্ধারণ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
value Ms Epoch String ডিফল্ট মানটি ইপক থেকে মিলিসেকেন্ডে একটি স্ট্রিং হিসাবে ইনপুটে রাখা হয়। ফর্ম কলব্যাক প্যারামিটারগুলিতে এটি সর্বদা একটি স্ট্রিং হিসাবে উপস্থাপিত হয়।

ফেরত

DateTimePicker — এটি চেইনিংয়ের জন্য ব্যবহৃত পিকার।


setVisibility(visibility)

উইজেটটির দৃশ্যমানতা নির্ধারণ করে। এর ডিফল্ট মান হলো `VISIBLE`।

প্যারামিটার

নাম প্রকার বর্ণনা
visibility Visibility উইজেটটির Visibility

ফেরত

Widget — শৃঙ্খলিত করার জন্য ব্যবহৃত অবজেক্ট।