DateTimeOffset.AddMinutes(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 minutos inteiros e fracionários ao valor desta 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 fracionados. 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 minutos representado por minutes.
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 minutes parâmetro é a parte fracionária de um minuto. Por exemplo, 4,5 equivale a 4 minutos, 30 segundos, 0 milissegundos.
No .NET Framework, o parâmetro minutes é arredondado para o milissegundo mais próximo. Nas versões .NET 7 e posteriores, é utilizada a precisão total Double do parâmetro minutes. 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 minutes à sua data e hora.
Como um DateTimeOffset objeto não representa a data e a hora num fuso horário específico, o AddMinutes 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.
Converter intervalos de tempo inferiores a um minuto para uma fração pode implicar uma perda de precisão. (Por exemplo, um segundo é 0,01666 de minuto.) Se isto for problemático, pode usar o Add método, que permite especificar mais do que um tipo de intervalo de tempo numa única chamada de método e elimina a necessidade de converter intervalos de tempo em partes fracionárias de um minuto.