דף זה תורגם על ידי Cloud Translation API.

Class DateField

הוצא משימוש. במקום זאת, צריך להשתמש בשירות המתקדם של People API

שדה תאריך באיש קשר.

הכיתה הזו משמשת רק את השירות 'אנשי קשר'. התאריכים שבהם נעשה שימוש במקומות אחרים ב-App Script משתמשים באובייקט Date הרגיל של JavaScript.

שיטות

שיטה	סוג הערך שמוחזר	תיאור קצר
`getLabel()`	`Object`	הפונקציה מקבלת את התווית של השדה הזה.
`setLabel(label)`	`DateField`	הגדרת התווית של השדה הזה.

שיטות שהוצאו משימוש

שיטה	סוג הערך שמוחזר	תיאור קצר
`deleteDateField()`	`void`	מחיקת התאריך הזה.
`getDay()`	`Integer`	הפונקציה מקבלת את היום בחודש של התאריך הזה.
`getMonth()`	`Month`	הפונקציה מקבלת את החודש של התאריך הזה.
`getYear()`	`Integer`	הפונקציה מקבלת את השנה של התאריך הזה.
`setDate(month, day)`	`DateField`	הגדרת התאריך ליום הזה, בלי שנה.
`setDate(month, day, year)`	`DateField`	הגדרת התאריך ליום הזה.
`setLabel(label)`	`DateField`	מגדיר את התווית של שדה זה, כגון 'יום הולדת' או 'יום שנה'.

תיעוד מפורט

`getLabel()`

הפונקציה מקבלת את התווית של השדה הזה. השדה יכול להיות Field , ExtendedField או String.

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

פרמטרים

שם	תיאור	התיאור
`label`	`String`	התווית החדשה עבור השדה הזה

החזרות

DateField – השדה הזה, שימושי לשרשור

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

החזרות

Month — החודש

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

פרמטרים

שם	תיאור	התיאור
`month`	`Month`	החודש
`day`	`Integer`	ליום

החזרות

DateField – התאריך הזה, שימושי לשרשורים

קליעות

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

פרמטרים

שם	תיאור	התיאור
`month`	`Month`	החודש
`day`	`Integer`	ליום
`year`	`Integer`	השנה

החזרות

DateField – התאריך הזה, שימושי לשרשורים

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

פרמטרים

שם	תיאור	התיאור
`label`	`Field`	התווית הרגילה החדשה

החזרות

DateField – השדה הזה, שימושי לשרשור

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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