DateTimeOffset Constructor (Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, and offset.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

public:
DateTimeOffset(
	int year,
	int month,
	int day,
	int hour,
	int minute,
	int second,
	TimeSpan offset
)

Parameters

year
Type: System::Int32

The year (1 through 9999).

month
Type: System::Int32

The month (1 through 12).

day
Type: System::Int32

The day (1 through the number of days in month).

hour
Type: System::Int32

The hours (0 through 23).

minute
Type: System::Int32

The minutes (0 through 59).

second
Type: System::Int32

The seconds (0 through 59).

offset
Type: System::TimeSpan

The time's offset from Coordinated Universal Time (UTC).

Exception Condition
ArgumentException

offset does not represent whole minutes.

ArgumentOutOfRangeException

year is less than one or greater than 9999.

-or-

month is less than one or greater than 12.

-or-

day is less than one or greater than the number of days in month.

-or-

hour is less than zero or greater than 23.

-or-

minute is less than 0 or greater than 59.

-or-

second is less than 0 or greater than 59.

-or-

offset is less than -14 hours or greater than 14 hours.

-or-

The UtcDateTime property is earlier than DateTimeOffset::MinValue or later than DateTimeOffset::MaxValue.

This constructor interprets year, month, and day as a year, month, and day in the Gregorian calendar. To instantiate a DateTimeOffset value by using the year, month, and day in another calendar, call the DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar^, TimeSpan) constructor.

The following example instantiates a DateTimeOffset object by using the DateTimeOffset::DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) constructor overload.

No code example is currently available or this language may not be supported.

Universal Windows Platform
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: