DateTime.Add メソッド

  • [アーティクル]

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

Public Function Add( _
   ByVal value As TimeSpan _) As DateTime
[C#]
public DateTime Add(TimeSpanvalue);
[C++]
public: DateTime Add(TimeSpanvalue);
[JScript]
public function Add(
   value : TimeSpan) : DateTime;

パラメータ

  • value
    加算する間隔を格納する TimeSpan 。

戻り値

このインスタンスで表された日付と時刻に value で表された時間間隔を加算した値を示す DateTime 。

例外

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

解説

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

使用例

[Visual Basic, C#, C++] Add メソッドを次のサンプルで示します。ここでは、現時点から 36 日 (864 時間) 後の曜日を計算します。

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

today = System.DateTime.Now
duration = New System.TimeSpan(36, 0, 0, 0)
answer = today.Add(duration)

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.TimeSpan duration = new System.TimeSpan(36, 0, 0, 0);
System.DateTime answer = today.Add(duration);
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::TimeSpan duration(36, 0, 0, 0);
System::DateTime answer = today.Add(duration);
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 名前空間 | TimeSpan | TimeSpan.Add