Class DateField

TarihAlanı

Kullanımdan kaldırıldı. Bunun yerine People API ileri seviye hizmetini kullanın.

Kişilerdeki tarih alanları.

Bu sınıf yalnızca Kişiler hizmeti tarafından kullanılır. App Script'in başka yerlerinde kullanılan tarihler ise JavaScript'in standart Date nesnesini kullanır.

Yöntemler

YöntemDönüş türüKısa açıklama
getLabel()ObjectBu alanın etiketini alır.
setLabel(label)DateFieldBu alanın etiketini ayarlar.
YöntemDönüş türüKısa açıklama
deleteDateField()voidBu tarihi siler.
getDay()IntegerBu tarih için ayın gününü alır.
getMonth()MonthBu tarih için ayı alır.
getYear()IntegerBu tarihin yılını alır.
setDate(month, day)DateFieldTarihi yıl olmadan bugüne ayarlar.
setDate(month, day, year)DateFieldTarihi bugün olarak ayarlar.
setLabel(label)DateFieldBu alanın etiketini (ör. "Doğum günü" veya "Yıl dönümü") ayarlar.

Ayrıntılı dokümanlar

getLabel()

Bu alanın etiketini alır. Bu bir Alan, Genişletilmiş Alan veya Dize olabilir.

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

Return

Object: Bu alanın etiketi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setLabel(label)

Bu alanın etiketini ayarlar.

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

Parametreler

AdTürAçıklama
labelStringbu alanın yeni etiketi

Return

DateField: zincirleme için yararlı olan bu alan

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Kullanımdan kaldırılan yöntemler

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Bu tarihi siler.

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Bu tarih için ayın gününü alır.

Not: Standart JavaScript Date nesneleri için getDay() yöntemi, haftanın gününü döndürür.

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

Return

Integer: Ayın günü

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Bu tarih için ayı alır.

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

Return

Month: Ay

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Bu tarihin yılını alır.

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

Return

Integer: yıl

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Tarihi yıl olmadan bugüne ayarlar.

Bu yöntem yalnızca doğum tarihleri gibi yıl gerektirmeyen tarih alanları için geçerlidir.

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

Parametreler

AdTürAçıklama
monthMonthay
dayIntegergün

Return

DateField: zincirleme için yararlı olan bu tarih

Atışlar

Error: Bu tarih alanında yıl gerekiyorsa

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Tarihi bugün olarak ayarlar.

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

Parametreler

AdTürAçıklama
monthMonthay
dayIntegergün
yearIntegeryıl

Return

DateField: zincirleme için yararlı olan bu tarih

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Bu alanın etiketini (ör. "Doğum günü" veya "Yıl dönümü") ayarlar.

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

Parametreler

AdTürAçıklama
labelFieldyeni standart etiket

Return

DateField: zincirleme için yararlı olan bu alan

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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