DateTimeOffset.AddMilliseconds(Double) Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

DateTimeOffset.cs

Retorna um novo objeto DateTimeOffset 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

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

Retornos

DateTimeOffset

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

Exceções

ArgumentOutOfRangeException

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 6 e em versões anteriores, 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

Este método retorna um novo objeto DateTimeOffset. Ele 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 em um fuso horário específico, o AddMilliseconds método não considera regras de ajuste de um fuso horário específico quando executa aritmética de data e hora.

Confira também

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