정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

DateTime.Add 메서드

2013-12-13

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

Namespace:  System
어셈블리:  mscorlib(mscorlib.dll)

public DateTime Add(
	TimeSpan value
)

매개 변수

value
형식: System.TimeSpan
더할 시간 간격입니다. 이 값은 양수 또는 음수가 될 수 있습니다.

반환 값

형식: System.DateTime
이 인스턴스가 나타내는 날짜 및 시간과 value가 나타내는 시간 간격의 합을 값으로 갖는 개체입니다.

예외조건
ArgumentOutOfRangeException

결과 DateTimeDateTime.MinValue 이전이거나 DateTime.MaxValue 이후인 경우

Add 메서드를 사용하면 여러 종류의 시간 간격(일, 시, 분, 초 또는 밀리초)을 한 번의 작업으로 더할 수 있습니다. 이 메서드의 동작은 더하기 연산자의 동작과 같습니다. DateTime 구조체는 각 시간 간격에 대해 특수화된 AddDays, AddHoursAddMinutes 등의 더하기 메서드도 지원합니다.

Add 메서드는 윤년 및 각 달의 날짜 수를 고려하여 날짜를 계산합니다.

이 메서드는 이 DateTime의 값을 변경하지 않습니다. 대신 이 연산의 결과 값을 갖는 새로운 DateTime이 반환됩니다. 새 DateTime 인스턴스의 Kind 속성은 현재 인스턴스의 해당 속성과 같습니다.

다음 예제에서는 Add 메서드를 보여 줍니다. 이 메서드는 현재부터 36일(864시간)의 요일을 계산합니다.


// 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);
outputBlock.Text += String.Format("{0:dddd}", answer) + "\n";


Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

표시: