このページは Cloud Translation API によって翻訳されました。

Class DateField

連絡先の日付フィールド。

このクラスは連絡先サービスでのみ使用され、日付は Apps 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 - このフィールドのラベル

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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 - このフィールド、チェーンに便利です

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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 - 日

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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 - 月

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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 - 年

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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 - この日付フィールドに年が必要な場合

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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 - この日付。チェーンに役立ちます。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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 - このフィールド、チェーンに便利です

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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