حقل إدخال يسمح بإدخال تاريخ.
يتوفّر هذا الخيار لإضافات Google Workspace وتطبيقات Google Chat.
var dateTimePicker = CardService.newDatePicker() .setTitle("Enter the date.") .setFieldName("date_field") // Set default value as Jan 1, 2018 UTC. Either a number or string is acceptable. .setValueInMsSinceEpoch(1514775600) .setOnChangeAction(CardService.newAction() .setFunctionName("handleDateTimeChange"));
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
setFieldName(fieldName) | DatePicker | لضبط اسم الحقل الذي يعرّف عن أداة الاختيار هذه في كائن الحدث الذي يتم إنشاؤه عندما هناك تفاعل مع واجهة المستخدم. |
setOnChangeAction(action) | DatePicker | تضبط هذه السياسة Action التي ينفّذها النص البرمجي كلما تغيّر إدخال أداة الاختيار. |
setTitle(title) | DatePicker | لضبط العنوان المعروض أعلى حقل الإدخال. |
setValueInMsSinceEpoch(valueMsEpoch) | DatePicker | تحدِّد هذه السياسة القيمة التي تم ملؤها مسبقًا والتي سيتم ضبطها في حقل الإدخال. |
setValueInMsSinceEpoch(valueMsEpoch) | DatePicker | تحدِّد هذه السياسة القيمة التي تم ملؤها مسبقًا والتي سيتم ضبطها في حقل الإدخال. |
الوثائق التفصيلية
setFieldName(fieldName)
لضبط اسم الحقل الذي يعرّف عن أداة الاختيار هذه في كائن الحدث الذي يتم إنشاؤه عندما هناك تفاعل مع واجهة المستخدم. يظهر اسم الحقل للمستخدم. مطلوب أو اختياري الحقل المحدد أن يكون فريدًا.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
fieldName | String | الاسم المراد تعيينه لمدخل الإدخال هذا. |
الإرجاع
DatePicker
— أداة الاختيار هذه، للسلسلة.
setOnChangeAction(action)
تضبط هذه السياسة Action
التي ينفّذها النص البرمجي كلما تغيّر إدخال أداة الاختيار.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
action | Action | الإجراء المطلوب اتخاذه. |
الإرجاع
DatePicker
— أداة الاختيار هذه، للسلسلة.
setTitle(title)
لضبط العنوان المعروض أعلى حقل الإدخال.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | عنوان حقل الإدخال. |
الإرجاع
DatePicker
— أداة الاختيار هذه، للسلسلة.
setValueInMsSinceEpoch(valueMsEpoch)
تحدِّد هذه السياسة القيمة التي تم ملؤها مسبقًا والتي سيتم ضبطها في حقل الإدخال.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
valueMsEpoch | Number | القيمة التلقائية الموضوعة في الإدخال كرقم، بالمللي ثانية منذ الحقبة. يُستخدم فقط تاريخ وقت الحقبة، ووقت هذه الحقبة هو تم تجاهله. ويتم تمثيله دائمًا كسلسلة في معلمات رد الاتصال في النموذج. |
الإرجاع
DatePicker
— أداة الاختيار هذه، للسلسلة.
setValueInMsSinceEpoch(valueMsEpoch)
تحدِّد هذه السياسة القيمة التي تم ملؤها مسبقًا والتي سيتم ضبطها في حقل الإدخال.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
valueMsEpoch | String | القيمة التلقائية الموضوعة في المُدخل كسلسلة بالمللي ثانية منذ الحقبة. يُستخدم فقط تاريخ وقت الحقبة، ووقت هذه الحقبة هو تم تجاهله. ويتم تمثيله دائمًا كسلسلة في معلمات رد الاتصال في النموذج. |
الإرجاع
DatePicker
— أداة الاختيار هذه، للسلسلة.