EastAsianLunisolarCalendar.AddYears メソッド

.NET Framework クラス ライブラリ リファレンス

EastAsianLunisolarCalendar.AddYears メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した日付から指定した年数が経過した後の日付を計算します。

名前空間: System.Globalization
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 AddYears ( _
    time As DateTime, _
    years As Integer _
) As DateTime

Visual Basic (使用法)

Dim instance As EastAsianLunisolarCalendar
Dim time As DateTime
Dim years As Integer
Dim returnValue As DateTime

returnValue = instance.AddYears(time, years)

C#

public override DateTime AddYears (
    DateTime time,
    int years
)

C++

public:
virtual DateTime AddYears (
    DateTime time, 
    int years
) override

J#

public DateTime AddYears (
    DateTime time, 
    int years
)

JScript

public override function AddYears (
    time : DateTime, 
    years : int
) : DateTime

パラメータ

time

years を加算する対象の DateTime オブジェクト。

years

追加する年数。

戻り値
time パラメータに指定した年数を加算した結果の新しい DateTime オブジェクト。

例外

例外の種類	条件
ArgumentException	結果が DateTime オブジェクトでサポートされている範囲外の値です。
ArgumentOutOfRangeException	time が MinSupportedDateTime より小さい値か、MaxSupportedDateTime より大きい値です。

解説

結果として得られる日が、結果の年の結果の月に対して有効な日でない場合は、結果として得られる DateTime オブジェクトの日付部分が影響を受けます。この場合、この日付は、結果の年の結果の月で有効な最後の日付に変更されます。結果として得られる DateTime オブジェクトの月の部分は、指定した DateTime オブジェクトの値と同じままです。この実装では現在の時代 (年号) だけをサポートしています。したがって、結果として得られた年が、指定された DateTime オブジェクトの時代 (年号) の範囲外の場合、ArgumentException がスローされます。結果として得られる DateTime オブジェクトの時刻の部分は、指定した DateTime オブジェクトの値と同じままです。

たとえば、2 月の日数は 28 日ですが、閏年の場合は 29 日になります。指定した日付が閏年の 2 月 29 日で years パラメータの値が 1 の場合、結果として得られる日付は翌年の 2 月 28 日になります。

years が負の場合、結果の DateTime オブジェクトは、指定した DateTime オブジェクトよりも前の値になります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
EastAsianLunisolarCalendar クラス
EastAsianLunisolarCalendar メンバ
System.Globalization 名前空間