Export (0) Print
Expand All

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

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

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

public DateTimeOffset(
	int year,
	int month,
	int day,
	int hour,
	int minute,
	int second,
	int millisecond,
	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).

millisecond
Type: System.Int32

The milliseconds (0 through 999).

offset
Type: System.TimeSpan

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

ExceptionCondition
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-

millisecond is less than 0 or greater than 999.

-or-

offset is less than -14 or greater than 14.

-or-

The UtcDateTime property is earlier than MinValue or later than 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, Int32, TimeSpan) constructor overload.

string fmt = "dd MMM yyyy HH:mm:ss";
DateTime thisDate = new DateTime(2007, 06, 12, 19, 00, 14, 16);
DateTimeOffset offsetDate = new DateTimeOffset(thisDate.Year, 
                                               thisDate.Month, 
                                               thisDate.Day, 
                                               thisDate.Hour,
                                               thisDate.Minute,
                                               thisDate.Second,
                                               thisDate.Millisecond, 
                                               new TimeSpan(2, 0, 0));  
Console.WriteLine("Current time: {0}:{1}", offsetDate.ToString(fmt), offsetDate.Millisecond);
// The code produces the following output: 
//    Current time: 12 Jun 2007 19:00:14:16      

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5 SP1, 3.0 SP1, 2.0 SP1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft