Class DateField

DateField

Obsoleto. En su lugar, usa el servicio avanzado de la API de People.

Un campo de fecha en un contacto

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.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
getLabel()	Object	Obtiene la etiqueta de este campo.
setLabel(label)	DateField	Establece la etiqueta de este campo.

Métodos obsoletos

Método	Tipo de datos que se muestra	Descripción breve
deleteDateField()	void	Borra esta fecha.
getDay()	Integer	Obtiene el día del mes de esta fecha.
getMonth()	Month	Obtiene el mes de esta fecha.
getYear()	Integer	Obtiene el año para esta fecha.
setDate(month, day)	DateField	Establece la fecha de este día, sin un año.
setDate(month, day, year)	DateField	Establece la fecha de este día.
setLabel(label)	DateField	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');

Parámetros

Nombre	Tipo	Descripción
label	String	la nueva etiqueta para este campo

Devolvedor

DateField: Este campo es útil para encadenar.

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

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());

Devolvedor

Month: el 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

---

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);

Parámetros

Nombre	Tipo	Descripción
month	Month	del mes
day	Integer	el día

Devolvedor

DateField: Esta fecha es útil para encadenar.

Arroja

Error: si este campo de fecha requiere un 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, 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);

Parámetros

Nombre	Tipo	Descripción
month	Month	del mes
day	Integer	el día
year	Integer	del año

Devolvedor

DateField: Esta fecha es útil para encadenar.

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)

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);

Parámetros

Nombre	Tipo	Descripción
label	Field	la nueva etiqueta estándar

Devolvedor

DateField: Este campo es útil para encadenar.

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