Solo el servicio de Contactos utiliza esta clase, y las fechas que se usan en otras secciones de App Script usan el objeto
Date estándar de JavaScript.
Establece la etiqueta de este campo, como "Cumpleaños" o "Aniversario".
Documentación detallada
getLabel()
Obtiene la etiqueta de este campo. Puede ser un campo, un campo ExtendedField o una string.
// 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());
}
Devolvedor
Object: Es la etiqueta de este campo.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
https://www.google.com/m8/feeds
setLabel(label)
Establece la etiqueta de este campo.
// 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');
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
https://www.google.com/m8/feeds
Métodos obsoletos
deleteDateField()
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Borra esta fecha.
// 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();
}
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
https://www.google.com/m8/feeds
getDay()
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Obtiene el día del mes de esta fecha.
Nota: En el caso de los objetos de fecha estándar de JavaScript, el método getDay() muestra el día de la semana.
// 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());
Devolvedor
Integer: El día del mes
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
https://www.google.com/m8/feeds
getMonth()
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Obtiene el mes de esta fecha.
// 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());
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
https://www.google.com/m8/feeds
getYear()
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Obtiene el año para esta fecha.
// 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());
Devolvedor
Integer: el año
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
https://www.google.com/m8/feeds
setDate(month, day)
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Establece la fecha de este día, sin un año.
Este método solo se aplica a los campos de fecha que no requieren un año, como las fechas de nacimiento.
// 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);
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
https://www.google.com/m8/feeds
setDate(month, day, year)
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Establece la fecha de este día.
// 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);
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
https://www.google.com/m8/feeds
setLabel(label)
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Establece la etiqueta de este campo, como "Cumpleaños" o "Aniversario".
// 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);