ADDYEARS 関数は年数を日付に加算します。

たとえば、ADDYEARS 関数を使って、顧客の契約終了日を表示できます。

ADDYEARS(Date, number)

引数データ型説明
日付日付年を加算する日付
数値数値日付に加算する年数

ADDYEARS 関数は結果を日付で返します。

Polaris では、Number 引数に値 NaN (非数) の値を使用した場合、ADDYEARS 関数で空白値が返されます。

Classic エンジンでは、ADDYEARS で使用される NaN の値は 0 と同等です。

式で日付から年数を減算するには負の数値を使用します (例: ADDYEARS(Amended contract date, -2))。

EDATE

こちらの例では、「Contract Details」モジュールの行にライン アイテムがあり、列には「Customers」リストがあります。どちらのライン アイテムも形式は日付です。

この式は、顧客の契約開始日から 2 年後の日付を返します。


Customer ACustomer B
Contract start date01/01/202101/06/2021

Contract end date

ADDYEARS(Contract start date, 2)

01/01/202301/06/2023

日付に年と日を加算するには、式で正の数値を使用します。 こちらの例では、式が契約開始日から 1 年 7 日後の日付を返しています。


Customer ACustomer B
Contract start date01/01/202101/06/2021

Contract end date

ADDYEARS(Contract start date, 1) + 7

08/01/202208/06/2022