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

Class DateField

تمّ إيقاف هذا العمود نهائيًا. بدلاً من ذلك، استخدِم خدمة People API المتقدمة.

حقل تاريخ في جهة اتصال

لا تستخدم خدمة "جهات الاتصال" سوى هذه الفئة، بينما يتم استخدام Date العادي في JavaScript للكائنات التي يتم استخدامها في أماكن أخرى من App Script.

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`getLabel()`	`Object`	تحصل على تصنيف هذا الحقل.
`setLabel(label)`	`DateField`	لضبط تصنيف هذا الحقل.

الطرق المتوقّفة

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`deleteDateField()`	`void`	يؤدي إلى حذف هذا التاريخ.
`getDay()`	`Integer`	تحصل على اليوم من الشهر لهذا التاريخ.
`getMonth()`	`Month`	تحصل على شهر هذا التاريخ.
`getYear()`	`Integer`	تحصل على السنة لهذا التاريخ.
`setDate(month, day)`	`DateField`	ضبط التاريخ على هذا اليوم بدون سنة
`setDate(month, day, year)`	`DateField`	ضبط التاريخ على هذا اليوم
`setLabel(label)`	`DateField`	لضبط تصنيف هذا الحقل، مثل "عيد ميلاد" أو "ذكرى سنوية"

مستندات تفصيلية

`getLabel()`

تحصل على تصنيف هذا الحقل. قد يكون هذا الحقل أو ExtendedField أو String.

// Logs the label for all the address fields associated with contact
// 'John Doe'. This method can be similarly called for any field that has
// a label.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
for (let i = 0; i < addressFields.length; i++) {
  Logger.log(addressFields[i].getLabel());
}

الإرجاع

Object: تصنيف هذا الحقل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.google.com/m8/feeds

`setLabel(label)`

لضبط تصنيف هذا الحقل.

// Sets the label to 'Apartment' for the first address field associated
// with contact 'John Doe'. This method can be similarly called for any
// field that has a label.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
addressFields[0].setLabel('Apartment');

المعلمات

الاسم	النوع	الوصف
`label`	`String`	التصنيف الجديد لهذا الحقل

الإرجاع

DateField: هذا الحقل مفيد لإنشاء سلاسل.

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.google.com/m8/feeds

الطرق المتوقّفة

`deleteDateField()`

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

يؤدي إلى حذف هذا التاريخ.

// Deletes all the dates that are set for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const dates = contacts[0].getDates();
for (let i = 0; i < dates.length; i++) {
  dates[i].deleteDateField();
}

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.google.com/m8/feeds

`getDay()`

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تحصل على اليوم من الشهر لهذا التاريخ.

ملاحظة: بالنسبة إلى عناصر JavaScript Date العادية، تعرض الطريقة getDay() يوم الأسبوع بدلاً من ذلك.

// Logs the day of the birthday for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
Logger.log(birthday.getDay());

الإرجاع

Integer: اليوم من الشهر

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.google.com/m8/feeds

`getMonth()`

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تحصل على شهر هذا التاريخ.

// Logs the month of the birthday for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
Logger.log(birthday.getMonth());

الإرجاع

Month: الشهر

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.google.com/m8/feeds

`getYear()`

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تحصل على السنة لهذا التاريخ.

// Logs the year of the birthday for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
Logger.log(birthday.getYear());

الإرجاع

Integer: السنة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.google.com/m8/feeds

`setDate(month, day)`

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

ضبط التاريخ على هذا اليوم بدون سنة

لا تنطبق هذه الطريقة إلا على حقول التاريخ التي لا تتطلّب سنة، مثل تواريخ الميلاد.

// Sets the birthday for contact 'John Doe' to April 1
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
birthday.setDate(ContactsApp.Month.APRIL, 1);

المعلمات

الاسم	النوع	الوصف
`month`	`Month`	الشهر
`day`	`Integer`	اليوم

الإرجاع

DateField - هذا التاريخ، مفيد لإنشاء سلاسل

عمليات الرمي

‫Error - إذا كان حقل التاريخ هذا يتطلّب إدخال سنة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.google.com/m8/feeds

`setDate(month, day, year)`

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

ضبط التاريخ على هذا اليوم

// Sets the birthday for contact 'John Doe' to April 1, 1980
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
birthday.setDate(ContactsApp.Month.APRIL, 1, 1980);

المعلمات

الاسم	النوع	الوصف
`month`	`Month`	الشهر
`day`	`Integer`	اليوم
`year`	`Integer`	السنة

الإرجاع

DateField - هذا التاريخ، مفيد لإنشاء سلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.google.com/m8/feeds

`setLabel(label)`

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

لضبط تصنيف هذا الحقل، مثل "عيد ميلاد" أو "ذكرى سنوية"

// Retrieves the first date that's set for contact 'John Doe' and re-labels
// it as an anniversary
const contacts = ContactsApp.getContactsByName('John Doe');
const firstDate = contacts[0].getDates()[0];
firstDate.setLabel(ContactsApp.Field.ANNIVERSARY);

المعلمات

الاسم	النوع	الوصف
`label`	`Field`	التصنيف العادي الجديد

الإرجاع

DateField: هذا الحقل مفيد لإنشاء سلاسل.

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

https://www.google.com/m8/feeds