次の方法で共有


DateTime.AddDays メソッド

このインスタンスの値に、指定した日数を加算します。

Public Function AddDays( _
   ByVal value As Double _) As DateTime
[C#]
public DateTime AddDays(doublevalue);
[C++]
public: DateTime AddDays(doublevalue);
[JScript]
public function AddDays(
   value : double) : DateTime;

パラメータ

  • value
    整数部と小数部から成る日数。value パラメータは、正または負のどちらの場合もあります。

戻り値

このインスタンスで表された日付と時刻に value で表された日数を加算した値である DateTime

例外

例外の種類 条件
ArgumentOutOfRangeException 結果として得られる DateTimeMinValue より小さい値か、 MaxValue より大きい値です。

解説

このメソッドは、 DateTime の値を変更しません。代わりに、この操作の結果を示す値を持つ新しい DateTime が返されます。

value の小数部は 1 日の端数を表します。たとえば、4.5 は 4 日と、12 時間 0 分 0 秒 0 ミリ秒 0 タイマ刻みに相当します。

value パラメータは、近似値のタイマ刻みに丸められます。

使用例

[Visual Basic, C#, C++] AddDays メソッドを次のサンプルで示します。

 
' Calculate what day of the week is 36 days from this instant.
Dim today As System.DateTime
Dim answer As System.DateTime

today = System.DateTime.Now
answer = today.AddDays(36)

System.Console.WriteLine("{0:dddd}", answer)

[C#] 
// Calculate what day of the week is 36 days from this instant.
System.DateTime today = System.DateTime.Now;
System.DateTime answer = today.AddDays(36);
System.Console.WriteLine("{0:dddd}", answer);

[C++] 
// Calculate what day of the week is 36 days from this instant.
System::DateTime today = System::DateTime::Now;
System::DateTime answer = today.AddDays(36);
System::Console::WriteLine(S"{0:dddd}", __box(answer));

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

DateTime 構造体 | DateTime メンバ | System 名前空間 | Double