DateTimeOffset.AddDays(Double) Método

Definición

Devuelve un nuevo objeto DateTimeOffset, que agrega un número especificado de días enteros y fraccionarios al valor de esta instancia.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

Parámetros

days
Double

Número de días enteros y fraccionarios.A number of whole and fractional days. El número puede ser positivo o negativo.The number can be negative or positive.

Devoluciones

DateTimeOffset

Un objeto cuyo valor es la suma de la fecha y hora representadas por el objeto DateTimeOffset actual y el número de días representados por 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.

Excepciones

El valor DateTimeOffset resultante es menor que MinValue.The resulting DateTimeOffset value is less than MinValue.

o bien-or- El valor DateTimeOffset resultante es mayor que MaxValue.The resulting DateTimeOffset value is greater than MaxValue.

Ejemplos

En el ejemplo siguiente se usa el AddDays método para enumerar las fechas que se celebran el lunes, el inicio de la semana laboral, en marzo de 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             

Comentarios

La parte fraccionaria del days parámetro es la parte fraccionaria de un día.The fractional part of the days parameter is the fractional part of a day. Por ejemplo, 4,5 es equivalente a 4 días, 12 horas, 0 minutos, 0 segundos, 0 milisegundos.For example, 4.5 is equivalent to 4 days, 12 hours, 0 minutes, 0 seconds, 0 milliseconds. El days parámetro se redondea al milisegundo más cercano.The days parameter is rounded to the nearest millisecond.

Nota

Este método devuelve un nuevo DateTimeOffset objeto.This method returns a new DateTimeOffset object. No modifica el valor del objeto actual agregando days a su fecha y hora.It does not modify the value of the current object by adding days to its date and time.

Dado que un DateTimeOffset objeto no representa la fecha y la hora de una zona horaria específica, el AddDays método no tiene en cuenta las reglas de ajuste de una zona horaria concreta cuando realiza operaciones aritméticas de fecha y hora.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.

La conversión de intervalos de tiempo de menos de un día a una fracción puede implicar una pérdida de precisión.Converting time intervals of less than a day to a fraction can involve a loss of precision. Si esto es problemático, puede usar el Add método, que le permite especificar más de un tipo de intervalo de tiempo en una única llamada al método y elimina la necesidad de convertir los intervalos de tiempo en partes fraccionarias de un día.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.

Se aplica a