Diese Seite wurde von der Cloud Translation API übersetzt.

Class DateField

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`	Hiermit 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

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