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)
نام فیلدی را تنظیم می کند که این انتخابگر را در شی رویدادی که در هنگام وجود تعامل رابط کاربری ایجاد می شود، مشخص می کند. نام فیلد برای کاربر قابل مشاهده است. مورد نیاز؛ نام فیلد مشخص شده باید منحصر به فرد باشد.
پارامترها
| نام | تایپ کنید | توضیحات |
|---|
field Name | String | نامی که باید به این ورودی اختصاص داده شود. |
بازگشت
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 - این انتخاب کننده، برای زنجیر زدن.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eDateTimePicker is an input field that allows users to input both a date and a time within Google Workspace Add-ons and Google Chat apps.\u003c/p\u003e\n"],["\u003cp\u003eIt provides functionalities to set a title, a default value, and a specific time zone for the date and time selection.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can set a field name for identifying the picker in events, and trigger custom actions when the input changes using \u003ccode\u003esetOnChangeAction()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe prefilled value can be set using milliseconds since the epoch, represented as either a number or a string.\u003c/p\u003e\n"]]],[],null,["# Class DateTimePicker\n\nDateTimePicker\n\nAn input field that allows users to input a date and time.\n\nSupports form submission validation. When [Action.setAllWidgetsAreRequired(allWidgetsAreRequired)](/apps-script/reference/card-service/action#setAllWidgetsAreRequired(Boolean)) is set to\n`true` or this widget is specified through [Action.addRequiredWidget(requiredWidget)](/apps-script/reference/card-service/action#addRequiredWidget(String)), the submission\naction is blocked unless a value is selected.\n\nAvailable for Google Workspace add-ons and Google Chat apps.\n\n```javascript\nconst dateTimePicker =\n CardService.newDateTimePicker()\n .setTitle('Enter the date and time.')\n .setFieldName('date_time_field')\n // Set default value as Jan 1, 2018, 3:00 AM UTC. Either a number or\n // string is acceptable.\n .setValueInMsSinceEpoch(1514775600)\n // EDT time is 5 hours behind UTC.\n .setTimeZoneOffsetInMins(-5 * 60)\n .setOnChangeAction(\n CardService.newAction().setFunctionName('handleDateTimeChange'),\n );\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|----------------------------------------------------------------------------------|---------------------|--------------------------------------------------------------------------------------------------------------------------|\n| [setFieldName(fieldName)](#setFieldName(String)) | [DateTimePicker](#) | Sets the field name that identifies this picker in the event object that is generated when there is a UI interaction. |\n| [setOnChangeAction(action)](#setOnChangeAction(Action)) | [DateTimePicker](#) | Sets an [Action](/apps-script/reference/card-service/action) that the script performs whenever the picker input changes. |\n| [setTimeZoneOffsetInMins(timeZoneOffsetMins)](#setTimeZoneOffsetInMins(Integer)) | [DateTimePicker](#) | Sets the number of minutes that the time zone should be offset from UTC. |\n| [setTitle(title)](#setTitle(String)) | [DateTimePicker](#) | Sets the title displayed above the input field. |\n| [setValueInMsSinceEpoch(valueMsEpoch)](#setValueInMsSinceEpoch(Number)) | [DateTimePicker](#) | Sets the prefilled value to be set in the input field. |\n| [setValueInMsSinceEpoch(valueMsEpoch)](#setValueInMsSinceEpoch(String)) | [DateTimePicker](#) | Sets the prefilled value to be set in the input field. |\n\nDetailed documentation\n----------------------\n\n### `set``Field``Name(fieldName)`\n\nSets the field name that identifies this picker in the event object that is generated when\nthere is a UI interaction. The field name is visible to the user. Required; the specified field\nname must be unique.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------------|----------|-----------------------------------|\n| `field``Name` | `String` | The name to assign to this input. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining.\n\n*** ** * ** ***\n\n### `set``On``Change``Action(action)`\n\nSets an [Action](/apps-script/reference/card-service/action) that the script performs whenever the picker input changes.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|------------------------------------------------------|---------------------|\n| `action` | [Action](/apps-script/reference/card-service/action) | The action to take. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining.\n\n*** ** * ** ***\n\n### `set``Time``Zone``Offset``In``Mins(timeZoneOffsetMins)`\n\nSets the number of minutes that the time zone should be offset from UTC. If set, the date and\ntime is displayed in the specified time zone. If not set, the time is displayed in the user's\ntime zone.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------------------------|-----------|--------------------------------------------------------------|\n| `time``Zone``Offset``Mins` | `Integer` | The number of minutes that the time zone is offset from UTC. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining.\n\n*** ** * ** ***\n\n### `set``Title(title)`\n\nSets the title displayed above the input field.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|----------|------------------------|\n| `title` | `String` | The input field title. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining.\n\n*** ** * ** ***\n\n### `set``Value``In``Ms``Since``Epoch(valueMsEpoch)`\n\nSets the prefilled value to be set in the input field.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `value``Ms``Epoch` | `Number` | The default value placed in the input as a number, in milliseconds since the epoch. It is always represented as a string in the form callback parameters. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining.\n\n*** ** * ** ***\n\n### `set``Value``In``Ms``Since``Epoch(valueMsEpoch)`\n\nSets the prefilled value to be set in the input field.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `value``Ms``Epoch` | `String` | The default value placed in the input as a string, in milliseconds since the epoch. It is always represented as a string in the form callback parameters. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining."]]
