다음을 통해 공유


DateTime.Add(TimeSpan) 메서드

정의

지정된 DateTime의 값을 이 인스턴스의 값에 더하는 새 TimeSpan을 반환합니다.

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

매개 변수

value
TimeSpan

양수 또는 음수의 시간 간격입니다.

반환

이 인스턴스가 나타내는 날짜 및 시간과 value가 나타내는 시간 간격의 합이 값인 개체입니다.

예외

결과는 DateTimeDateTime.MinValue 보다 작거나 DateTime.MaxValue보다 큽니다.

예제

다음 예제는 Add 메서드. 이 시점부터 36일(864시간)인 요일을 계산합니다.

// 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.
let today = DateTime.Now
let duration = TimeSpan(36, 0, 0, 0)
let answer = today.Add duration
printfn $"{answer:dddd}"
// 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 사용하여 단일 작업에서 둘 이상의 시간 간격(일, 시간, 분, 초 또는 밀리초)을 추가할 수 있습니다. 이 메서드의 동작은 더하기 연산자의 동작과 동일합니다. 또한 구조는 DateTime 각 시간 간격에 대해 특수 추가 메서드(예: AddDays, AddHoursAddMinutes)를 지원합니다.

메서드는 Add 윤년 및 날짜 산술 연산을 수행할 때 한 달의 일 수를 고려합니다.

이 메서드는 이 DateTime의 값을 변경하지 않습니다. 대신 값이 이 작업의 결과인 새 DateTime 를 반환합니다. KindDateTime instance 속성은 현재 instance 속성과 동일합니다.

적용 대상

추가 정보