Class DateField

DateField

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

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

لا يتم استخدام هذه الفئة إلا من خلال خدمة جهات الاتصال، كما أن التواريخ المستخدمة في أي مكان آخر في "برمجة التطبيقات" تستخدم كائن التاريخ القياسي في JavaScript.

الطُرق

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
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 أو سلسلة.

// 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
for (var 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
addressFields[0].setLabel('Apartment');

المَعلمات

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

استرجاع الكرة

DateField: هذا الحقل مفيد للسلاسل

التفويض

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

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

الطرق المتوقّفة نهائيًا

deleteDateField()

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

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

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

التفويض

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

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

---

getDay()

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

تحديد يوم من الشهر لهذا التاريخ

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

// Logs the day of the birthday for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var 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'
var contacts = ContactsApp.getContactsByName('John Doe');
var 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'
var contacts = ContactsApp.getContactsByName('John Doe');
var 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
var contacts = ContactsApp.getContactsByName('John Doe');
var birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
birthday.setDate(ContactsApp.Month.APRIL, 1);

المَعلمات

الاسم	Type	الوصف
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
var contacts = ContactsApp.getContactsByName('John Doe');
var birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
birthday.setDate(ContactsApp.Month.APRIL, 1, 1980);

المَعلمات

الاسم	Type	الوصف
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
var contacts = ContactsApp.getContactsByName('John Doe');
var firstDate = contacts[0].getDates()[0];
firstDate.setLabel(ContactsApp.Field.ANNIVERSARY);

المَعلمات

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

استرجاع الكرة

DateField: هذا الحقل مفيد للسلاسل

التفويض

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

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