حقل إدخال يسمح للمستخدمين بإدخال تاريخ ووقت
متاحة لإضافات Google Workspace وتطبيقات Google Chat.
var 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 | لضبط اسم الحقل الذي يحدّد أداة الاختيار هذه في كائن الحدث الذي يتم إنشاؤه عند حدوث تفاعل في واجهة المستخدم. |
setOnChangeAction(action) | DateTimePicker | لضبط Action الذي ينفّذه النص البرمجي كلما تغير إدخال أداة الاختيار. |
setTimeZoneOffsetInMins(timeZoneOffsetMins) | DateTimePicker | لضبط عدد الدقائق التي يجب إزاحة المنطقة الزمنية فيها من التوقيت العالمي المنسَّق. |
setTitle(title) | DateTimePicker | لضبط العنوان المعروض أعلى حقل الإدخال. |
setValueInMsSinceEpoch(valueMsEpoch) | DateTimePicker | لضبط القيمة التي تم ملؤها مسبقًا والتي سيتم ضبطها في حقل الإدخال. |
setValueInMsSinceEpoch(valueMsEpoch) | DateTimePicker | لضبط القيمة التي تم ملؤها مسبقًا والتي سيتم ضبطها في حقل الإدخال. |
الوثائق التفصيلية
setFieldName(fieldName)
لضبط اسم الحقل الذي يحدّد أداة الاختيار هذه في كائن الحدث الذي يتم إنشاؤه عند حدوث تفاعل في واجهة المستخدم. يظهر اسم الحقل للمستخدم. مطلوب، ويجب أن يكون اسم الحقل المحدد فريدًا.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
fieldName | String | الاسم الذي سيتم تعيينه لهذا الإدخال. |
استرجاع الكرة
DateTimePicker
: أداة الاختيار هذه للتسلسل.
setOnChangeAction(action)
لضبط Action
الذي ينفّذه النص البرمجي كلما تغير إدخال أداة الاختيار.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
action | Action | الإجراء المطلوب اتخاذه. |
استرجاع الكرة
DateTimePicker
: أداة الاختيار هذه للتسلسل.
setTimeZoneOffsetInMins(timeZoneOffsetMins)
لضبط عدد الدقائق التي يجب إزاحة المنطقة الزمنية فيها من التوقيت العالمي المنسَّق. وإذا تم تعيينها، يتم عرض التاريخ والوقت في المنطقة الزمنية المحددة. وفي حال ترك هذه السياسة بدون ضبط، يتم عرض الوقت وفقًا للمنطقة الزمنية للمستخدم.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
timeZoneOffsetMins | Integer | عدد الدقائق التي يتم إزاحتها عن المنطقة الزمنية من التوقيت العالمي المتفق عليه. |
استرجاع الكرة
DateTimePicker
: أداة الاختيار هذه للتسلسل.
setTitle(title)
لضبط العنوان المعروض أعلى حقل الإدخال.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | عنوان حقل الإدخال |
استرجاع الكرة
DateTimePicker
: أداة الاختيار هذه للتسلسل.
setValueInMsSinceEpoch(valueMsEpoch)
لضبط القيمة التي تم ملؤها مسبقًا والتي سيتم ضبطها في حقل الإدخال.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
valueMsEpoch | Number | القيمة التلقائية التي يتم إدخالها في الإدخال كرقم، بالمللي ثانية منذ الفترة الزمنية. ويتم تمثيلها دائمًا كسلسلة في مَعلمات معاودة الاتصال في النموذج. |
استرجاع الكرة
DateTimePicker
: أداة الاختيار هذه للتسلسل.
setValueInMsSinceEpoch(valueMsEpoch)
لضبط القيمة التي تم ملؤها مسبقًا والتي سيتم ضبطها في حقل الإدخال.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
valueMsEpoch | String | القيمة التلقائية التي يتم إدخالها في الإدخال كسلسلة، بالمللي ثانية منذ الفترة الزمنية. ويتم تمثيلها دائمًا كسلسلة في مَعلمات معاودة الاتصال في النموذج. |
استرجاع الكرة
DateTimePicker
: أداة الاختيار هذه للتسلسل.