年を追加
指定された日付と時刻より指定された年数だけ前または後の年の UTC 日付と時刻を返します。
構文
AddYears(年数、ベース日付、タイムゾーン)有効
ビジネス オブジェクト カテゴリの説明については、「有効な対象」に関する注意事項 ( 「有効」に関する注意事項
ビジネスオブジェクトカテゴリ | はい/いいえ |
|---|---|
ビジネスルール: 保存前ルール | はい |
ビジネス ルール: 計算ルール (保存後、ロード時に再計算の有無) | はい |
ビジネス ルール: 計算ルール (保存前または常に、読み込み時に再計算なし) | はい |
ビジネス ルール: 計算ルール (保存前または常に、読み込み時に再計算) | はい |
ビジネスルール: ルールの編集 | はい |
ビジネスルール: 初期化ルール | はい |
ビジネスルール: 読み取り専用ルール | はい |
ビジネスルール: 必須ルール | はい |
ビジネスルール: 検証ルール | はい |
クライアントの表現 | はい |
オブジェクトの権限 | はい |
サービス | はい |
LDAP の | はい |
携帯 | はい |
クイックアクション(UI クイックアクションを除く) | はい |
UI クイックアクション | はい |
レポート | はい |
フィールド参照のない検索/ダッシュボード | はい |
フィールド参照付き検索/ダッシュボード | はい |
パラメータ
パラメータ | 説明 |
|---|---|
年数 | (オプション) 間隔の数。 指定されていない場合は、デフォルトの間隔である 0 が使用されます。 将来の年数を示す正の整数、または過去の年数を示す負の整数のいずれかになります。 |
ベース日付時刻 | (オプション) 関数の基準日。 指定されていない場合は、現在の日付と時刻であるデフォルトの日付が使用されます。 |
タイムゾーン | (オプション) IANA 形式のタイムゾーン。 |
戻り値
UTC 時間の DateTime 値。
アプリケーションが戻り値を表示する必要がある場合、戻り値は暗黙的にテキストに変換され、カルチャ コードに応じて表示形式が変更されます。 サービス マネージャで使用されるカルチャ コードの一覧については、「 利用可能な言語と文化 」を参照してください。
例
$(AddYears(3))今日が 2014 年 4 月 10 日の場合、この関数は 2017 年 4 月 10 日の DateTime 値を返します。
$(AddYears(-1))今日が 2014 年 4 月 10 日の場合、この関数は 2013 年 4 月 10 日の DateTime 値を返します。
$(AddYears(5, mydate))mydate パラメータの値が 2014 年 4 月 10 日の場合、この関数は 2019 年 4 月 10 日の同じ時刻の DateTime 値を返します。
