Class DateField

שדהתאריך

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

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

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

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
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()

הפונקציה מקבלת את התווית של השדה הזה. זה יכול להיות שדה, 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
for (let 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const 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'
const contacts = ContactsApp.getContactsByName('John Doe');
const dates = contacts[0].getDates();
for (let i = 0; i < dates.length; i++) {
  dates[i].deleteDateField();
}

אישור

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

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

---

getDay()

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

הפונקציה מקבלת את היום בחודש של התאריך הזה.

הערה: באובייקטים רגילים של Date ב-JavaScript, השיטה getDay() מחזירה במקום זאת את היום בשבוע.

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

חזרה

Integer – היום בחודש

אישור

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

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

---

getMonth()

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

הפונקציה מקבלת את החודש של התאריך הזה.

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

חזרה

Month – החודש

אישור

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

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

---

getYear()

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

הפונקציה מקבלת את השנה של התאריך הזה.

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

חזרה

Integer – השנה

אישור

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

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

---

setDate(month, day)

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

הפונקציה מגדירה את התאריך ליום הנוכחי, ללא שנה.

השיטה הזו רלוונטית רק לשדות תאריך שלא דורשים ציון שנה, כמו ימי הולדת.

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

פרמטרים

שם	סוג	תיאור
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
const contacts = ContactsApp.getContactsByName('John Doe');
const 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
const contacts = ContactsApp.getContactsByName('John Doe');
const firstDate = contacts[0].getDates()[0];
firstDate.setLabel(ContactsApp.Field.ANNIVERSARY);

פרמטרים

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

חזרה

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

אישור

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

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