DateTimeOffset.AddYears(Int32) メソッド

定義

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

public:
 DateTimeOffset AddYears(int years);
public DateTimeOffset AddYears (int years);
member this.AddYears : int -> DateTimeOffset
Public Function AddYears (years As Integer) As DateTimeOffset

パラメーター

years
Int32

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

戻り値

DateTimeOffset

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

例外

結果として得られる DateTimeOffset 値は MinValue より小さい値です。

米国では、16歳未満の運転者に対してドライバーのライセンスを発行することはできません。 次の例では、合法的に運転免許証を発行するために、個人を生まれなければならない最新の日付が表示されます。

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);
Const minimumAge As Integer = 16
Dim dateToday As DateTimeOffset = DateTimeOffset.Now
Dim latestBirthday As DateTimeOffset = 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 オブジェクトを返します。 日付と時刻にを追加することによって、現在のオブジェクトの値を変更することはありません months

適用対象