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

Class DateField

非推奨。代わりに、People API アドバンストサービスを使用してください。

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

このクラスは Contacts サービスでのみ使用されます。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.
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 - このフィールドのラベル

承認

このメソッドを使用するスクリプトには、次のスコープの 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const 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'
const contacts = ContactsApp.getContactsByName('John Doe');
const dates = contacts[0].getDates();
for (let 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'
const contacts = ContactsApp.getContactsByName('John Doe');
const 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'
const contacts = ContactsApp.getContactsByName('John Doe');
const 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'
const contacts = ContactsApp.getContactsByName('John Doe');
const 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
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 - この日付フィールドに年が必要かどうか

承認

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

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 - この日付（チェーンに便利）

承認

このメソッドを使用するスクリプトには、次のスコープの 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
const contacts = ContactsApp.getContactsByName('John Doe');
const firstDate = contacts[0].getDates()[0];
firstDate.setLabel(ContactsApp.Field.ANNIVERSARY);

パラメータ

名前	型	説明
`label`	`Field`	新しい標準ラベル

戻る

DateField - チェーンに便利なフィールド

承認

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

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