Questa pagina è stata tradotta dall'API Cloud Translation.

Class DateField

Ritiro. Utilizza invece il servizio avanzato dell'API People

Un campo data in un contatto.

Questa classe viene utilizzata solo dal servizio Contatti e le date utilizzate altrove in App Script utilizzano l'oggetto Date standard di JavaScript.

Metodi

Metodo	Tipo restituito	Breve descrizione
`getLabel()`	`Object`	Recupera l'etichetta di questo campo.
`setLabel(label)`	`DateField`	Imposta l'etichetta di questo campo.

Metodi ritirati

Metodo	Tipo restituito	Breve descrizione
`deleteDateField()`	`void`	Elimina questa data.
`getDay()`	`Integer`	Recupera il giorno del mese per questa data.
`getMonth()`	`Month`	Restituisce il mese di questa data.
`getYear()`	`Integer`	Recupera l'anno di questa data.
`setDate(month, day)`	`DateField`	Imposta la data sul giorno corrente, senza anno.
`setDate(month, day, year)`	`DateField`	Imposta la data su quella odierna.
`setLabel(label)`	`DateField`	Imposta l'etichetta di questo campo, ad esempio "Compleanno" o "Anniversario".

Documentazione dettagliata

`getLabel()`

Recupera l'etichetta di questo campo. Può essere un campo, un campo esteso o una stringa.

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

Invio

Object: l'etichetta di questo campo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`setLabel(label)`

Imposta l'etichetta di questo 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');

Parametri

Nome	Tipo	Descrizione
`label`	`String`	la nuova etichetta per questo campo

Invio

DateField: questo campo, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

Metodi ritirati

`deleteDateField()`

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Elimina questa data.

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

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`getDay()`

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Recupera il giorno del mese per questa data.

Nota: per gli oggetti Date standard di JavaScript, il metodo getDay() restituisce invece il giorno della settimana.

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

Invio

Integer: il giorno del mese

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`getMonth()`

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Restituisce il mese di questa data.

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

Invio

Month: il mese

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`getYear()`

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Recupera l'anno di questa data.

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

Invio

Integer: l'anno

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`setDate(month, day)`

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Imposta la data sul giorno corrente, senza anno.

Questo metodo si applica solo ai campi della data che non richiedono un anno, ad esempio i compleanni.

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

Parametri

Nome	Tipo	Descrizione
`month`	`Month`	il mese
`day`	`Integer`	il giorno

Invio

DateField: questa data, utile per l'accodamento

Lanci

Error: se questo campo della data richiede un anno

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`setDate(month, day, year)`

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Imposta la data su quella odierna.

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

Parametri

Nome	Tipo	Descrizione
`month`	`Month`	il mese
`day`	`Integer`	il giorno
`year`	`Integer`	l'anno

Invio

DateField: questa data, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`setLabel(label)`

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Imposta l'etichetta di questo campo, ad esempio "Compleanno" o "Anniversario".

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

Parametri

Nome	Tipo	Descrizione
`label`	`Field`	la nuova etichetta standard

Invio

DateField: questo campo, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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