Class DateField

فیلد تاریخ

منسوخ شده است. در عوض، از سرویس پیشرفته People API استفاده کنید

فیلد تاریخ در مخاطب

این کلاس فقط توسط سرویس مخاطبین استفاده می شود و تاریخ های استفاده شده در جاهای دیگر در App Script از شی استاندارد Date جاوا اسکریپت استفاده می کنند.

روش ها

روش	نوع برگشت	شرح مختصر
get Label()	Object	برچسب این فیلد را دریافت می کند.
set Label(label)	Date Field	برچسب این فیلد را تنظیم می کند.

روش های منسوخ شده

روش	نوع برگشت	شرح مختصر
delete Date Field()	void	این تاریخ را حذف می کند.
get Day()	Integer	روز ماه را برای این تاریخ دریافت می کند.
get Month()	Month	ماه این تاریخ را دریافت می کند.
get Year()	Integer	سال این تاریخ را دریافت می کند.
set Date(month, day)	Date Field	تاریخ را بدون یک سال به امروز تنظیم می کند.
set Date(month, day, year)	Date Field	تاریخ را به این روز تنظیم می کند.
set Label(label)	Date Field	برچسب این فیلد را مانند "تولد" یا "سالگرد" تنظیم می کند.

مستندات دقیق

get Label()

برچسب این فیلد را دریافت می کند. این ممکن است یک فیلد، 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.
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

---

set Label(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	برچسب جدید برای این زمینه

بازگشت

Date Field - این فیلد برای زنجیره‌بندی مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

روش های منسوخ شده

delete Date Field()

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

این تاریخ را حذف می کند.

// 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

---

get Day()

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

روز ماه را برای این تاریخ دریافت می کند.

توجه: برای آبجکت‌های استاندارد تاریخ جاوا اسکریپت، متد get Day() روز هفته را برمی‌گرداند.

// 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

---

get Month()

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

ماه این تاریخ را دریافت می کند.

// 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

---

get Year()

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

سال این تاریخ را دریافت می کند.

// 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

---

set Date(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	روز

بازگشت

Date Field - این تاریخ برای زنجیر کردن مفید است

پرتاب می کند

Error - اگر این فیلد تاریخ به یک سال نیاز دارد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

---

set Date(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	سال

بازگشت

Date Field - این تاریخ برای زنجیر کردن مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

---

set Label(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	برچسب استاندارد جدید

بازگشت

Date Field - این فیلد برای زنجیره‌بندی مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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