Partilhar via


DateTimeOffset.AddMinutes(Double) Método

Definição

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

Vários minutos 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 minutos representado 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 e 0 milissegundos.

No .NET Framework, 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

Esse método retorna um novo DateTimeOffset objeto. Ele não modifica o valor do objeto atual adicionando minutes 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 AddMinutes 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.

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 eliminar a necessidade de converter intervalos de tempo em partes fracionárias de um minuto.

Aplica-se a

Confira também