내보내기(0) 인쇄
모두 확장
이 문서는 수동으로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오.
번역
원본

DateTime.AddHours 메서드

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

네임스페이스:  System
어셈블리:  mscorlib(mscorlib.dll)

public DateTime AddHours(
	double value
)

매개 변수

value
형식: System.Double
더할 시간 수(정수 부분과 소수 부분)입니다. 이 값은 양수 또는 음수가 될 수 있습니다.

반환 값

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

예외상황
ArgumentOutOfRangeException

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

이 메서드는 이 DateTime의 값을 변경하지 않습니다. 대신 이 연산의 결과 값을 갖는 새로운 DateTime이 반환됩니다. 반환된 DateTime 개체의 Kind 속성은 원래 DateTime 개체의 속성과 같습니다.

value의 소수 부분은 시간의 소수 부분입니다. 예를 들어, 4.5는 4시간, 30분, 0초, 0밀리초 및 0틱을 나타냅니다.

value 매개 변수는 가장 가까운 밀리초로 반올림됩니다.

결과가 무한 순환 소수인 경우 1시간 미만의 시간 간격을 분수로 변환하면 전체 자릿수가 손실될 수 있습니다. 예를 들어 1분은 0.016667시간에 해당합니다. 이로 인해 문제가 발생하는 경우 메서드를 한 번만 호출하여 여러 종류의 시간 간격을 지정할 수 있고 한 시간을 분수로 나누어 시간 간격을 변환할 필요가 없는 Add 메서드를 사용할 수 있습니다.

다음 예제에서는 AddHours 메서드를 사용하여 날짜와 시간에 많은 정수 및 소수 값을 더합니다. 또한 소수 구성 요소가 포함된 값을 메서드에 전달할 경우 발생하는 전체 자릿수 손실을 보여 줍니다.


using System;

public class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      double[] hours = {.08333, .16667, .25, .33333, .5, .66667, 1, 2, 
                        29, 30, 31, 90, 365};
      DateTime dateValue = new DateTime(2009, 3, 1, 12, 0, 0);

      foreach (double hour in hours)
         outputBlock.Text += String.Format("{0} + {1} hour(s) = {2}\n", dateValue, 
                                           hour, dateValue.AddHours(hour));
   }
}
// The example displays the following output on a system whose current
// culture is en-US:
//    3/1/2009 12:00:00 PM + 0.08333 hour(s) = 3/1/2009 12:04:59 PM
//    3/1/2009 12:00:00 PM + 0.16667 hour(s) = 3/1/2009 12:10:00 PM
//    3/1/2009 12:00:00 PM + 0.25 hour(s) = 3/1/2009 12:15:00 PM
//    3/1/2009 12:00:00 PM + 0.33333 hour(s) = 3/1/2009 12:19:59 PM
//    3/1/2009 12:00:00 PM + 0.5 hour(s) = 3/1/2009 12:30:00 PM
//    3/1/2009 12:00:00 PM + 0.66667 hour(s) = 3/1/2009 12:40:00 PM
//    3/1/2009 12:00:00 PM + 1 hour(s) = 3/1/2009 1:00:00 PM
//    3/1/2009 12:00:00 PM + 2 hour(s) = 3/1/2009 2:00:00 PM
//    3/1/2009 12:00:00 PM + 29 hour(s) = 3/2/2009 5:00:00 PM
//    3/1/2009 12:00:00 PM + 30 hour(s) = 3/2/2009 6:00:00 PM
//    3/1/2009 12:00:00 PM + 31 hour(s) = 3/2/2009 7:00:00 PM
//    3/1/2009 12:00:00 PM + 90 hour(s) = 3/5/2009 6:00:00 AM
//    3/1/2009 12:00:00 PM + 365 hour(s) = 3/16/2009 5:00:00 PM


Silverlight

5, 4, 3에서 지원

Windows Phone용 Silverlight

Windows Phone OS 7.1, Windows Phone OS 7.0에서 지원

XNA Framework

Xbox 360, Windows Phone OS 7.0에서 지원

Silverlight에서 지원되는 운영 체제 및 브라우저에 대한 자세한 내용은 지원되는 운영 체제 및 브라우저을 참조하십시오.

커뮤니티 추가 항목

추가
표시:
© 2014 Microsoft