DateTime.AddSeconds(Double) Método

Definição

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Origem:

DateTime.cs

Retorna um novo DateTime que adiciona o número especificado de segundos ao valor dessa instância.

C#

public DateTime AddSeconds(double value);

Parâmetros

value

Double

Um número de segundos inteiros e fracionários. O parâmetro value pode ser positivo ou negativo.

Retornos

DateTime

Um objeto cujo valor é a soma da data e hora representada por essa instância e o número de segundos representado por value.

Exceções

ArgumentOutOfRangeException

O resultado DateTime é menor que DateTime.MinValue ou maior que DateTime.MaxValue.

Exemplos

O exemplo a seguir usa o AddSeconds método para adicionar 30 segundos e o número de segundos em um dia a um DateTime valor. Em seguida, ele exibe cada novo valor e exibe a diferença entre ele e o valor original. A diferença é exibida como um período de tempo e como um número de tiques.

C#

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)

Comentários

Este método não altera o valor desse DateTime. Em vez disso, ele retorna um novo DateTime cujo valor é o resultado dessa operação.

A parte fracionária de value é a parte fracionária de um segundo. Por exemplo, 4,5 é equivalente a 4 segundos, 500 milissegundos e 0 tiques.

No .NET 6 e em versões anteriores, o value parâmetro é arredondado para o milissegundo mais próximo. No .NET 7 e versões posteriores, a precisão total Double do value parâmetro é usada. No entanto, devido à imprecisão inerente da matemática de ponto flutuante, a precisão resultante variará.

Aplica-se a

Confira também

• Double
• Executando operações aritméticas com datas e horas