Class DateField

CampoData

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