DateTime.Add(TimeSpan) DateTime.Add(TimeSpan) DateTime.Add(TimeSpan) DateTime.Add(TimeSpan) Method

Definición

Devuelve un nuevo objeto DateTime que suma el valor del objeto TimeSpan especificado al valor de esta instancia.Returns a new DateTime that adds the value of the specified TimeSpan to the value of this instance.

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

Intervalo de tiempo positivo o negativo.A positive or negative time interval.

Devoluciones

Objeto cuyo valor es la suma de la fecha y hora representadas por esta instancia y el intervalo de hora representado por value.An object whose value is the sum of the date and time represented by this instance and the time interval represented by value.

Excepciones

Ejemplos

En el siguiente ejemplo se Add muestra el método.The following example demonstrates the Add method. Calcula el día de la semana que es 36 días (864 horas) a partir de este momento.It calculates the day of the week that is 36 days (864 hours) from this moment.

// 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.
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.You can use the Add method to add more than one kind of time interval (days, hours, minutes, seconds, or milliseconds) in a single operation. El comportamiento de este método es idéntico al del operador de suma.This method's behavior is identical to that of the addition operator. La DateTime estructura también admite métodos de suma especializados ( AddDayscomo, AddHoursy AddMinutes) para cada intervalo de tiempo.The DateTime structure also supports specialized addition methods (such as AddDays, AddHours, and AddMinutes) for each time interval.

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.The Add method takes into account leap years and the number of days in a month when performing date arithmetic.

Este método no cambia el valor de este DateTime.This method does not change the value of this DateTime. En su lugar, devuelve un nuevo DateTime cuyo valor es el resultado de esta operación.Instead, it returns a new DateTime whose value is the result of this operation. La Kind propiedad de la nueva DateTime instancia es la misma que la de la instancia actual.The Kind property of the new DateTime instance is the same as that of the current instance.

Se aplica a

Consulte también: