DateTimeOffset.AddDays(Double) 메서드

정의

정수 및 소수로 계산된 지정된 시간 수를 이 인스턴스의 값에 더하는 새 DateTimeOffset 개체를 반환합니다.Returns a new DateTimeOffset object that adds a specified number of whole and fractional days to the value of this instance.

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

매개 변수

days
Double

정수 및 소수로 계산된 날 수입니다.A number of whole and fractional days. 숫자는 음수가 될 수도 있고 양수가 될 수도 있습니다.The number can be negative or positive.

반환

값이 현재 DateTimeOffset 개체가 나타내는 날짜 및 시간과 days가 나타내는 일 수의 합계인 개체입니다.An object whose value is the sum of the date and time represented by the current DateTimeOffset object and the number of days represented by days.

예외

결과 DateTimeOffset 값이 MinValue보다 작습니다.The resulting DateTimeOffset value is less than MinValue.

-또는--or- 결과 DateTimeOffset 값이 MaxValue보다 큽니다.The resulting DateTimeOffset value is greater than MaxValue.

예제

다음 예에서는 AddDays 메서드를 사용 하 여 3 월 2008 일에 월요일의 시작 날짜를 나열 합니다.The following example uses the AddDays method to list the dates that fall on Monday, the start of the work week, in March 2008.

DateTimeOffset workDay = new DateTimeOffset(2008, 3, 1, 9, 0, 0, 
                   DateTimeOffset.Now.Offset);
int month = workDay.Month;
// Start with the first Monday of the month
if (workDay.DayOfWeek != DayOfWeek.Monday)
{
   if (workDay.DayOfWeek == DayOfWeek.Sunday)
      workDay = workDay.AddDays(1);
   else   
      workDay = workDay.AddDays(8 - (int)workDay.DayOfWeek);
}
Console.WriteLine("Beginning of Work Week In {0:MMMM} {0:yyyy}:", workDay);
// Add one week to the current date 
do    
{
   Console.WriteLine("   {0:dddd}, {0:MMMM}{0: d}", workDay);
   workDay = workDay.AddDays(7);
} while (workDay.Month == month); 
// The example produces the following output:
//    Beginning of Work Week In March 2008:
//       Monday, March 3
//       Monday, March 10
//       Monday, March 17
//       Monday, March 24
//       Monday, March 31             
Dim workDay As New DateTimeOffset(#3/1/2008 9:00AM#, _
                   DateTimeOffset.Now.Offset)
Dim month As Integer = workDay.Month
' Start with the first Monday of the month
If workDay.DayOfWeek <> DayOfWeek.Monday Then
   If workDay.DayOfWeek = DayOfWeek.Sunday Then
      workDay = workDay.AddDays(1)
   Else   
      workDay = workDay.AddDays(8 - CInt(workDay.DayOfWeek))
   End If
End If
Console.WriteLine("Beginning of Work Week In {0:MMMM} {0:yyyy}:", workDay)
' Add one week to the current date 
Do While workDay.Month = month
   Console.WriteLine("   {0:dddd}, {0:MMMM}{0: d}", workDay)
   workDay = workDay.AddDays(7)
Loop        
' The example produces the following output:
'    Beginning of Work Week In March 2008:
'       Monday, March 3
'       Monday, March 10
'       Monday, March 17
'       Monday, March 24
'       Monday, March 31             

설명

days 매개 변수의 소수 부분은 일의 소수 부분입니다.The fractional part of the days parameter is the fractional part of a day. 예를 들어 4.5는 4 일에 12 시간, 0 분, 0 초를 0 시간 (밀리초)와 동일 합니다.For example, 4.5 is equivalent to 4 days, 12 hours, 0 minutes, 0 seconds, 0 milliseconds. days 매개 변수는 가장 가까운 밀리초로 반올림 됩니다.The days parameter is rounded to the nearest millisecond.

참고

이 메서드는 새 DateTimeOffset 개체를 반환 합니다.This method returns a new DateTimeOffset object. 날짜 및 시간에 days을 추가 하 여 현재 개체의 값을 수정 하지 않습니다.It does not modify the value of the current object by adding days to its date and time.

DateTimeOffset 개체는 특정 표준 시간대의 날짜와 시간을 나타내지 않으므로 AddDays 메서드는 날짜 및 시간 산술 연산을 수행할 때 특정 표준 시간대의 조정 규칙을 고려 하지 않습니다.Because a DateTimeOffset object does not represent the date and time in a specific time zone, the AddDays method does not consider a particular time zone's adjustment rules when it performs date and time arithmetic.

일부분으로 하루 미만의 시간 간격을 변환 하면 정밀도 손실이 될 수 있습니다.Converting time intervals of less than a day to a fraction can involve a loss of precision. 이로 인해 문제가 발생 하는 경우에는 Add 메서드를 사용 하 여 단일 메서드 호출에서 여러 종류의 시간 간격을 지정 하 고 시간 간격을 하루 소수 부분으로 변환 하지 않아도 됩니다.If this is problematic, you can use the Add method, which enables you to specify more than one kind of time interval in a single method call and eliminates the need to convert time intervals to fractional parts of a day.

적용 대상