다음을 통해 공유


DateTime.Subtract 메서드

정의

이 인스턴스의 값에서 지정된 시간 또는 기간을 뺀 결과 값을 반환합니다.

오버로드

Subtract(TimeSpan)

이 인스턴스의 값에서 지정된 기간을 뺀 새 DateTime을 반환합니다.

Subtract(DateTime)

이 인스턴스의 값에서 지정된 날짜와 시간을 뺀 새 TimeSpan을 반환합니다.

Subtract(TimeSpan)

Source:
DateTime.cs
Source:
DateTime.cs
Source:
DateTime.cs

이 인스턴스의 값에서 지정된 기간을 뺀 새 DateTime을 반환합니다.

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

뺄 시간 간격입니다.

반환

이 인스턴스가 나타내는 날짜와 시간에서 value가 나타내는 시간 간격을 뺀 값에 해당하는 개체입니다.

예외

결과는 DateTime.MinValue 보다 작거나 DateTime.MaxValue보다 큽니다.

예제

다음 예제에서는 메서드 및 빼기 연산자를 보여 Subtract 줍니다.

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;
open System

let date1 = DateTime(1996, 6, 3, 22, 15, 0)
let date2 = DateTime(1996, 12, 6, 13, 2, 0)
let date3 = DateTime(1996, 10, 12, 8, 42, 0)

// diff1 gets 185 days, 14 hours, and 47 minutes.
let diff1 = date2.Subtract date1

// date4 gets 4/9/1996 5:55:00 PM.
let date4 = date3.Subtract diff1

// diff2 gets 55 days 4 hours and 20 minutes.
let diff2 = date2 - date3

// date5 gets 4/9/1996 5:55:00 PM.
let 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) 현재 instance 지정된 시간 간격 차이인 날짜를 반환합니다. 두 날짜 사이의 시간 간격을 확인하려면 메서드를 호출합니다 Subtract(DateTime) . 현재 instance 특정 시간 간격을 빼려면 해당 시간 간격을 현재 날짜에 추가하는 메서드를 호출하고 메서드 인수로 음수 값을 입력합니다. 예를 들어 현재 날짜에서 두 달을 빼려면 값이 AddMonths(Int32) -2인 메서드를 호출합니다.

이 메서드는 이 DateTime의 값을 변경하지 않습니다. 대신 값이 이 작업의 결과인 새 DateTime 를 반환합니다.

일반적으로 메서드는 DateTime.Subtract(TimeSpan) 양수 시간 범위를 나타내는 개체를 빼 TimeSpan 고 현재 instance 날짜 및 시간보다 빠른 값을 반환 DateTime 합니다. 그러나 개체가 음수 TimeSpan 시간 범위를 DateTime.Subtract(TimeSpan) 나타내는 경우 메서드는 현재 instance 날짜 및 시간보다 오래된 값을 반환 DateTime 합니다.

DateTime.Subtract(TimeSpan) 메서드를 사용하면 두 개 이상의 시간 단위(예: 지정된 시간 수 및 지정된 시간 수)로 구성된 시간 간격을 뺍니다. instance 단일 시간 단위(예: 연도, 월 또는 일)DateTime를 빼려면 다음 방법 중 하나로 음수 숫자 값을 매개 변수로 전달할 수 있습니다.

  • AddYears현재 날짜 및 시간 instance 특정 연도 수를 빼려면 입니다.

  • AddMonths을 사용하여 현재 날짜 및 시간 instance 특정 월 수를 뺍니다.

  • AddDays현재 날짜 및 시간 instance 특정 일 수를 빼려면 입니다.

  • AddHours현재 날짜 및 시간 instance 특정 시간을 빼려면 입니다.

  • AddMinutes- 현재 날짜 및 시간 instance 특정 시간(분)을 뺍니다.

  • AddSeconds을 사용하여 현재 날짜 및 시간 instance 특정 시간(초)을 뺍니다.

  • AddMilliseconds을 사용하여 현재 날짜 및 시간 instance 특정 밀리초 수를 뺍니다.

  • AddTicks현재 날짜 및 시간 instance 특정 수의 틱을 빼려면 입니다.

추가 정보

적용 대상

Subtract(DateTime)

Source:
DateTime.cs
Source:
DateTime.cs
Source:
DateTime.cs

이 인스턴스의 값에서 지정된 날짜와 시간을 뺀 새 TimeSpan을 반환합니다.

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

뺄 날짜 및 시간 값입니다.

반환

이 인스턴스가 나타내는 날짜와 시간에서 value가 나타내는 날짜와 시간을 뺀 값에 해당하는 시간 간격입니다.

예외

결과는 DateTime.MinValue 보다 작거나 DateTime.MaxValue보다 큽니다.

예제

다음 예제에서는 메서드 및 빼기 연산자를 보여 Subtract 줍니다.

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;
open System

let date1 = DateTime(1996, 6, 3, 22, 15, 0)
let date2 = DateTime(1996, 12, 6, 13, 2, 0)
let date3 = DateTime(1996, 10, 12, 8, 42, 0)

// diff1 gets 185 days, 14 hours, and 47 minutes.
let diff1 = date2.Subtract date1

// date4 gets 4/9/1996 5:55:00 PM.
let date4 = date3.Subtract diff1

// diff2 gets 55 days 4 hours and 20 minutes.
let diff2 = date2 - date3

// date5 gets 4/9/1996 5:55:00 PM.
let 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) 두 날짜의 차이를 결정합니다. 현재 instance 시간 간격을 빼려면 메서드를 호출합니다Subtract(TimeSpan). 현재 instance 특정 시간 간격을 빼려면 해당 시간 간격을 현재 날짜에 추가하는 메서드를 호출하고 메서드 인수로 음수 값을 입력합니다. 예를 들어 현재 날짜에서 두 달을 빼려면 값이 AddMonths(Int32) -2인 메서드를 호출합니다.

현재 instance 날짜 및 시간이 보다 value이전인 경우 메서드는 음수 시간 범위를 나타내는 개체를 반환 TimeSpan 합니다. 즉, 0이 아닌 모든 속성의 값(예: Days 또는 Ticks)은 음수입니다.

메서드는 Subtract(DateTime) 빼기를 수행할 때 두 DateTime 값의 속성 값을 Kind 고려하지 않습니다. 개체를 빼기 DateTime 전에 개체가 동일한 표준 시간대의 시간을 나타내는지 확인합니다. 그렇지 않으면 결과에 표준 시간대 간의 차이가 포함됩니다.

참고

메서드는 DateTimeOffset.Subtract(DateTimeOffset) 빼기를 수행할 때 표준 시간대 간의 차이를 고려합니다.

추가 정보

적용 대상