Class DateField

Датафилд

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

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

Этот класс используется только службой контактов, а даты, используемые в других местах сценария приложения, используют стандартный объект Date 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');

Параметры

Имя	Тип	Описание
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 Date метод 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);

Параметры

Имя	Тип	Описание
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);

Параметры

Имя	Тип	Описание
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);

Параметры

Имя	Тип	Описание
label	Field	новая стандартная этикетка

Возвращаться

DateField — это поле, полезное для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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