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

Устаревшие методы

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

Удаляет эту дату.

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

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

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

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

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

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

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

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

Получает год для этой даты.

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

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

Устанавливает дату по этому дню, без указания года.

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

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

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

Устанавливает дату на этот день.

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

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

Устанавливает метку этого поля, например «День рождения» или «Годовщина».

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