Class DateField

DatumFeld

Veraltet. Verwenden Sie stattdessen den erweiterten Dienst der People API.

Ein Datumsfeld in einem Kontakt.

Diese Klasse wird nur vom Kontaktdienst verwendet. Andernfalls wird in Apps Script das standardmäßige Date-Objekt von JavaScript verwendet.

Methoden

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

Eingestellte Methoden

Methode	Rückgabetyp	Kurzbeschreibung
deleteDateField()	void	Damit wird dieses Datum gelöscht.
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	Das Datum wird auf den heutigen Tag ohne Jahr festgelegt.
setDate(month, day, year)	DateField	Das Datum wird auf den heutigen Tag festgelegt.
setLabel(label)	DateField	Hier wird das Label dieses Felds festgelegt, z. B. „Geburtstag“ oder „Jahrestag“.

Detaillierte Dokumentation

getLabel()

Ruft das Label für dieses Feld ab. Dies kann ein Feld, ein erweitertes Feld 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
for (let i = 0; i < addressFields.length; i++) {
  Logger.log(addressFields[i].getLabel());
}

Rückflug

Object – das Label für dieses Feld

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

setLabel(label)

Legt das Label 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const 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 die Verkettung nützlich

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Eingestellte Methoden

deleteDateField()

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Damit wird dieses Datum gelöscht.

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

getDay()

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

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

Hinweis: Bei standardmäßigen JavaScript-Datumsobjekten gibt die Methode getDay() stattdessen den Wochentag zurück.

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

Rückflug

Integer – der Tag des Monats

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

getMonth()

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Ruft den Monat für dieses Datum ab.

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

Rückflug

Month – der Monat

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

getYear()

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Ruft das Jahr für dieses Datum ab.

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

Rückflug

Integer – das Jahr

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

setDate(month, day)

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Das Datum wird auf den heutigen Tag ohne Jahr festgelegt.

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
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
birthday.setDate(ContactsApp.Month.APRIL, 1);

Parameter

Name	Typ	Beschreibung
month	Month	des Monats
day	Integer	den Tag

Rückflug

DateField – dieses Datum, nützlich für die Verkettung

Löst aus

Error: Für dieses Datumsfeld ist ein Jahr erforderlich.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

setDate(month, day, year)

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Das Datum wird auf den heutigen Tag festgelegt.

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

Parameter

Name	Typ	Beschreibung
month	Month	des Monats
day	Integer	den Tag
year	Integer	des Jahres

Rückflug

DateField – dieses Datum, nützlich für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

setLabel(label)

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Hiermit wird das Label dieses Felds festgelegt, z. B. „Geburtstag“ oder „Jahrestag“.

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

Parameter

Name	Typ	Beschreibung
label	Field	das neue Standardlabel

Rückflug

DateField – dieses Feld ist für die Verkettung nützlich

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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