DateTimeOffset.Subtract 메서드

정의

현재 DateTimeOffset 개체에서 지정된 시간이나 기간을 뺍니다.Subtracts a specified time or duration from the current DateTimeOffset object.

오버로드

Subtract(DateTimeOffset)

특정 날짜와 시간을 나타내는 DateTimeOffset 값을 현재 DateTimeOffset 개체에서 뺍니다.Subtracts a DateTimeOffset value that represents a specific date and time from the current DateTimeOffset object.

Subtract(TimeSpan)

현재 DateTimeOffset 개체에서 지정된 시간 간격을 뺍니다.Subtracts a specified time interval from the current DateTimeOffset object.

Subtract(DateTimeOffset)

특정 날짜와 시간을 나타내는 DateTimeOffset 값을 현재 DateTimeOffset 개체에서 뺍니다.Subtracts a DateTimeOffset value that represents a specific date and time from the current DateTimeOffset object.

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

매개 변수

value
DateTimeOffset

뺄 값을 나타내는 개체입니다.An object that represents the value to subtract.

반환

DateTimeOffset 개체 사이의 간격을 지정하는 개체입니다.An object that specifies the interval between the two DateTimeOffset objects.

예제

다음 예제에서는 Subtract(DateTimeOffset) 메서드를 사용 하는 뺄셈을 보여 줍니다.The following example illustrates subtraction that uses the Subtract(DateTimeOffset) method.

DateTimeOffset firstDate = new DateTimeOffset(2018, 10, 25, 18, 0, 0, 
                                              new TimeSpan(-7, 0, 0));
DateTimeOffset secondDate = new DateTimeOffset(2018, 10, 25, 18, 0, 0, 
                                               new TimeSpan(-5, 0, 0));
DateTimeOffset thirdDate = new DateTimeOffset(2018, 9, 28, 9, 0, 0, 
                                              new TimeSpan(-7, 0, 0));
TimeSpan difference;

difference = firstDate.Subtract(secondDate);
Console.WriteLine($"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}");

difference = firstDate.Subtract(thirdDate);
Console.WriteLine($"({firstDate}) - ({thirdDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}");

// The example produces the following output:
//    (10/25/2018 6:00:00 PM -07:00) - (10/25/2018 6:00:00 PM -05:00): 0 days, 2:00
//    (10/25/2018 6:00:00 PM -07:00) - (9/28/2018 9:00:00 AM -07:00): 27 days, 9:00
Dim firstDate As New DateTimeOffset(#10/25/2018 6:00PM#, _
                                    New TimeSpan(-7, 0, 0))
Dim secondDate As New DateTimeOffset(#10/25/2018 6:00PM#, _
                                     New TimeSpan(-5, 0, 0))
Dim thirdDate As New DateTimeOffset(#9/28/2018 9:00AM#, _
                                    New TimeSpan(-7, 0, 0))
Dim difference As TimeSpan

difference = firstDate.Subtract(secondDate)
Console.WriteLine($"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}")

difference = firstDate.Subtract(thirdDate)
Console.WriteLine($"({firstDate}) - ({thirdDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}")

' The example produces the following output:
'    (10/25/2018 6:00:00 PM -07:00) - (10/25/2018 6:00:00 PM -05:00): 0 days, 2:00
'    (10/25/2018 6:00:00 PM -07:00) - (9/28/2018 9:00:00 AM -07:00): 27 days, 9:00

설명

이 메서드는 두 개체를 구분 하는 시간 간격을 계산 하기 전에 두 DateTimeOffset 개체를 UTC (협정 세계시)로 변환 합니다.This method converts both DateTimeOffset objects to Coordinated Universal Time (UTC) before calculating the time interval that separates them. 이 비교에 서로 다른 UTC 오프셋 수 있는 영향을 주지를 제거 합니다.This removes any effect that different offsets from UTC may have on the comparison.

참고

사용자 지정 연산자를 지 원하는 언어에 대 한 빼기 연산자를 사용 하 여 날짜 및 시간 뺄셈을 수행할 수 있습니다.For languages that support custom operators, you can also perform date and time subtraction by using the subtraction operator. 자세한 내용은 Subtraction 메서드를 참조 하세요.For details, see the Subtraction method.

현재 DateTimeOffset 개체와 value 매개 변수는 특정 표준 시간대의 날짜 및 시간을 표시 하지 않기 때문에 Subtract(DateTimeOffset) 메서드는 날짜 및 시간을 빼는 경우 특정 표준 시간대의 조정 규칙을 고려 하지 않습니다.Because neither the current DateTimeOffset object nor the value parameter represent the date and time in a specific time zone, the Subtract(DateTimeOffset) method does not consider a particular time zone's adjustment rules when it subtracts dates and times.

추가 정보

Subtract(TimeSpan)

현재 DateTimeOffset 개체에서 지정된 시간 간격을 뺍니다.Subtracts a specified time interval from the current DateTimeOffset object.

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

매개 변수

value
TimeSpan

뺄 시간 간격입니다.The time interval to subtract.

반환

현재 DateTimeOffset 개체에서 value로 표현된 시간 간격을 빼서 나타낸 날짜 및 시간과 같은 개체입니다.An object that is equal to the date and time represented by the current DateTimeOffset object, minus the time interval represented by value.

예외

결과 DateTimeOffset 값이 MinValue보다 작습니다.The resulting DateTimeOffset value is less than MinValue.

또는-or- 결과 DateTimeOffset 값이 MaxValue보다 큽니다.The resulting DateTimeOffset value is greater than MaxValue.

예제

다음 예제에서는 Subtract 메서드를 사용 하는 뺄셈을 보여 줍니다.The following example illustrates subtraction that uses the Subtract method.

DateTimeOffset offsetDate = new DateTimeOffset(2007, 12, 3, 11, 30, 0, 
                               new TimeSpan(-8, 0, 0)); 
TimeSpan duration = new TimeSpan(7, 18, 0, 0);
Console.WriteLine(offsetDate.Subtract(duration).ToString());  // Displays 11/25/2007 5:30:00 PM -08:00
Dim offsetDate As New DateTimeOffset(#12/3/2007 11:30AM#, _
                               New TimeSpan(-8, 0, 0)) 
Dim duration As New TimeSpan(7, 18, 0, 0)
Console.WriteLine(offsetDate.Subtract(duration))    ' Displays 11/25/2007 5:30:00 PM -08:00

설명

단일 작업에서 Subtract 메서드를 사용 하 여 여러 종류의 시간 간격 (일, 시간, 분, 초 또는 밀리초)을 뺄 수 있습니다.You can use the Subtract method to subtract more than one kind of time interval (days, hours, minutes, seconds, or milliseconds) in a single operation. 해당 동작은 빼기 연산자를 정의 하는 Subtraction(DateTimeOffset, TimeSpan) 메서드와 동일 합니다.Its behavior is identical to the Subtraction(DateTimeOffset, TimeSpan) method, which defines the subtraction operator. DateTimeOffset 구조체는 메서드 매개 변수에 음수 값을 할당 하 여 뺄셈을 수행할 수 있도록 하는 특수 더하기 메서드 (예: AddDays, AddHours, AddMinutes)도 지원 합니다.The DateTimeOffset structure also supports specialized addition methods (such as AddDays, AddHours, and AddMinutes) that allow you to perform subtraction by assigning a negative value to the method parameter.

참고

이 메서드는 새 DateTimeOffset 개체를 반환 합니다.This method returns a new DateTimeOffset object. 날짜 및 시간에 timeSpan을 추가 하 여 현재 개체의 값을 수정 하지 않습니다.It does not modify the value of the current object by adding timeSpan to its date and time.

Subtract 메서드는 DateTimeOffset 개체의 Offset 속성 값에 영향을 주지 않습니다.The Subtract method does not affect the value of the DateTimeOffset object's Offset property. 반환 된 DateTimeOffset 개체는 원래 개체와 동일한 오프셋을 갖습니다.The returned DateTimeOffset object has the same offset as the original object.

현재 DateTimeOffset 개체는 특정 표준 시간대의 날짜와 시간을 나타내지 않으므로 Subtract(TimeSpan) 메서드는 뺄셈을 수행할 때 특정 표준 시간대의 조정 규칙을 고려 하지 않습니다.Because the current DateTimeOffset object does not represent the date and time in a specific time zone, the Subtract(TimeSpan) method does not consider a particular time zone's adjustment rules when it performs the subtraction.

추가 정보

적용 대상