DateTimeOffset.AddYears(Int32) メソッド

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

アセンブリ:

mscorlib.dll

アセンブリ:

netstandard.dll

このインスタンスの値に、指定された年数を加算した新しい 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 で表された年数を加算した値を示すオブジェクト。

例外

ArgumentOutOfRangeException

結果 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 しいオブジェクトを返します。 現在のオブジェクトの値は、その日付と時刻に追加 months しても変更されません。