Método DateTime.AddMinutes() en C#

Este método se usa para devolver un nuevo DateTime que agrega el número de minutos especificado al valor de esta instancia.

Sintaxis:

public DateTime AddMinutes (double value);

Aquí, el valor es un número de minutos enteros y fraccionarios. El parámetro de valor puede ser negativo o positivo.

Valor devuelto: este método devuelve un objeto cuyo valor es la suma de la fecha y la hora representadas por esta instancia y la cantidad de minutos representados por value .

Excepción: este método lanzará ArgumentOutOfRangeException si el DateTime resultante es menor que MinValue o mayor que MaxValue .

Los siguientes programas ilustran el uso del método mencionado anteriormente:

Ejemplo 1:

// C# program to demonstrate the
// DateTime.AddMinutes(Double) Method
using System;
  
class GFG {
  
// Main Method
public static void Main()
{
  
    // Creating a DateTime object
    DateTime d1 = new DateTime(2018, 9,
                            7, 7, 0, 0);
  
    // Taking minutes
    double[] m1 = {.01567, .06743, 12.12347,
                           .89, .6666, 250.0};
  
    foreach(double m2 in m1)
    {
  
        // using the method
        Console.WriteLine("{0} + {1} minute(s) = {2}", d1,
                                   m2, d1.AddMinutes(m2));
    }                    
}
}

Producción:

09/07/2018 07:00:00 + 0.01567 minute(s) = 09/07/2018 07:00:00
09/07/2018 07:00:00 + 0.06743 minute(s) = 09/07/2018 07:00:04
09/07/2018 07:00:00 + 12.12347 minute(s) = 09/07/2018 07:12:07
09/07/2018 07:00:00 + 0.89 minute(s) = 09/07/2018 07:00:53
09/07/2018 07:00:00 + 0.6666 minute(s) = 09/07/2018 07:00:39
09/07/2018 07:00:00 + 250 minute(s) = 09/07/2018 11:10:00

Ejemplo 2:

// C# program to demonstrate the
// DateTime.AddMinutes(Double) Method
using System;
  
class GFG {
  
// Main Method
public static void Main()
{
  
    // Creating a DateTime object
    // by taking it MaxValue
    DateTime d1 = DateTime.MaxValue;
  
    // Taking minute variable
    double m1 = 1.7;
  
    // Using the Method will error as the
    // resulting DateTime is greater than 
    // MaxValue
    Console.WriteLine(d1.AddMinutes(m1));
}
}

Error de tiempo de ejecución:

Excepción no controlada:
System.ArgumentOutOfRangeException: el valor agregado o restado da como resultado una fecha y hora no representable.
Nombre del parámetro: valor

Nota:

  • Este método no cambia el valor de este DateTime. En su lugar, devuelve un nuevo DateTime cuyo valor es el resultado de esta operación.
  • La parte fraccionaria del valor es la parte fraccionaria de un minuto. Por ejemplo, 7,5 equivale a 7 minutos, 30 segundos, 0 milisegundos y 0 tics.
  • El parámetro de valor se redondea al milisegundo más cercano.

Referencia:

Publicación traducida automáticamente

Artículo escrito por Kirti_Mangal y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *