DateTimeOffset.AddMilliseconds(Double) Método

Definição

Devolve um novo DateTimeOffset objeto que adiciona um número especificado de milissegundos ao valor desta instância.

public:
 DateTimeOffset AddMilliseconds(double milliseconds);
public DateTimeOffset AddMilliseconds(double milliseconds);
member this.AddMilliseconds : double -> DateTimeOffset
Public Function AddMilliseconds (milliseconds As Double) As DateTimeOffset

Parâmetros

milliseconds
Double

Um número de milissegundos inteiros e fracionários. O número pode ser negativo ou positivo.

Devoluções

Um objeto cujo valor é a soma da data e hora representadas pelo objeto atual DateTimeOffset e o número de milissegundos inteiros representado por milliseconds.

Exceções

O valor resultante DateTimeOffset é inferior ao DateTimeOffset.MinValue.

-ou-

O valor resultante DateTimeOffset é superior ao DateTimeOffset.MaxValue.

Observações

A parte fracionária do milliseconds parâmetro é a parte fracionária de um milissegundo. Por exemplo, 4,5 equivale a 4 milissegundos e 5000 ticks, onde um milissegundo equivale a 10.000 ticks. No entanto, no .NET Framework, milliseconds é arredondado para o milissegundo mais próximo, e todos os valores de 0,5 ou superior são arredondados para cima. Nas versões .NET 7 e posteriores, é utilizada a precisão total Double do parâmetro milliseconds. No entanto, devido à imprecisão inerente da matemática de ponto flutuante, a precisão resultante irá variar.

Note

Este método devolve um novo DateTimeOffset objeto. Não modifica o valor do objeto atual adicionando milliseconds à sua data e hora.

Como um DateTimeOffset objeto não representa a data e a hora num fuso horário específico, o AddMilliseconds método não considera as regras de ajuste de um fuso horário específico ao realizar a aritmética de data e hora.

Aplica-se a

Ver também