DateTimeOffset.AddMilliseconds(Double) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.