DateTimeOffset.Add(TimeSpan) 메서드

정의

지정된 시간 간격을 이 인스턴스의 값에 추가하는 새 DateTimeOffset 개체를 반환합니다.Returns a new DateTimeOffset object that adds a specified time interval to the value of this instance.

public:
 DateTimeOffset Add(TimeSpan timeSpan);
public DateTimeOffset Add (TimeSpan timeSpan);
member this.Add : TimeSpan -> DateTimeOffset

매개 변수

timeSpan
TimeSpan

양수 또는 음수 시간 간격을 나타내는 TimeSpan 개체입니다.A TimeSpan object that represents a positive or a negative time interval.

반환

값이 현재 DateTimeOffset 개체가 나타내는 날짜 및 시간과 timeSpan이 나타내는 시간 간격의 합인 개체입니다.An object whose value is the sum of the date and time represented by the current DateTimeOffset object and the time interval represented by timeSpan.

예외

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

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

예제

다음 예제에서는 대상 간의 비행 시간을 나타내는 TimeSpan 개체의 배열을 만듭니다.The following example creates an array of TimeSpan objects that represent the flight times between destinations. 그런 다음 Add 메서드는 항공편의 초기 takeoff 시간을 나타내는 DateTimeOffset 개체에 이러한 시간을 추가 합니다.The Add method then adds these times to a DateTimeOffset object that represents a flight's initial takeoff time. 결과 각 대상에 예약 된 도착 시간을 반영합니다.The result reflects the scheduled arrival time at each destination.

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);
}
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 메서드를 사용 하 여 단일 작업에서 두 가지 유형의 시간 간격 (일, 시간, 분, 초 또는 밀리초)을 추가할 수 있습니다.You can use the Add method to add more than one kind of time interval (days, hours, minutes, seconds, or milliseconds) in a single operation. 이 메서드의 동작은 더하기 연산자와 동일 합니다.This method's behavior is identical to the addition operator. DateTimeOffset 구조는 각 시간 간격에 대 한 특수 한 추가 메서드 (예: AddDays, AddHours, AddMinutes)도 지원 합니다.The DateTimeOffset structure also supports specialized addition methods (such as AddDays, AddHours, and AddMinutes) for each time interval.

참고

이 메서드는 새 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.

Add 메서드는 현재 DateTimeOffset 개체의 Offset 속성 값에 영향을 주지 않습니다.The Add method does not affect the value of the current DateTimeOffset object's Offset property.

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

timeSpan 매개 변수가 null인 경우이 메서드는 원래 DateTimeOffset 개체의 값을 변경 하지 않고 반환 합니다.If the timeSpan parameter is null, this method returns the value of the original DateTimeOffset object unchanged.

적용 대상

추가 정보