تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class 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)`

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