NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

DateTime Constructor (Int32, Int32, Int32, Int32, Int32, Int32, Calendar)

Initializes a new instance of the DateTime class and sets it to a specified year, month, day, hour, minute, and second for the specified Calendar.

[Visual Basic]
Overloads Public Sub New( _
   ByVal year As Integer, _
   ByVal month As Integer, _
   ByVal day As Integer, _
   ByVal hour As Integer, _
   ByVal minute As Integer, _
   ByVal second As Integer, _
   ByVal calendar As Calendar _
)
[C#]
public DateTime(
   int year,
   int month,
   int day,
   int hour,
   int minute,
   int second,
   Calendar calendar
);
[C++]
public: DateTime(
   int year,
   int month,
   int day,
   int hour,
   int minute,
   int second,
   Calendar* calendar
);
[JScript]
public function DateTime(
   year : int,
   month : int,
   day : int,
   hour : int,
   minute : int,
   second : int,
   calendar : Calendar
);

Parameters

year
An integer value that represents the year.
month
An integer value that represents the month.
day
An integer value that represents the day.
hour
An integer value that represents the hour.
minute
An integer value that represents the minute.
second
An integer value that represents the second.
calendar
The Calendar where the DateTime object is to represent a value.

Exceptions

Exception Type Condition
ArgumentException If the calendar is a null reference (in Visual Basic Nothing) .
ArgumentException If the year is less than 1 or greater than 9999.
ArgumentException If the month specifies a value outside the range of the specified calendar.
ArgumentException If the day is less than 1 or greater than the number of days in the specified month.
ArgumentException If the hour is less than 0 or greater than 23 .
ArgumentException If the minute is less than 0 or greater than 59 .
ArgumentException If the second is less than 0 or greater than 59 .

Remarks

This DateTime class initializes a new instance of the DateTime and sets its values to a specified year, month, day, hour, minute, and second for the specified calendar.

The allowable parameter values for year, month, and day depend upon the specified calendar that is used. The Globalization Namespace package provides implementation of the GregorianCalendar, JulianCalendar, and other calendars.

An argument is out of range for the specified calendar if it is not possible to represent the given arguments as a DateTime value. This is dependent upon the specified calendar.

See Also

DateTime Structure | DateTime Members | System Namespace | DateTime Constructor Overload List | Int32 | Calendar