DateTime 減算演算子 (DateTime, TimeSpan)

指定した日付と時刻から指定した時間間隔を減算して、新しい日付と時刻を作成します。

returnValue = DateTime.op_Subtraction(d, t)
[C#]
public static DateTime operator -(DateTimed,TimeSpant);
[C++]
public: static DateTime op_Subtraction(DateTimed,TimeSpant);
[JScript]
returnValue = d - t;

[Visual Basic] Visual Basic では、この型で定義されている演算子を使用することができます。ただし、独自に定義することはできません。Subtract メソッドを DateTime 減算演算子の代わりに使用することができます。

[JScript] JScript では、この型で定義されている演算子を使用することができます。ただし、独自に定義することはできません。

引数 [Visual Basic, JScript]

• d
  DateTime 。
• t
  TimeSpan 。

パラメータ [C#, C++]

• d
  DateTime 。
• t
  TimeSpan 。

戻り値

DateTime は、 d の値から t の値を減算した値です。

解説

このメソッドは、 d のタイマ刻み値から t のタイマ刻み値を減算します。

使用例

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

 
Dim date1 As New System.DateTime(1996, 6, 3, 22, 15, 0)
Dim date2 As New System.DateTime(1996, 12, 6, 13, 2, 0)
Dim date3 As New System.DateTime(1996, 10, 12, 8, 42, 0)

Dim diff1 As System.TimeSpan
' diff1 gets 185 days, 14 hours, and 47 minutes.
diff1 = date2.Subtract(date1)

Dim date4 As System.DateTime
' date4 gets 4/9/1996 5:55:00 PM.
date4 = date3.Subtract(diff1)

Dim diff2 As System.TimeSpan
' diff2 gets 55 days 4 hours and 20 minutes.
diff2 = System.DateTime.op_Subtraction(date2, date3)

Dim date5 As System.DateTime
' date5 gets 4/9/1996 5:55:00 PM.
date5 = System.DateTime.op_Subtraction(date1, diff2)

[C#] 
System.DateTime date1 = new System.DateTime(1996, 6, 3, 22, 15, 0);
System.DateTime date2 = new System.DateTime(1996, 12, 6, 13, 2, 0);
System.DateTime date3 = new System.DateTime(1996, 10, 12, 8, 42, 0);

// diff1 gets 185 days, 14 hours, and 47 minutes.
System.TimeSpan diff1 = date2.Subtract(date1);

// date4 gets 4/9/1996 5:55:00 PM.
System.DateTime date4 = date3.Subtract(diff1);

// diff2 gets 55 days 4 hours and 20 minutes.
System.TimeSpan diff2 = date2 - date3;

// date5 gets 4/9/1996 5:55:00 PM.
System.DateTime date5 = date1 - diff2;

[C++] 
System::DateTime date1 = System::DateTime(1996, 6, 3, 22, 15, 0);
System::DateTime date2 = System::DateTime(1996, 12, 6, 13, 2, 0);
System::DateTime date3 = System::DateTime(1996, 10, 12, 8, 42, 0);

// diff1 gets 185 days, 14 hours, and 47 minutes.
System::TimeSpan diff1 = date2.Subtract(date1);

// date4 gets 4/9/1996 5:55:00 PM.
System::DateTime date4 = date3.Subtract(diff1);

// diff2 gets 55 days 4 hours and 20 minutes.
System::TimeSpan diff2 = date2 - date3;

// date5 gets 4/9/1996 5:55:00 PM.
System::DateTime date5 = date1 - diff2;

[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 名前空間 | DateTime 減算演算子 オーバーロードの一覧 | Ticks | TimeSpan