Этот класс используется только службой контактов, а даты, используемые в других местах сценария приложения, используют стандартный объект Date JavaScript.
Устанавливает метку этого поля, например «День рождения» или «Годовщина».
Подробная документация
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 — метка для этого поля
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
// 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');
Устарело. Эта функция устарела и не должна использоваться в новых скриптах.
Удаляет эту дату.
// 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();
}
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
Устарело. Эта функция устарела и не должна использоваться в новых скриптах.
Получает день месяца для этой даты.
Примечание. Для стандартных объектов 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 — день месяца
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
Устарело. Эта функция устарела и не должна использоваться в новых скриптах.
Получает месяц для этой даты.
// 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());
Устарело. Эта функция устарела и не должна использоваться в новых скриптах.
Получает год для этой даты.
// 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 — год
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
Устарело. Эта функция устарела и не должна использоваться в новых скриптах.
Устанавливает дату по этому дню, без указания года.
Этот метод применяется только к полям даты, для которых не требуется указание года, например дней рождения.
// 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);
Устарело. Эта функция устарела и не должна использоваться в новых скриптах.
Устанавливает дату на этот день.
// 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);
Устарело. Эта функция устарела и не должна использоваться в новых скриптах.
Устанавливает метку этого поля, например «День рождения» или «Годовщина».
// 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);