Class DateField

DateField

Veraltet. Verwenden Sie stattdessen die erweiterte People API-API Dienst

Ein Datumsfeld in einem Kontakt.

Diese Klasse wird nur vom Kontakte-Dienst verwendet. An anderer Stelle in Apps Script verwendete Datumsangaben verwenden JavaScript-Standard Date-Objekt enthält.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getLabel()	Object	Ruft das Label für dieses Feld ab.
setLabel(label)	DateField	Legt die Beschriftung dieses Felds fest.

Verworfene Methoden

Methode	Rückgabetyp	Kurzbeschreibung
deleteDateField()	void	Löscht dieses Datum.
getDay()	Integer	Ruft den Tag des Monats für dieses Datum ab.
getMonth()	Month	Ruft den Monat für dieses Datum ab.
getYear()	Integer	Ruft das Jahr für dieses Datum ab.
setDate(month, day)	DateField	Legt das Datum auf diesen Tag ohne Jahr fest.
setDate(month, day, year)	DateField	Legt diesen Tag als Datum fest.
setLabel(label)	DateField	Legt die Beschriftung dieses Felds fest, z. B. "Geburtstag" oder „Jahrestag“.

Detaillierte Dokumentation

getLabel()

Ruft das Label für dieses Feld ab. Dies kann ein Feld, ExtendedField oder ein String sein.

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

Rückflug

Object – das Label für dieses Feld

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

---

setLabel(label)

Legt die Beschriftung dieses Felds fest.

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

Parameter

Name	Typ	Beschreibung
label	String	das neue Label für dieses Feld

Rückflug

DateField: Dieses Feld ist für Verkettungen nützlich.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Verworfene Methoden

deleteDateField()

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Löscht dieses Datum.

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

---

getDay()

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Ruft den Tag des Monats für dieses Datum ab.

Hinweis: Bei standardmäßigen JavaScript-Date-Objekten ist der Parameter Die Methode getDay() gibt stattdessen den Wochentag zurück.

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

Rückflug

Integer – der Tag des Monats

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

---

getMonth()

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Ruft den Monat für dieses Datum ab.

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

Rückflug

Month – der Monat

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

---

getYear()

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Ruft das Jahr für dieses Datum ab.

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

Rückflug

Integer – das Jahr

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

---

setDate(month, day)

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Legt das Datum auf diesen Tag ohne Jahr fest.

Diese Methode gilt nur für Datumsfelder, für die kein Jahr erforderlich ist, z. B. Geburtstage.

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

Parameter

Name	Typ	Beschreibung
month	Month	der Monat
day	Integer	den Tag

Rückflug

DateField – dieses Datum, nützlich für Verkettungen

Löst aus

Error – wenn für dieses Datumsfeld ein Jahr erforderlich ist

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

---

setDate(month, day, year)

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Legt diesen Tag als Datum fest.

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

Parameter

Name	Typ	Beschreibung
month	Month	der Monat
day	Integer	den Tag
year	Integer	das Jahr

Rückflug

DateField – dieses Datum, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

---

setLabel(label)

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Legt die Beschriftung dieses Felds fest, z. B. "Geburtstag" oder „Jahrestag“.

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

Parameter

Name	Typ	Beschreibung
label	Field	dem neuen Standardlabel

Rückflug

DateField: Dieses Feld ist für Verkettungen nützlich.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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