다음을 통해 공유


DateTime.AddDays(Double) 메서드

정의

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

public:
 DateTime AddDays(double value);
public DateTime AddDays (double value);
member this.AddDays : double -> DateTime
Public Function AddDays (value As Double) As DateTime

매개 변수

value
Double

정수 및 소수로 계산된 날 수입니다. value 매개 변수는 음수일 수도 있고 양수일 수도 있습니다.

반환

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

예외

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

예제

다음 예제에서는 메서드를 AddDays 사용하여 현재 날짜 이후 36일의 요일을 확인합니다.

using namespace System;

int main()
{
   // Calculate what day of the week is 36 days from this instant.
   DateTime today = System::DateTime::Now;
   DateTime answer = today.AddDays( 36 );
   Console::WriteLine("Today: {0:dddd}", today);
   Console::WriteLine("36 days from today: {0:dddd}", answer);
}
// The example displays output like the following:
//       Today: Wednesday
//       36 days from today: Thursday
open System

let today = DateTime.Now
let answer = today.AddDays 36
printfn $"Today: {today:dddd}"
printfn $"36 days from today: {answer:dddd}"


// The example displays output like the following:
//       Today: Wednesday
//       36 days from today: Thursday
using System;

class Class1
{
    static void Main()
    {
        DateTime today = DateTime.Now;
        DateTime answer = today.AddDays(36);
        Console.WriteLine("Today: {0:dddd}", today);
        Console.WriteLine("36 days from today: {0:dddd}", answer);
    }
}
// The example displays output like the following:
//       Today: Wednesday
//       36 days from today: Thursday
Class Class1
   Public Shared Sub Main()
      Dim today As System.DateTime
      Dim answer As System.DateTime

      today = System.DateTime.Now
      answer = today.AddDays(36)

      Console.WriteLine("Today: {0:dddd}", today)
      Console.WriteLine("36 days from today: {0:dddd}", answer)
   End Sub
End Class
' The example displays output like the following:
'       Today: Wednesday
'       36 days from today: Thursday

설명

이 메서드는 이 DateTime의 값을 변경하지 않습니다. 대신 값이 이 작업의 결과인 새 DateTime 를 반환합니다.

value 소수 부분은 하루의 소수 부분입니다. 예를 들어 4.5는 4일, 12시간, 0분, 0초, 0밀리초 및 0틱과 같습니다.

.NET 6 이전 버전 value 에서는 매개 변수가 가장 가까운 밀리초로 반올림됩니다. .NET 7 이상 버전에서는 매개 변수의 전체 Double 전체 자릿수가 value 사용됩니다. 그러나 부동 소수점 수학의 내재된 부정확성으로 인해 결과 정밀도는 달라집니다.

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

적용 대상

추가 정보