DateTime.AddDays(Double) Method

Definition

지정된 날짜 수를 이 인스턴스의 값에 더하는 새 DateTime을 반환합니다.Returns a new DateTime that adds the specified number of days to the value of this instance.

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

Parameters

value
Double

정수 및 소수로 계산된 날 수입니다.A number of whole and fractional days. value 매개 변수는 음수일 수도 있고 양수일 수도 있습니다.The value parameter can be negative or positive.

Returns

DateTime

이 인스턴스가 나타내는 날짜 및 시간과 value가 나타내는 날 수의 합이 값인 개체입니다.An object whose value is the sum of the date and time represented by this instance and the number of days represented by value.

Exceptions

결과는 DateTimeMinValue보다 작거나 MaxValue보다 큽니다.The resulting DateTime is less than MinValue or greater than MaxValue.

Examples

다음 예에서는 AddDays 메서드를 사용 하 여 현재 날짜에서 36 일 이후의 요일을 확인 합니다.The following example uses the AddDays method to determine the day of the week 36 days after the current date.

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
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

Remarks

이 메서드는이 DateTime의 값을 변경 하지 않습니다.This method does not change the value of this DateTime. 대신이 작업의 결과인 값을 가진 새 DateTime을 반환 합니다.Instead, it returns a new DateTime whose value is the result of this operation.

value의 소수 부분은 일의 소수 부분입니다.The fractional part of value is the fractional part of a day. 예를 들어 4.5는 4 일에 12 시간, 0 분, 0 초, 0 밀리초와, 틱 수가 0에 해당 합니다.For example, 4.5 is equivalent to 4 days, 12 hours, 0 minutes, 0 seconds, 0 milliseconds, and 0 ticks.

value 매개 변수는 가장 가까운 밀리초로 반올림 됩니다.The value parameter is rounded to the nearest millisecond.

AddDays 메서드는 날짜 산술 연산을 수행할 때 윤년 및 월의 일 수를 고려 합니다.The AddDays method takes into account leap years and the number of days in a month when performing date arithmetic.

Applies to

See also