DateTimeOffset.AddMinutes(Double) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.