Partilhar via


DateTimeOffset.AddMilliseconds(Double) Método

Definição

Retorna um novo DateTimeOffset objeto que adiciona um número especificado de milissegundos ao valor dessa 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

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

Retornos

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

Exceções

O valor resultante DateTimeOffset é menor que DateTimeOffset.MinValue.

- ou -

O valor resultante DateTimeOffset é maior que DateTimeOffset.MaxValue.

Comentários

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

Observação

Esse método retorna um novo DateTimeOffset objeto. Ele não modifica o valor do objeto atual adicionando milliseconds a sua data e hora.

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

Aplica-se a

Confira também