Diese Seite wurde von der Cloud Translation API übersetzt.

Class 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