Class DateTimePicker

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

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
setFieldName(fieldName)DateTimePickerयह फ़ील्ड का वह नाम सेट करता है जो यूज़र इंटरफ़ेस (यूआई) से इंटरैक्ट करने पर जनरेट होने वाले इवेंट ऑब्जेक्ट में इस पिकर की पहचान करता है.
setHostAppDataSource(hostAppDataSource)DateTimePickerGoogle Workspace फ़्लो में, इनपुट वैरिएबल, फ़्लो में मौजूद अन्य चरणों से तारीख और समय की जानकारी स्वीकार कर सकते हैं.
setOnChangeAction(action)DateTimePickerयह एक Action सेट करता है. स्क्रिप्ट, पिकर के इनपुट में बदलाव होने पर इसे लागू करती है.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerइस विकल्प का इस्तेमाल करके, यह सेट किया जाता है कि टाइम ज़ोन को यूटीसी से कितने मिनट का ऑफ़सेट देना है.
setTitle(title)DateTimePickerइससे इनपुट फ़ील्ड के ऊपर दिखने वाला टाइटल सेट किया जाता है.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerइनपुट फ़ील्ड में पहले से भरी गई वैल्यू सेट करता है.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerइनपुट फ़ील्ड में पहले से भरी गई वैल्यू सेट करता है.

ज़्यादा जानकारी वाला दस्तावेज़

setFieldName(fieldName)

यह फ़ील्ड का वह नाम सेट करता है जो यूज़र इंटरफ़ेस (यूआई) से इंटरैक्ट करने पर जनरेट होने वाले इवेंट ऑब्जेक्ट में इस पिकर की पहचान करता है. फ़ील्ड का नाम, उपयोगकर्ता को दिखता है. ज़रूरी है; तय किए गए फ़ील्ड का नाम यूनीक होना चाहिए.

पैरामीटर

नामटाइपब्यौरा
fieldNameStringइस इनपुट को असाइन किया जाने वाला नाम.

वापसी का टिकट

DateTimePicker — यह पिकर, चेनिंग के लिए है.

setHostAppDataSource(hostAppDataSource)

Google Workspace फ़्लो में, इनपुट वैरिएबल, फ़्लो में मौजूद अन्य चरणों से तारीख और समय की जानकारी स्वीकार कर सकते हैं. उदाहरण के लिए, Gmail मैसेज भेजे जाने का समय या कैलेंडर इवेंट शेड्यूल किए जाने की तारीख.

यह सुविधा सिर्फ़ 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);

पैरामीटर

नामटाइपब्यौरा
hostAppDataSourceHostAppDataSourceडेटा सोर्स.

वापसी का टिकट

DateTimePicker — यह पिकर, चेनिंग के लिए है.

setOnChangeAction(action)

यह एक Action सेट करता है. स्क्रिप्ट, पिकर के इनपुट में बदलाव होने पर इसे लागू करती है.

पैरामीटर

नामटाइपब्यौरा
actionActionकी जाने वाली कार्रवाई.

वापसी का टिकट

DateTimePicker — यह पिकर, चेनिंग के लिए है.

setTimeZoneOffsetInMins(timeZoneOffsetMins)

इस विकल्प का इस्तेमाल करके, यह सेट किया जाता है कि टाइम ज़ोन को यूटीसी से कितने मिनट का ऑफ़सेट देना है. अगर यह सेट है, तो तारीख और समय, तय किए गए टाइम ज़ोन के हिसाब से दिखता है. इस सेटिंग को सेट न करने पर, समय उपयोगकर्ता के टाइम ज़ोन में दिखता है.

पैरामीटर

नामटाइपब्यौरा
timeZoneOffsetMinsIntegerयह यूटीसी से टाइम ज़ोन के ऑफ़सेट में अंतर दिखाता है.

वापसी का टिकट

DateTimePicker — यह पिकर, चेनिंग के लिए है.

setTitle(title)

इससे इनपुट फ़ील्ड के ऊपर दिखने वाला टाइटल सेट किया जाता है.

पैरामीटर

नामटाइपब्यौरा
titleStringइनपुट फ़ील्ड का टाइटल.

वापसी का टिकट

DateTimePicker — यह पिकर, चेनिंग के लिए है.

setValueInMsSinceEpoch(valueMsEpoch)

इनपुट फ़ील्ड में पहले से भरी गई वैल्यू सेट करता है.

पैरामीटर

नामटाइपब्यौरा
valueMsEpochNumberइनपुट में डिफ़ॉल्ट वैल्यू को संख्या के तौर पर रखा जाता है. यह वैल्यू, epoch के बाद से मिलीसेकंड में होती है. इसे हमेशा फ़ॉर्म कॉलबैक पैरामीटर में स्ट्रिंग के तौर पर दिखाया जाता है.

वापसी का टिकट

DateTimePicker — यह पिकर, चेनिंग के लिए है.

setValueInMsSinceEpoch(valueMsEpoch)

इनपुट फ़ील्ड में पहले से भरी गई वैल्यू सेट करता है.

पैरामीटर

नामटाइपब्यौरा
valueMsEpochStringइनपुट में स्ट्रिंग के तौर पर रखी गई डिफ़ॉल्ट वैल्यू. यह वैल्यू, epoch के बाद से मिलीसेकंड में होती है. इसे हमेशा फ़ॉर्म कॉलबैक पैरामीटर में स्ट्रिंग के तौर पर दिखाया जाता है.

वापसी का टिकट

DateTimePicker — यह पिकर, चेनिंग के लिए है.