本頁面由 Cloud Translation API 翻譯而成。

Class DateField

「聯絡人」中的日期欄位。

此類別僅供聯絡人服務使用，以及 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 Date 物件， 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