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 オブジェクトで表された日時に years で表された年数を加算した値を示すオブジェクト。

例外

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

\- または -

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

米国では、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);
let minimumAge = 16
let dateToday = DateTimeOffset.Now
let latestBirthday = dateToday.AddYears(-1 * minimumAge)
printfn $"To possess a driver's license, you must have been born on or before {latestBirthday:d}."
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 使用します。

Note

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

適用対象