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