DateTimeOffset.AddYears(Int32) メソッド

定義

名前空間:

System

アセンブリ:

netstandard.dll, System.Runtime.dll

ソース:

DateTimeOffset.cs

このインスタンスの値に、指定された年数を加算した新しい DateTimeOffset オブジェクトを返します。

C#

public DateTimeOffset AddYears(int years);

パラメーター

years

Int32

年数。 正数または負数を指定できます。

戻り値

DateTimeOffset

現在の DateTimeOffset オブジェクトで表された日時に years で表された年数を加算した値を示すオブジェクト。

例外

ArgumentOutOfRangeException

結果 DateTimeOffset の値が DateTimeOffset.MinValue 未満です。

\- または -

結果 DateTimeOffset の値が DateTimeOffset.MaxValue より大きくなります。

例

米国では、16歳未満の方に運転免許証を発行することはできません。 次の例では、運転免許証を法的に発行するために、人が生まれる必要がある最新の日付を表示します。

C#

const int minimumAge = 16;
DateTimeOffset dateToday = DateTimeOffset.Now;
DateTimeOffset latestBirthday = dateToday.AddYears(-1 * minimumAge);
Console.WriteLine("To possess a driver's license, you must have been born on or before {0:d}.",
                  latestBirthday);

注釈

日付と時刻の値に 1 つの時間間隔単位 (分や日など) を追加する他のほとんどの方法とは異なり、 AddYears 年の小数部を追加することはできません。 年に加えて、他の時間単位で構成される時間をオブジェクトに DateTimeOffset 追加するには、 メソッドを Add 使用します。

注意

このメソッドは、新 DateTimeOffset しい オブジェクトを返します。 現在のオブジェクトの日付と時刻に を追加 years しても、現在のオブジェクトの値は変更されません。

適用対象