Este método se usa para devolver un nuevo DateTime que agrega el número de horas especificado al valor de esta instancia.
Sintaxis:
public DateTime AddHours (double value);
Aquí, el valor es el número de horas enteras y fraccionarias. 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 horas representadas por value .
Excepción: 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.AddDays(Double) :
Ejemplo 1:
// C# program to demonstrate the
// DateTime.AddHours(Double) 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, 4, 0, 15);
// adding the 5.50 hours
// using AddHours() method;
DateTime date2 = date1.AddHours(5.50);
// Display the date1
Console.WriteLine("DateTime before operation:"+
" {0:y} {0:dd}, {0:t}", date1);
// Display the date2
Console.WriteLine("\nDateTime after operation: "+
"{0:y} {0:dd}, {0:t}", date2);
}
catch (ArgumentOutOfRangeException e)
{
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
}
}
DateTime before operation: 2010 January 01, 04:00 DateTime after operation: 2010 January 01, 09:30
Ejemplo 2: para ArgumentOutOfRangeException
// C# program to demonstrate the
// DateTime.AddHours(Double) 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.MaxValue;
// Display the date1
Console.WriteLine("DateTime before operation: "+
"{0:y} {0:dd}, {0:t}", date1);
// adding the TimeSpan of 5 days
// using AddHours() method;
DateTime date2 = date1.AddHours(5);
// Display the date2
System.Console.WriteLine("\nDateTime after operation:"+
" {0:y} {0:dd}, {0:t}", date2);
}
catch (ArgumentOutOfRangeException e)
{
Console.WriteLine("\nThe resulting DateTime is "+
"greater than the DateTime.MaxValue ");
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
}
}
DateTime before operation: 9999 December 31, 23:59 The resulting DateTime is greater than the DateTime.MaxValue Exception Thrown: System.ArgumentOutOfRangeException
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 RohitPrasad3 y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA