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

定義

このインスタンスの値から指定した時刻または期間を減算した、新しい DateTime を返します。Returns a new DateTime that subtracts the specified time or duration from the value of this instance.

オーバーロード

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

このインスタンスの値から指定した日時を減算した、新しい DateTime を返します。Returns a new DateTime that subtracts the specified date and time from the value of this instance.

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

このインスタンスの値から指定した期間を減算した、新しい DateTime を返します。Returns a new DateTime that subtracts the specified duration from the value of this instance.

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

このインスタンスの値から指定した日時を減算した、新しい DateTime を返します。Returns a new DateTime that subtracts the specified date and time from the value of 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以外のすべてのプロパティ ( DaysTicksなど) の値は負になります。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)

このインスタンスの値から指定した期間を減算した、新しい DateTime を返します。Returns a new DateTime that subtracts the specified duration from the value of 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)は、正TimeSpanDateTime時間範囲を表すオブジェクトを減算し、現在のインスタンスの日付と時刻よりも前の値を返します。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)メソッドを使用すると、複数の時間単位 (時間数や指定された分数など) で構成される時間間隔を減算できます。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). DateTimeインスタンスから1つの時間単位 (年、月、日など) を減算するには、次のいずれかのメソッドにパラメーターとして負の数値を渡すことができます。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.

こちらもご覧ください

適用対象