DateTime.Add(TimeSpan) Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Devuelve un nuevo objeto DateTime que suma el valor del objeto TimeSpan especificado al valor de esta instancia.

public:
 DateTime Add(TimeSpan value);

public DateTime Add (TimeSpan value);

member this.Add : TimeSpan -> DateTime

Public Function Add (value As TimeSpan) As DateTime

Parámetros

value

TimeSpan

Intervalo de tiempo positivo o negativo.

Devoluciones

DateTime

Objeto cuyo valor es la suma de la fecha y hora representadas por esta instancia y el intervalo de hora representado por value.

Excepciones

ArgumentOutOfRangeException

El resultado DateTime es menor que DateTime.MinValue o mayor que DateTime.MaxValue.

Ejemplos

En el siguiente ejemplo se muestra el Add método. Calcula el día de la semana que es de 36 días (864 horas) desde este momento.

// Calculate what day of the week is 36 days from this instant.
System::DateTime today = System::DateTime::Now;
System::TimeSpan duration( 36, 0, 0, 0 );
System::DateTime answer = today.Add( duration );
System::Console::WriteLine( " {0:dddd}", answer );

// Calculate what day of the week is 36 days from this instant.
let today = DateTime.Now
let duration = TimeSpan(36, 0, 0, 0)
let answer = today.Add duration
printfn $"{answer:dddd}"

// Calculate what day of the week is 36 days from this instant.
System.DateTime today = System.DateTime.Now;
System.TimeSpan duration = new System.TimeSpan(36, 0, 0, 0);
System.DateTime answer = today.Add(duration);
System.Console.WriteLine("{0:dddd}", answer);

' Calculate what day of the week is 36 days from this instant.
Dim today As System.DateTime
Dim duration As System.TimeSpan
Dim answer As System.DateTime

today = System.DateTime.Now
duration = New System.TimeSpan(36, 0, 0, 0)
answer = today.Add(duration)

System.Console.WriteLine("{0:dddd}", answer)

Comentarios

Puede usar el Add método para agregar más de un tipo de intervalo de tiempo (días, horas, minutos, segundos o milisegundos) en una sola operación. El comportamiento de este método es idéntico al del operador de suma. La DateTime estructura también admite métodos de suma especializados (como AddDays, AddHoursy AddMinutes) para cada intervalo de tiempo.

El Add método tiene en cuenta los años bisiestos y el número de días de un mes al realizar la aritmética de fecha.

Este método no cambia el valor de .DateTime En su lugar, devuelve un nuevo DateTime cuyo valor es el resultado de esta operación. La Kind propiedad de la nueva DateTime instancia es la misma que la de la instancia actual.

Consulte también

• TimeSpan
• Add(TimeSpan)
• Realización de operaciones aritméticas con fechas y horas