DateTime.AddSeconds(Double) Metodo

Definizione

Restituisce un nuovo oggetto DateTime che aggiunge il numero specificato di secondi al valore di questa istanza.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

Parametri

value
Double

Numero di secondi interi e frazionari.A number of whole and fractional seconds. Il parametro value può essere negativo o positivo.The value parameter can be negative or positive.

Restituisce

DateTime

Oggetto il cui valore è la somma della data e dell'ora rappresentate dall'istanza e del numero di secondi rappresentato da 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.

Eccezioni

Il valore risultante di DateTime è minore di MinValue o maggiore di MaxValue.The resulting DateTime is less than MinValue or greater than MaxValue.

Esempio

Nell'esempio seguente viene usato il AddSeconds metodo per aggiungere 30 secondi e il numero di secondi in un giorno a un DateTime valore.The following example uses the AddSeconds method to add 30 seconds and the number of seconds in one day to a DateTime value. Viene quindi visualizzato ogni nuovo valore e viene visualizzata la differenza tra l'oggetto e il valore originale.It then displays each new value and displays the difference between it and the original value. La differenza viene visualizzata sia come intervallo di tempo che come numero di cicli.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)

Commenti

Questo metodo non modifica il valore di questo oggetto DateTime .This method does not change the value of this DateTime. Viene invece restituito un nuovo oggetto DateTime il cui valore è il risultato di questa operazione.Instead, it returns a new DateTime whose value is the result of this operation.

La parte frazionaria di value è la parte frazionaria di un secondo.The fractional part of value is the fractional part of a second. 4,5, ad esempio, equivale a 4 secondi, 500 millisecondi e 0 cicli.For example, 4.5 is equivalent to 4 seconds, 500 milliseconds, and 0 ticks.

Il value parametro viene arrotondato al millisecondo più vicino.The value parameter is rounded to the nearest millisecond.

Si applica a

Vedi anche