DateTime.AddSeconds(Double) DateTime.AddSeconds(Double) DateTime.AddSeconds(Double) DateTime.AddSeconds(Double) Method

Definición

Devuelve un nuevo objeto DateTime que suma el número especificado de segundos al valor de esta instancia.Returns a new DateTime that adds the specified number of seconds to the value of this instance.

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

Parámetros

value
Double Double Double Double

Número de segundos enteros y fraccionarios.A number of whole and fractional seconds. El parámetro value puede ser positivo o negativo.The value parameter can be negative or positive.

Devoluciones

Un objeto cuyo valor es la suma de la fecha y hora representadas por esta instancia y el número de segundos representados por value.An object whose value is the sum of the date and time represented by this instance and the number of seconds represented by value.

Excepciones

Ejemplos

En el ejemplo siguiente se usa el AddSeconds método para agregar 30 segundos y el número de segundos en un día para un DateTime valor.The following example uses the AddSeconds method to add 30 seconds and the number of seconds in one day to a DateTime value. A continuación, se muestra cada nuevo valor y se muestra la diferencia entre este y el valor original.It then displays each new value and displays the difference between it and the original value. La diferencia se muestra como un intervalo de tiempo y como un número de pasos.The difference is displayed both as a time span and as a number of ticks.

using System;

public class Example
{
   public static void Main()
   {
      string dateFormat = "MM/dd/yyyy hh:mm:ss";
      DateTime date1 = new DateTime(2014, 9, 8, 16, 0, 0);
      Console.WriteLine("Original date: {0} ({1:N0} ticks)\n",
                        date1.ToString(dateFormat), date1.Ticks);
      
      DateTime date2 = date1.AddSeconds(30);
      Console.WriteLine("Second date:   {0} ({1:N0} ticks)",
                        date2.ToString(dateFormat), date2.Ticks);
      Console.WriteLine("Difference between dates: {0} ({1:N0} ticks)\n",
                        date2 - date1, date2.Ticks - date1.Ticks);                        
      
      // Add 1 day's worth of seconds (60 secs. * 60 mins * 24 hrs.
      DateTime date3 = date1.AddSeconds(60 * 60 * 24);
      Console.WriteLine("Third date:    {0} ({1:N0} ticks)",
                        date3.ToString(dateFormat), date3.Ticks);
      Console.WriteLine("Difference between dates: {0} ({1:N0} ticks)",
                        date3 - date1, date3.Ticks - date1.Ticks);                        
   }
}
// The example displays the following output:
//    Original date: 09/08/2014 04:00:00 (635,457,888,000,000,000 ticks)
//
//    Second date:   09/08/2014 04:00:30 (635,457,888,300,000,000 ticks)
//    Difference between dates: 00:00:30 (300,000,000 ticks)
//
//    Third date:    09/09/2014 04:00:00 (635,458,752,000,000,000 ticks)
//    Difference between dates: 1.00:00:00 (864,000,000,000 ticks)
Module Example
   Public Sub Main()
      Dim dateFormat As String = "MM/dd/yyyy hh:mm:ss"
      Dim date1 As Date = #09/08/2014 16:00#
      Console.WriteLine("Original date: {0} ({1:N0} ticks)", _
                        date1.ToString(dateFormat), date1.Ticks)
      Console.WriteLine()
      
      Dim date2 As Date = date1.AddSeconds(30)
      Console.WriteLine("Second date:   {0} ({1:N0} ticks)", _
                        date2.ToString(dateFormat), date2.Ticks)
      Console.WriteLine("Difference between dates: {0} ({1:N0} ticks)", _
                        date2 - date1, date2.Ticks - date1.Ticks)                        
      Console.WriteLine()
      
      ' Add 1 day's worth of seconds (60 secs. * 60 mins * 24 hrs.
      Dim date3 As Date = date1.AddSeconds(60 * 60 * 24)
      Console.WriteLine("Third date:    {0} ({1:N0} ticks)", _
                        date3.ToString(dateFormat), date3.Ticks)
      Console.WriteLine("Difference between dates: {0} ({1:N0} ticks)", _
                        date3 - date1, date3.Ticks - date1.Ticks)                        
   End Sub
End Module
' The example displays the following output:
'    Original date: 09/08/2014 04:00:00 (635,457,888,000,000,000 ticks)
'
'    Second date:   09/08/2014 04:00:30 (635,457,888,300,000,000 ticks)
'    Difference between dates: 00:00:30 (300,000,000 ticks)
'
'    Third date:    09/09/2014 04:00:00 (635,458,752,000,000,000 ticks)
'    Difference between dates: 1.00:00:00 (864,000,000,000 ticks)

Comentarios

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 parte fraccionaria de value es la parte fraccionaria de segundo.The fractional part of value is the fractional part of a second. Por ejemplo, 4,5 equivale a 4 segundos, 500 milisegundos y 0 pasos.For example, 4.5 is equivalent to 4 seconds, 500 milliseconds, and 0 ticks.

El value parámetro se redondea al milisegundo más cercano.The value parameter is rounded to the nearest millisecond.

Se aplica a

Consulte también: