Click to Rate and Give Feedback
MSDN
MSDN Library
.NET Development
Previous Versions
.NET Framework 1.1
.NET Framework
Reference
System
DateTime Structure
Methods
 AddHours Method
This page is specific to
Microsoft Visual Studio 2003/.NET Framework 1.1

Other versions are also available for the following:
.NET Framework Class Library
DateTime.AddHours Method

Adds the specified number of hours to the value of this instance.

[Visual Basic]
Public Function AddHours( _
   ByVal value As Double _
) As DateTime
[C#]
public DateTime AddHours(
 double value
);
[C++]
public: DateTime AddHours(
 double value
);
[JScript]
public function AddHours(
   value : double
) : DateTime;

Parameters

value
A number of whole and fractional hours. The value parameter can be negative or positive.

Return Value

A DateTime whose value is the sum of the date and time represented by this instance and the number of hours represented by value.

Exceptions

Exception Type Condition
ArgumentOutOfRangeException The resulting DateTime is less than MinValue or greater than MaxValue.

Remarks

This method does not change the value of this DateTime. Instead, a new DateTime is returned whose value is the result of this operation.

The fractional part of value is the fractional part of an hour. For example, 4.5 is equivalent to 4 hours, 30 minutes, 0 seconds, 0 milliseconds, and 0 ticks.

The value parameter is rounded to the nearest tick.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework, Common Language Infrastructure (CLI) Standard

See Also

DateTime Structure | DateTime Members | System Namespace | Double

© 2009 Microsoft Corporation. All rights reserved. Terms of Use | Trademarks | Privacy Statement | Site Feedback
Page view tracker