EastAsianLunisolarCalendar.AddMonths メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

EastAsianLunisolarCalendar.AddMonths メソッド

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

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

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

Visual Basic (宣言)

Public Overrides Function
 AddMonths ( _
    time As DateTime, _
    months As Integer _
) As DateTime

Visual Basic (使用法)

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

returnValue = instance.AddMonths(time, months)

public override DateTime AddMonths (
    DateTime time,
    int months
)

C++

public:
virtual DateTime AddMonths (
    DateTime time, 
    int months
) override

public DateTime AddMonths (
    DateTime time, 
    int months
)

JScript

public override function AddMonths (
    time : DateTime, 
    months : int
) : DateTime

パラメータ

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

months: 加算する月の数。

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

例外

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

例外の種類

条件

ArgumentException

結果が DateTime オブジェクトでサポートされている範囲外の値です。

ArgumentOutOfRangeException

months が -120000 未満か、120000 よりも大きい値です。

または

time が MinSupportedDateTime より小さい値か、MaxSupportedDateTime より大きい値です。

解説

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