Class DateField

Campo de fecha

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 usa esta clase, y las fechas que se usan en otros lugares de Apps 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 de esta fecha.
setDate(month, day)	DateField	Establece la fecha en el día de hoy, sin año.
setDate(month, day, year)	DateField	Establece la fecha en el día actual.
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 ExtendedField o una cadena.

// 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
for (let i = 0; i < addressFields.length; i++) {
  Logger.log(addressFields[i].getLabel());
}

Volver

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 ámbitos:

• 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
addressFields[0].setLabel('Apartment');

Parámetros

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

Volver

DateField: Este campo es útil para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

Métodos obsoletos

deleteDateField()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Borra esta fecha.

// Deletes all the dates that are set for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const dates = contacts[0].getDates();
for (let 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 ámbitos:

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

---

getDay()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el día del mes de esta fecha.

Nota: En el caso de los objetos Date 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'
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
Logger.log(birthday.getDay());

Volver

Integer: Es 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 ámbitos:

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

---

getMonth()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el mes de esta fecha.

// Logs the month of the birthday for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
Logger.log(birthday.getMonth());

Volver

Month: Es el mes.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

getYear()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el año de esta fecha.

// Logs the year of the birthday for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
Logger.log(birthday.getYear());

Volver

Integer: Es 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 ámbitos:

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

---

setDate(month, day)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece la fecha en el día de hoy, sin año.

Este método solo se aplica a los campos de fecha que no requieren un año, como los cumpleaños.

// Sets the birthday for contact 'John Doe' to April 1
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
birthday.setDate(ContactsApp.Month.APRIL, 1);

Parámetros

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

Volver

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 ámbitos:

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

---

setDate(month, day, year)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece la fecha en el día actual.

// Sets the birthday for contact 'John Doe' to April 1, 1980
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
birthday.setDate(ContactsApp.Month.APRIL, 1, 1980);

Parámetros

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

Volver

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 ámbitos:

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

---

setLabel(label)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

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
const contacts = ContactsApp.getContactsByName('John Doe');
const firstDate = contacts[0].getDates()[0];
firstDate.setLabel(ContactsApp.Field.ANNIVERSARY);

Parámetros

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

Volver

DateField: Este campo es útil para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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