DateTime.Subtract DateTime.Subtract DateTime.Subtract DateTime.Subtract Method

定義

このインスタンスから指定した時刻または存続時間を減算します。Subtracts the specified time or duration from this instance.

オーバーロード

Subtract(DateTime) Subtract(DateTime) Subtract(DateTime) Subtract(DateTime)

このインスタンスから指定した日付と時刻を減算します。Subtracts the specified date and time from this instance.

Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan)

このインスタンスから指定した期間を減算します。Subtracts the specified duration from this instance.

Subtract(DateTime) Subtract(DateTime) Subtract(DateTime) Subtract(DateTime)

このインスタンスから指定した日付と時刻を減算します。Subtracts the specified date and time from this instance.

public:
 TimeSpan Subtract(DateTime value);
public TimeSpan Subtract (DateTime value);
member this.Subtract : DateTime -> TimeSpan
Public Function Subtract (value As DateTime) As TimeSpan

パラメーター

value
DateTime DateTime DateTime DateTime

減算する日付と時刻の値。The date and time value to subtract.

戻り値

このインスタンスで表された日付と時刻から value で表された日付と時刻を減算した値と等しい時間間隔。A time interval that is equal to the date and time represented by this instance minus the date and time represented by value.

例外

結果が MinValue より小さいか、MaxValue より大きいです。The result is less than MinValue or greater than MaxValue.

次の例で、Subtractメソッドと減算演算子。The following example demonstrates the Subtract method and the subtraction operator.

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;
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;
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)

注釈

Subtract(DateTime)メソッドは、2 つの日付間の差を求めます。The Subtract(DateTime) method determines the difference between two dates. 現在のインスタンスからの時間間隔を減算する呼び出し、Subtract(TimeSpan)メソッド。To subtract a time interval from the current instance, call the Subtract(TimeSpan) method. 現在のインスタンスから特定の時間間隔を減算するには、その時間間隔を現在の日付に追加するメソッドを呼び出し、メソッドの引数として負の値を指定します。To subtract a particular time interval from the current instance, call the method that adds that time interval to the current date, and supply a negative value as the method argument. たとえば、現在の日付から 2 か月間、減算を呼び出す、 AddMonths(Int32) -2 の値を持つメソッド。For example, to subtract two months from the current date, call the AddMonths(Int32) method with a value of -2.

かどうか、現在のインスタンスの日時により前はvalue、メソッドを返します、TimeSpan負の時間範囲を表すオブジェクト。If the date and time of the current instance is earlier than value, the method returns a TimeSpan object that represents a negative time span. すべての 0 以外のプロパティの値である、(などDaysまたはTicks) が負の値。That is, the value of all of its non-zero properties (such as Days or Ticks) is negative.

Subtract(DateTime)メソッドがの値を考慮していない、 Kind 、2 つのプロパティDateTime減算を実行するときの値します。The Subtract(DateTime) method does not consider the value of the Kind property of the two DateTime values when performing the subtraction. 減算する前にDateTimeオブジェクト、オブジェクトが同じタイム ゾーンで時刻を表すことを確認します。Before subtracting DateTime objects, ensure that the objects represent times in the same time zone. それ以外の場合、結果は、タイム ゾーン間の差が含まれます。Otherwise, the result will include the difference between time zones.

注意

DateTimeOffset.Subtract(DateTimeOffset)メソッドは、減算を実行するときに、タイム ゾーン間で相違点を考慮します。The DateTimeOffset.Subtract(DateTimeOffset) method does consider the difference between time zones when performing the subtraction.

こちらもご覧ください

Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan)

このインスタンスから指定した期間を減算します。Subtracts the specified duration from this instance.

public:
 DateTime Subtract(TimeSpan value);
public DateTime Subtract (TimeSpan value);
member this.Subtract : TimeSpan -> DateTime
Public Function Subtract (value As TimeSpan) As DateTime

パラメーター

value
TimeSpan TimeSpan TimeSpan TimeSpan

減算する時間間隔。The time interval to subtract.

戻り値

このインスタンスで表された日付と時刻から value で表された時間間隔を減算した値と等しいオブジェクト。An object that is equal to the date and time represented by this instance minus the time interval represented by value.

例外

結果が MinValue より小さいか、MaxValue より大きいです。The result is less than MinValue or greater than MaxValue.

次の例で、Subtractメソッドと減算演算子。The following example demonstrates the Subtract method and the subtraction operator.

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;
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;
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)

注釈

Subtract(TimeSpan)メソッドは、現在のインスタンスから指定した時間間隔の違いは、日付を返します。The Subtract(TimeSpan) method returns the date that is a specified time interval difference from the current instance. 2 つの日付間の時間間隔を確認するのには、呼び出し、Subtract(DateTime)メソッド。To determine the time interval between two dates, call the Subtract(DateTime) method. 現在のインスタンスから特定の時間間隔を減算するには、その時間間隔を現在の日付に追加するメソッドを呼び出し、メソッドの引数として負の値を指定します。To subtract a particular time interval from the current instance, call the method that adds that time interval to the current date, and supply a negative value as the method argument. たとえば、現在の日付から 2 か月間、減算を呼び出す、 AddMonths(Int32) -2 の値を持つメソッド。For example, to subtract two months from the current date, call the AddMonths(Int32) method with a value of -2.

このメソッドには、この値は変わりません。DateTimeします。This method does not change the value of this DateTime. 代わりに、新しい返しますDateTime値がこの操作の結果。Instead, it returns a new DateTime whose value is the result of this operation.

通常、DateTime.Subtract(TimeSpan)メソッドは減算、TimeSpanオブジェクトを表す正の時間間隔を返す、DateTimeが現在のインスタンスの日時より前の値。Ordinarily, the DateTime.Subtract(TimeSpan) method subtracts a TimeSpan object that represents a positive time span and returns a DateTime value that is earlier than the date and time of the current instance. ただし場合、TimeSpanオブジェクトは、負の時間範囲を表します、DateTime.Subtract(TimeSpan)メソッドを返します。 をDateTime値が現在のインスタンスの日時より後です。However, if the TimeSpan object represents a negative time span, the DateTime.Subtract(TimeSpan) method returns a DateTime value that is later than the date and time of the current instance.

DateTime.Subtract(TimeSpan)メソッドでは、時間 (時間の指定した数) と指定された数 (分) などの 1 つ以上の単位で構成される時間間隔を減算できます。The DateTime.Subtract(TimeSpan) method allows you to subtract a time interval that consists of more than one unit of time (such as a given number of hours and a given number of minutes). 1 つの単位 (年、月、日など) の時間を減算する、DateTimeインスタンス、渡せる負の数値の値をパラメーターとして、次のメソッドのいずれかに。To subtract a single unit of time (such as years, months, or days) from the DateTime instance, you can pass a negative numeric value as a parameter to any of the following methods:

  • AddYears、特定の年現在の日付と時刻のインスタンスから数を減算します。AddYears, to subtract a specific number of years from the current date and time instance.

  • AddMonths、特定の数か月間、現在の日付と時刻のインスタンスからの減算をします。AddMonths, to subtract a specific number of months from the current date and time instance.

  • AddDays、特定の数、現在の日付と時刻のインスタンスからの日数を減算します。AddDays, to subtract a specific number of days from the current date and time instance.

  • AddHours、特定の現在の日付と時刻のインスタンスからの時間数を減算します。AddHours, to subtract a specific number of hours from the current date and time instance.

  • AddMinutes、特定の数の現在の日付と時刻のインスタンスから分を減算します。AddMinutes, to subtract a specific number of minutes from the current date and time instance.

  • AddSeconds、特定の現在の日付と時刻のインスタンスからの秒数を減算します。AddSeconds, to subtract a specific number of seconds from the current date and time instance.

  • AddMilliseconds、特定の現在の日付と時刻のインスタンスからのミリ秒数を減算します。AddMilliseconds, to subtract a specific number of milliseconds from the current date and time instance.

  • AddTicks、特定の現在の日付と時刻のインスタンスからのティック数を減算します。AddTicks, to subtract a specific number of ticks from the current date and time instance.

こちらもご覧ください

適用対象