DateTimeOffset.Add(TimeSpan) 메서드

정의

네임스페이스:

System

어셈블리:

netstandard.dll, System.Runtime.dll

Source:

DateTimeOffset.cs

지정된 시간 간격을 이 인스턴스의 값에 추가하는 새 DateTimeOffset 개체를 반환합니다.

public:
 DateTimeOffset Add(TimeSpan timeSpan);

public DateTimeOffset Add(TimeSpan timeSpan);

member this.Add : TimeSpan -> DateTimeOffset

Public Function Add (timeSpan As TimeSpan) As DateTimeOffset

매개 변수

timeSpan

TimeSpan

TimeSpan 양수 또는 음수 시간 간격을 나타내는 개체입니다.

반환

DateTimeOffset

값이 현재 DateTimeOffset 개체가 나타내는 날짜 및 시간의 합계와 나타내는 시간 간격 timeSpan인 개체입니다.

예외

ArgumentOutOfRangeException

결과 DateTimeOffset 값이 DateTimeOffset.MinValue보다 작습니다.

-또는-

결과 DateTimeOffset 값이 DateTimeOffset.MaxValue보다 큽니다.

예제

다음 예제에서는 대상 간의 비행 시간을 나타내는 개체의 TimeSpan 배열을 만듭니다. 그런 다음 이 메서드는 Add 플라이트의 초기 이륙 시간을 나타내는 개체에 이러한 시간을 DateTimeOffset 추가합니다. 결과는 각 목적지의 예약된 도착 시간을 반영합니다.

DateTimeOffset takeOff = new DateTimeOffset(2007, 6, 1, 7, 55, 0,
                             new TimeSpan(-5, 0, 0));
DateTimeOffset currentTime = takeOff;
TimeSpan[] flightTimes = new TimeSpan[]
                  {new TimeSpan(2, 25, 0), new TimeSpan(1, 48, 0)};
Console.WriteLine("Takeoff is scheduled for {0:d} at {0:T}.",
                  takeOff);
for (int ctr = flightTimes.GetLowerBound(0);
     ctr <= flightTimes.GetUpperBound(0); ctr++)
{
   currentTime = currentTime.Add(flightTimes[ctr]);
   Console.WriteLine("Destination #{0} at {1}.", ctr + 1, currentTime);
}

let takeOff = DateTimeOffset(2007, 6, 1, 7, 55, 0, TimeSpan(-5, 0, 0))
let mutable currentTime = takeOff
let flightTimes = [| TimeSpan(2, 25, 0); TimeSpan(1, 48, 0) |]
printfn $"Takeoff is scheduled for {takeOff:d} at {takeOff:T}."
                
for i = 0 to flightTimes.Length - 1 do
    currentTime <- currentTime.Add flightTimes[i]
    printfn $"Destination #{i + 1} at {currentTime}."

Dim takeOff As New DateTimeOffset(#6/1/2007 7:55AM#, _
                                  New TimeSpan(-5, 0, 0))
Dim currentTime As DateTimeOffset = takeOff
Dim flightTimes() As TimeSpan = New TimeSpan() _
                  {New TimeSpan(2, 25, 0), New TimeSpan(1, 48, 0)}
Console.WriteLine("Takeoff is scheduled for {0:d} at {0:T}.", _
                  takeOff)
For ctr As Integer = flightTimes.GetLowerBound(0) To _
                     flightTimes.GetUpperBound(0)
   currentTime = currentTime.Add(flightTimes(ctr))
   Console.WriteLine("Destination #{0} at {1}.", ctr + 1, currentTime)
Next

설명

이 메서드를 Add 사용하여 단일 작업에서 둘 이상의 시간 간격(일, 시간, 분, 초 또는 밀리초)을 추가할 수 있습니다. 이 메서드의 동작은 더하기 연산자와 동일합니다. 또한 이 구조는 DateTimeOffset 각 시간 간격에 대한 특수 추가 메서드(예: AddDays, AddHours및 AddMinutes)를 지원합니다.

메모

이 메서드는 새 DateTimeOffset 개체를 반환합니다. 날짜 및 시간에 추가하여 timeSpan 현재 개체의 값을 수정하지 않습니다.

메서드는 Add 현재 DateTimeOffset 개체 Offset 의 속성 값에 영향을 주지 않습니다.

개체가 DateTimeOffset 특정 표준 시간대 Add 의 날짜 및 시간을 나타내지 않으므로 날짜 및 시간 산술 연산을 수행할 때 메서드는 특정 표준 시간대의 조정 규칙을 고려하지 않습니다.

매개 변수인 timeSpan 경우 이 메서드는 null변경되지 않은 원래 DateTimeOffset 개체의 값을 반환합니다.

추가 정보

• Addition(DateTimeOffset, TimeSpan)
• 날짜 및 시간을 사용하여 산술 연산 수행