Cette classe n'est utilisée que par le service Contacts, et les dates utilisées ailleurs dans App Script utilisent l'objet
Date standard de JavaScript.
Définit le libellé de ce champ, tel que "Anniversaire" ou "Anniversaire".
Documentation détaillée
getLabel()
Récupère le libellé de ce champ. Il peut s'agir d'un champ, d'un champ ExtendedField ou d'une chaîne.
// 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());
}
Renvois
Object : libellé de ce champ
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
https://www.google.com/m8/feeds
setLabel(label)
Définit le libellé de ce champ.
// 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');
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
https://www.google.com/m8/feeds
Méthodes obsolètes
deleteDateField()
Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.
Supprime cette date.
// 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();
}
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
https://www.google.com/m8/feeds
getDay()
Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.
Récupère le jour du mois correspondant à cette date.
Remarque: Pour les objets de date JavaScript standards, la méthode getDay() renvoie le jour de la semaine.
// 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());
Renvois
Integer : jour du mois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
https://www.google.com/m8/feeds
getMonth()
Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.
Récupère le mois correspondant à cette date.
// 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());
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
https://www.google.com/m8/feeds
getYear()
Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.
Récupère l'année pour cette date.
// 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());
Renvois
Integer : année
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
https://www.google.com/m8/feeds
setDate(month, day)
Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.
Définit la date sur ce jour, sans année.
Cette méthode ne s'applique qu'aux champs de date qui ne nécessitent pas d'année, comme les anniversaires.
// 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);
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
https://www.google.com/m8/feeds
setDate(month, day, year)
Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.
Définit la date sur ce jour.
// 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);
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
https://www.google.com/m8/feeds
setLabel(label)
Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.
Définit le libellé de ce champ, tel que "Anniversaire" ou "Anniversaire".
// 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);
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
https://www.google.com/m8/feeds
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.