DateTime.Subtract 메서드

정의

이 인스턴스의 값에서 지정된 시간이나 기간을 뺀 새 DateTime을 반환합니다.Returns a new DateTime that subtracts the specified time or duration from the value of this instance.

오버로드

Subtract(DateTime)

이 인스턴스의 값에서 지정된 날짜와 시간을 뺀 새 DateTime을 반환합니다.Returns a new DateTime that subtracts the specified date and time from the value of this instance.

Subtract(TimeSpan)

이 인스턴스의 값에서 지정된 기간을 뺀 새 DateTime을 반환합니다.Returns a new DateTime that subtracts the specified duration from the value of this instance.

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

뺄 날짜 및 시간 값입니다.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) 메서드는 두 날짜 간의 차이를 확인 합니다.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 개월을 빼려는 경우 값이-2 인 AddMonths(Int32) 메서드를 호출 합니다.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) 메서드는 뺄셈을 수행할 때 두 DateTime 값의 Kind 속성 값을 고려 하지 않습니다.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)

이 인스턴스의 값에서 지정된 기간을 뺀 새 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

뺄 시간 간격입니다.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. 두 날짜 사이의 시간 간격을 확인 하려면 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 개월을 빼려는 경우 값이-2 인 AddMonths(Int32) 메서드를 호출 합니다.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) 메서드를 사용 하면 둘 이상의 시간 단위 (예: 지정 된 시간 수 및 지정 된 시간 (분))로 구성 된 시간 간격을 뺄 수 있습니다.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 인스턴스에서 단일 시간 단위 (예: 년, 월 또는 일)를 빼려는 경우 다음 방법 중 하나에 음수 숫자 값을 매개 변수로 전달할 수 있습니다.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.

추가 정보

적용 대상