Se usó la API de Cloud Translation para traducir esta página.

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