Class DateField

Поле даты

Устарело. Вместо этого используйте расширенный сервис People API.

Поле даты в контакте.

Этот класс используется только службой контактов, а даты, используемые в других местах сценария приложения, используют стандартный объект Date JavaScript.

Методы

Метод	Тип возврата	Краткое описание
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()

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Получает день месяца для этой даты.

Примечание. Для стандартных объектов JavaScript Date метод 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