DateTimeOffset.AddMinutes(Double) Método

Definição

Retorna um novo objeto DateTimeOffset que adiciona um número especificado de minutos inteiros e fracionários ao valor dessa instância.

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

Parâmetros

minutes
Double

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

Retornos

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

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 minutes parâmetro é a parte fracionária de um minuto. Por exemplo, 4,5 é equivalente a 4 minutos, 30 segundos, 0 milissegundos.

No .NET 6 e em versões anteriores, o minutes parâmetro é arredondado para o milissegundo mais próximo. No .NET 7 e versões posteriores, a precisão total Double do minutes 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 minutes à sua data e hora.

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

Converter intervalos de tempo de menos de um minuto em uma fração pode envolver uma perda de precisão. (Por exemplo, um segundo é 0,01666 de um minuto.) Se isso for problemático, você poderá usar o Add método , que permite especificar mais de um tipo de intervalo de tempo em uma única chamada de método e elimina a necessidade de converter intervalos de tempo em partes fracionárias de um minuto.

Aplica-se a

Confira também