Este método se usa para devolver un nuevo DateTime que agrega el valor del TimeSpan especificado al valor de esta instancia.
Sintaxis:
public DateTime Add (TimeSpan value);
Aquí, el valor es un intervalo de tiempo positivo o negativo.
Valor devuelto: este método devuelve un objeto cuyo valor es la suma de la fecha y la hora representadas por esta instancia y el intervalo de tiempo representado por el valor.
Excepciones: este método dará ArgumentOutOfRangeException si el DateTime resultante es menor que MinValue o mayor que MaxValue .
Los siguientes programas ilustran el uso del método DateTime.Add(TimeSpan) :
Ejemplo 1:
// C# program to demonstrate the // DateTime.Add(TimeSpan) Method using System; using System.Globalization; class GFG { // Main Method public static void Main() { try { // creating object of DateTime DateTime date1 = new DateTime(2010, 1, 1, 8, 0, 15); // creating object of TimeSpan TimeSpan duration = new TimeSpan(36, 0, 0, 0); // adding the TimeSpan of 36 days // using Add() method; DateTime date2 = date1.Add(duration); // Display the date1 System.Console.WriteLine("DateTime before "+ "operation: {0:y} {0:dd}", date1); // Display the date2 System.Console.WriteLine("\nDateTime after"+ " operation: {0:y} {0:dd}", date2); } catch (ArgumentOutOfRangeException e) { Console.Write("Exception Thrown: "); Console.Write("{0}", e.GetType(), e.Message); } } }
DateTime before operation: 2010 January 01 DateTime after operation: 2010 February 06
Ejemplo 2: para ArgumentOutOfRangeException
// C# program to demonstrate the // DateTime.Add(TimeSpan) Method using System; using System.Globalization; class GFG { // Main Method public static void Main() { try { // creating object of DateTime // and initialize with MinValue DateTime date1 = DateTime.MinValue; // Display the date1 Console.WriteLine("DateTime before "+ "operation: {0:y} {0:dd}", date1); // creating object of TimeSpan TimeSpan duration = new TimeSpan(-36, 0, 0, 0); // adding the TimeSpan of 36 days // using Add() method; DateTime date2 = date1.Add(duration); // Display the date2 Console.WriteLine("\nDateTime after"+ " operation: {0:y} {0:dd}", date2); } catch (ArgumentOutOfRangeException e) { Console.WriteLine("\nThe resulting DateTime"+ " is less than the MinValue "); Console.Write("Exception Thrown: "); Console.Write("{0}", e.GetType(), e.Message); } } }
DateTime before operation: 0001 January 01 The resulting DateTime is less than the MinValue Exception Thrown: System.ArgumentOutOfRangeException
Nota:
- El método Add tiene en cuenta los años bisiestos y el número de días de un mes al realizar la aritmética de fechas.
- 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.
Referencia:
Publicación traducida automáticamente
Artículo escrito por RohitPrasad3 y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA