DateTime.Add(TimeSpan) Method


지정된 DateTime의 값을 이 인스턴스의 값에 더하는 새 TimeSpan을 반환합니다.Returns a new DateTime that adds the value of the specified TimeSpan to the value of this instance.

 DateTime Add(TimeSpan value);
public DateTime Add (TimeSpan value);
member this.Add : TimeSpan -> DateTime
Public Function Add (value As TimeSpan) As DateTime



양수 또는 음수의 시간 간격입니다.A positive or negative time interval.



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


결과는 DateTimeMinValue보다 작거나 MaxValue보다 큽니다.The resulting DateTime is less than MinValue or greater than MaxValue.


다음 예제는 Add 메서드.The following example demonstrates the Add method. 이 순간부터 36 일 (864 시간)는 요일을 계산 합니다.It calculates the day of the week that is 36 days (864 hours) from this moment.

// Calculate what day of the week is 36 days from this instant.
System::DateTime today = System::DateTime::Now;
System::TimeSpan duration( 36, 0, 0, 0 );
System::DateTime answer = today.Add( duration );
System::Console::WriteLine( " {0:dddd}", answer );
// Calculate what day of the week is 36 days from this instant.
System.DateTime today = System.DateTime.Now;
System.TimeSpan duration = new System.TimeSpan(36, 0, 0, 0);
System.DateTime answer = today.Add(duration);
System.Console.WriteLine("{0:dddd}", answer);
' Calculate what day of the week is 36 days from this instant.
Dim today As System.DateTime
Dim duration As System.TimeSpan
Dim answer As System.DateTime

today = System.DateTime.Now
duration = New System.TimeSpan(36, 0, 0, 0)
answer = today.Add(duration)

System.Console.WriteLine("{0:dddd}", answer)


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 that of the addition operator. DateTime 구조는 각 시간 간격에 대 한 특수 한 추가 메서드 (예: AddDays, AddHours, AddMinutes)도 지원 합니다.The DateTime structure also supports specialized addition methods (such as AddDays, AddHours, and AddMinutes) for each time interval.

Add 메서드는 날짜 산술 연산을 수행할 때 윤년 및 월의 일 수를 고려 합니다.The Add method takes into account leap years and the number of days in a month when performing date arithmetic.

이 메서드는이 DateTime의 값을 변경 하지 않습니다.This method does not change the value of this DateTime. 대신이 작업의 결과인 값을 가진 새 DateTime을 반환 합니다.Instead, it returns a new DateTime whose value is the result of this operation. DateTime 인스턴스의 Kind 속성이 현재 인스턴스와 동일 합니다.The Kind property of the new DateTime instance is the same as that of the current instance.

Applies to

See also