DateTime.Subtraction Operator

定義

名前空間:

System

アセンブリ:

netstandard.dll, System.Runtime.dll

指定した DateTime から指定した DateTime または TimeSpan を減算します。

オーバーロード

Subtraction(DateTime, DateTime)	指定した日付と時刻から指定したもう 1 つの日付と時刻を減算して、時間間隔を返します。
Subtraction(DateTime, TimeSpan)	指定した日付と時刻から指定した時間間隔を減算して、新しい日付と時刻を返します。

Subtraction(DateTime, DateTime)

ソース:

DateTime.cs

指定した日付と時刻から指定したもう 1 つの日付と時刻を減算して、時間間隔を返します。

C#

public static TimeSpan operator -(DateTime d1, DateTime d2);

パラメーター

d1

DateTime

減算対象の日付および時刻の値 (被減数)。

d2

DateTime

減算する日付および時刻の値 (減数)。

戻り値

TimeSpan

d1 と d2 の間の時間間隔、つまり d1 から d2 を引いた値です。

例

次の例では、 Subtract メソッドと減算演算子を示します。

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;

注釈

メソッドでは Subtraction(DateTime, DateTime) 、減算を Kind 実行するときに、2 つの DateTime 値の プロパティの値は考慮されません。 オブジェクトを減算する DateTime 前に、オブジェクトが同じタイム ゾーンの時刻を表していることを確認します。 それ以外の場合、結果にはタイム ゾーン間の差が含まれます。

注意

メソッドは DateTimeOffset.Subtraction(DateTimeOffset, DateTimeOffset) 、減算を実行するときにタイム ゾーン間の違いを考慮します。

この演算子の同等のメソッドは 次のようになります。 DateTime.Subtract(DateTime)

こちらもご覧ください

• Subtract(DateTime)
• Ticks
• 日付と時刻を使用した算術演算の実行

Subtraction(DateTime, TimeSpan)

ソース:

DateTime.cs

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

C#

public static DateTime operator -(DateTime d, TimeSpan t);

パラメーター

d

DateTime

減算される日時の値。

t

TimeSpan

減算する時間間隔。

戻り値

DateTime

d の値から t の値を減算した値を保持するオブジェクト。

例外

ArgumentOutOfRangeException

結果 DateTime が DateTime.MinValue より小さいか、 DateTime.MaxValue より大きくなります。

例

次の例では、 Subtract メソッドと減算演算子を示します。

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;

注釈

このメソッドは、 のティック値 t を のティック値 dから減算します。

この演算子の同等のメソッドは 次のようになります。 DateTime.Subtract(DateTime)

こちらもご覧ください

• Subtract(TimeSpan)
• Ticks
• TimeSpan
• 日付と時刻を使用した算術演算の実行