Class DateField

DateField

已淘汰。請改用 People API 進階服務

聯絡人中的日期欄位。

這個類別只會用於聯絡人服務，而 App Script 其他位置使用的日期則使用 JavaScript 的標準 Date 物件。

方法

方法	傳回類型	簡短說明
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