다음을 통해 공유


DateTime.Add(TimeSpan) 메서드

정의

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

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.
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 인스턴스의 속성은 현재 인스턴스의 속성과 동일합니다.

적용 대상

추가 정보