영어로 읽기

다음을 통해 공유


DateTime.AddDays(Double) 메서드

정의

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

public DateTime AddDays(double value);

매개 변수

value
Double

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

반환

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

예외

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

예제

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

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

설명

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

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

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

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

적용 대상

제품 버전
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

추가 정보