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

तरीके

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

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

addEventAction(eventAction)

विजेट पर की जा सकने वाली इवेंट कार्रवाई जोड़ता है.

पैरामीटर

नामटाइपब्यौरा
eventActionEventActionजोड़ने के लिए EventAction.

वापसी का टिकट

Widget — यह ऑब्जेक्ट, चेनिंग के लिए होता है.


setFieldName(fieldName)

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

पैरामीटर

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

वापसी का टिकट

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


setHostAppDataSource(hostAppDataSource)

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

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

पैरामीटर

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

वापसी का टिकट

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


setId(id)

यह कुकी, असाइन किया गया यूनीक आईडी सेट करती है. इसका इस्तेमाल, बदले जाने वाले विजेट की पहचान करने के लिए किया जाता है. विजेट में बदलाव करने की सुविधा सिर्फ़ ऐड-ऑन में उपलब्ध है.

पैरामीटर

नामटाइपब्यौरा
idStringयह विजेट का आईडी होता है. इसमें ज़्यादा से ज़्यादा 64 वर्ण हो सकते हैं. इसका फ़ॉर्मैट `[a-zA-Z0-9-]+` होता है.

वापसी का टिकट

Widget — यह ऑब्जेक्ट, चेनिंग के लिए है.


setOnChangeAction(action)

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

पैरामीटर

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

वापसी का टिकट

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


setTimeZoneOffsetInMins(timeZoneOffsetMins)

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

पैरामीटर

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

वापसी का टिकट

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


setTitle(title)

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

पैरामीटर

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

वापसी का टिकट

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


setValueInMsSinceEpoch(valueMsEpoch)

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

पैरामीटर

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

वापसी का टिकट

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


setValueInMsSinceEpoch(valueMsEpoch)

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

पैरामीटर

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

वापसी का टिकट

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


setVisibility(visibility)

इससे विजेट के दिखने की सेटिंग सेट की जाती है. डिफ़ॉल्ट वैल्यू `VISIBLE` होती है.

पैरामीटर

नामटाइपब्यौरा
visibilityVisibilityविजेट का Visibility.

वापसी का टिकट

Widget — यह ऑब्जेक्ट, चेनिंग के लिए होता है.