Class DateTimePicker

DateTimePicker

حقل إدخال يسمح للمستخدمين بإدخال التاريخ والوقت.

يتوفّر هذا الخيار لإضافات 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لضبط عدد الدقائق التي يجب إزاحة المنطقة الزمنية عن التوقيت العالمي المتفق عليه (UTC).
setTitle(title)DateTimePickerلضبط العنوان المعروض أعلى حقل الإدخال.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerتحدِّد هذه السياسة القيمة التي تم ملؤها مسبقًا والتي سيتم ضبطها في حقل الإدخال.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerتحدِّد هذه السياسة القيمة التي تم ملؤها مسبقًا والتي سيتم ضبطها في حقل الإدخال.

الوثائق التفصيلية

setFieldName(fieldName)

لضبط اسم الحقل الذي يعرّف عن أداة الاختيار هذه في كائن الحدث الذي يتم إنشاؤه عندما هناك تفاعل مع واجهة المستخدم. يظهر اسم الحقل للمستخدم. مطلوب أو اختياري الحقل المحدد أن يكون فريدًا.

المعلمات

الاسمالنوعالوصف
fieldNameStringالاسم المراد تعيينه لمدخل الإدخال هذا.

الإرجاع

DateTimePicker — أداة الاختيار هذه، للسلسلة.


setOnChangeAction(action)

تضبط هذه السياسة Action التي ينفّذها النص البرمجي كلما تغيّر إدخال أداة الاختيار.

المعلمات

الاسمالنوعالوصف
actionActionالإجراء المطلوب اتخاذه.

الإرجاع

DateTimePicker — أداة الاختيار هذه، للسلسلة.


setTimeZoneOffsetInMins(timeZoneOffsetMins)

لضبط عدد الدقائق التي يجب إزاحة المنطقة الزمنية عن التوقيت العالمي المتفق عليه (UTC). إذا تم تعيينها، فإن التاريخ يتم عرض الوقت حسب المنطقة الزمنية المحددة. وإذا لم يتم ضبط السياسة، يتم عرض الوقت في ورقة البيانات المنطقة الزمنية.

المعلمات

الاسمالنوعالوصف
timeZoneOffsetMinsIntegerعدد الدقائق التي تتم فيها إزاحة المنطقة الزمنية من التوقيت العالمي المتفق عليه (UTC).

الإرجاع

DateTimePicker — أداة الاختيار هذه، للسلسلة.


setTitle(title)

لضبط العنوان المعروض أعلى حقل الإدخال.

المعلمات

الاسمالنوعالوصف
titleStringعنوان حقل الإدخال.

الإرجاع

DateTimePicker — أداة الاختيار هذه، للسلسلة.


setValueInMsSinceEpoch(valueMsEpoch)

تحدِّد هذه السياسة القيمة التي تم ملؤها مسبقًا والتي سيتم ضبطها في حقل الإدخال.

المعلمات

الاسمالنوعالوصف
valueMsEpochNumberالقيمة التلقائية الموضوعة في الإدخال كرقم، بالمللي ثانية منذ الحقبة. ويتم تمثيله دائمًا كسلسلة في معلمات رد الاتصال في النموذج.

الإرجاع

DateTimePicker — أداة الاختيار هذه، للسلسلة.


setValueInMsSinceEpoch(valueMsEpoch)

تحدِّد هذه السياسة القيمة التي تم ملؤها مسبقًا والتي سيتم ضبطها في حقل الإدخال.

المعلمات

الاسمالنوعالوصف
valueMsEpochStringالقيمة التلقائية الموضوعة في المُدخل كسلسلة بالمللي ثانية منذ الحقبة. ويتم تمثيله دائمًا كسلسلة في معلمات رد الاتصال في النموذج.

الإرجاع

DateTimePicker — أداة الاختيار هذه، للسلسلة.