다음을 통해 공유


DateTimeOffset.Add(TimeSpan) 메서드

정의

지정된 시간 간격을 이 인스턴스의 값에 추가하는 새 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 개체가 나타내는 날짜 및 시간과 timeSpan이 나타내는 시간 간격의 합인 개체입니다.

예외

결과 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, AddHoursAddMinutes)를 지원합니다.

참고

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

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

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

매개 변수가 timeSpan 이면 이 메서드는 null원래 DateTimeOffset 개체의 값을 변경하지 않고 반환합니다.

적용 대상

추가 정보