Bu sınıf yalnızca Kişiler hizmeti tarafından kullanılır. Uygulama Komut Dosyası'nın başka bir yerinde kullanılan tarihler ise JavaScript'in standart
Date nesnesini kullanır.
Bu alanın etiketini (ör. "Doğum günü" veya "Yıldönümü") ayarlar.
Ayrıntılı belgeler
getLabel()
Bu alan için etiketi 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
for (var i = 0; i < addressFields.length; i++) {
Logger.log(addressFields[i].getLabel());
}
Return
Object — bu alanın etiketi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
addressFields[0].setLabel('Apartment');
Parametreler
Ad
Tür
Açıklama
label
String
bu alan için yeni etiket
Return
DateField: Bu alan, zincirleme bağlantı için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
https://www.google.com/m8/feeds
Kullanımdan kaldırılan yöntemler
deleteDateField()
Kullanımdan kaldırıldı. Bu işlev kullanımdan kaldı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'
var contacts = ContactsApp.getContactsByName('John Doe');
var dates = contacts[0].getDates();
for (var i = 0; i < dates.length; i++) {
dates[i].deleteDateField();
}
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
https://www.google.com/m8/feeds
getDay()
Kullanımdan kaldırıldı. Bu işlev kullanımdan kaldı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 Tarih nesneleri için getDay() yöntemi, bunun yerine haftanın gününü döndürür.
// 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());
Return
Integer - ayın günü
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
https://www.google.com/m8/feeds
getMonth()
Kullanımdan kaldırıldı. Bu işlev kullanımdan kaldırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.
Bu tarihin ayı bilgisini alır.
// 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());
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
https://www.google.com/m8/feeds
getYear()
Kullanımdan kaldırıldı. Bu işlev kullanımdan kaldırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.
Bu tarihin yılı bilgisini alır.
// 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());
Return
Integer — yıl
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
https://www.google.com/m8/feeds
setDate(month, day)
Kullanımdan kaldırıldı. Bu işlev kullanımdan kaldırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.
Tarihi, yıl olmadan geçerli gün olarak ayarlar.
Bu yöntem yalnızca, doğum günleri gibi yıl gerektirmeyen tarih alanları için geçerlidir.
// 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);
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
https://www.google.com/m8/feeds
setDate(month, day, year)
Kullanımdan kaldırıldı. Bu işlev kullanımdan kaldırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.
Tarihi bu güne ayarlar.
// 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);
DateField — bu tarih, zincirleme bağlantı için faydalı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
https://www.google.com/m8/feeds
setLabel(label)
Kullanımdan kaldırıldı. Bu işlev kullanımdan kaldırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.
Bu alanın etiketini (ör. "Doğum günü" veya "Yıldönümü") ayarlar.
// 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);