इस क्लास का इस्तेमाल सिर्फ़ Contacts सेवा देती है. साथ ही, App Script में कहीं और इस्तेमाल की जाने वाली तारीखों में, JavaScript के स्टैंडर्ड
तारीख ऑब्जेक्ट का इस्तेमाल किया जाता है.
इस फ़ील्ड का लेबल सेट करता है, जैसे कि 'जन्म की तारीख' या 'एनिवर्सरी'.
ज़्यादा जानकारी के साथ दस्तावेज़
getLabel()
इस फ़ील्ड के लिए लेबल की जानकारी मिलती है. यह कोई फ़ील्ड, ExtendedField या स्ट्रिंग हो सकती है.
// 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());
}
रिटर्न
Object — इस फ़ील्ड का लेबल
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
https://www.google.com/m8/feeds
setLabel(label)
इस फ़ील्ड का लेबल सेट करता है.
// 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');
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
https://www.google.com/m8/feeds
काम न करने वाले तरीके
deleteDateField()
अब काम नहीं करता. यह फ़ंक्शन अब काम नहीं करता. इसलिए, नई स्क्रिप्ट में इसका इस्तेमाल नहीं किया जाना चाहिए.
इस तारीख को मिटाता है.
// 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();
}
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
https://www.google.com/m8/feeds
getDay()
अब काम नहीं करता. यह फ़ंक्शन अब काम नहीं करता. इसलिए, नई स्क्रिप्ट में इसका इस्तेमाल नहीं किया जाना चाहिए.
इस तारीख के लिए महीने का दिन मिलता है.
ध्यान दें: JavaScript की तारीख वाले स्टैंडर्ड ऑब्जेक्ट के लिए, getDay() तरीका हफ़्ते के दिन की जानकारी देता है.
// 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());
रिटर्न
Integer — महीने का दिन
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
https://www.google.com/m8/feeds
getMonth()
अब काम नहीं करता. यह फ़ंक्शन अब काम नहीं करता. इसलिए, नई स्क्रिप्ट में इसका इस्तेमाल नहीं किया जाना चाहिए.
इस तारीख के लिए महीने की जानकारी मिलती है.
// 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());
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
https://www.google.com/m8/feeds
getYear()
अब काम नहीं करता. यह फ़ंक्शन अब काम नहीं करता. इसलिए, नई स्क्रिप्ट में इसका इस्तेमाल नहीं किया जाना चाहिए.
इस तारीख के लिए साल की जानकारी मिलती है.
// 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());
रिटर्न
Integer — साल
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
https://www.google.com/m8/feeds
setDate(month, day)
अब काम नहीं करता. यह फ़ंक्शन अब काम नहीं करता. इसलिए, नई स्क्रिप्ट में इसका इस्तेमाल नहीं किया जाना चाहिए.
बिना साल के, इस दिन के लिए तारीख सेट करता है.
यह तरीका सिर्फ़ उन तारीख के फ़ील्ड पर लागू होता है जिनमें साल की ज़रूरत नहीं होती, जैसे कि जन्मदिन.
// 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);
Error — अगर तारीख के इस फ़ील्ड को एक साल की ज़रूरत है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
https://www.google.com/m8/feeds
setDate(month, day, year)
अब काम नहीं करता. यह फ़ंक्शन अब काम नहीं करता. इसलिए, नई स्क्रिप्ट में इसका इस्तेमाल नहीं किया जाना चाहिए.
इस दिन के लिए तारीख सेट करता है.
// 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);
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
https://www.google.com/m8/feeds
setLabel(label)
अब काम नहीं करता. यह फ़ंक्शन अब काम नहीं करता. इसलिए, नई स्क्रिप्ट में इसका इस्तेमाल नहीं किया जाना चाहिए.
इस फ़ील्ड का लेबल सेट करता है, जैसे कि 'जन्म की तारीख' या 'एनिवर्सरी'.
// 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);