Windows apps
Collapse the table of content
Expand the table of content
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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

Initializes a new instance of the DateTime structure to the specified year, month, day, hour, minute, second, and millisecond for the specified calendar.

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

public DateTime(
	int year,
	int month,
	int day,
	int hour,
	int minute,
	int second,
	int millisecond,
	Calendar calendar


Type: System.Int32
The year (1 through the number of years in calendar).
Type: System.Int32
The month (1 through the number of months in calendar).
Type: System.Int32
The day (1 through the number of days in month).
Type: System.Int32
The hours (0 through 23).
Type: System.Int32
The minutes (0 through 59).
Type: System.Int32
The seconds (0 through 59).
Type: System.Int32
The milliseconds (0 through 999).
Type: System.Globalization.Calendar
The calendar to use to interpret year, month, and day.


calendar is null.


year is not in the range supported by calendar.


month is less than 1 or greater than the number of months in calendar.


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


hour is less than 0 or greater than 23.


minute is less than 0 or greater than 59.


second is less than 0 or greater than 59.


millisecond is less than 0 or greater than 999.


The specified parameters evaluate to earlier than DateTime.MinValue or later than DateTime.MaxValue.

The Kind property is initialized to Unspecified.

The allowable values for year, month, and day depend on calendar. An exception is thrown if the specified date and time cannot be expressed by using calendar.

For applications in which a limited degree of time zone awareness is important, you can use the corresponding DateTimeOffset constructor.

The System.Globalization namespace provides several calendars, including GregorianCalendar, HebrewCalendar, HijriCalendar, and JapaneseCalendar.

The following example calls the DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar) constructor to instantiate a DateTime value by using a HijriCalendar object. The DateTime in the Hijri calendar is then displayed in two different ways. Because the current culture may not support the Hijri calendar, the date in the Hijri calendar is displayed by making individual calls to its HijriCalendar.GetMonth, HijriCalendar.GetDayOfMonth, and HijriCalendar.GetYear methods. The example then changes the current culture to Arabic (Syria) and changes the current culture's default calendar to the Hijri calendar. Because Hijri is now the current culture's default calendar, the ToString(String, IFormatProvider) method, which is called implicitly by the String.Format method, uses it to format the date. When the previous current culture (which is English (United States) in this case) is restored, the ToString(String, IFormatProvider) method uses the current culture's default Gregorian calendar to format the date.

using System;
using System.Globalization;
using System.Text.RegularExpressions;
using System.Threading;

public class Example
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
      // Define Hijri calendar.
      HijriCalendar hijri = new HijriCalendar();
      // Define a date using the Hijri calendar.
      DateTime date1 = new DateTime(1431, 9, 9, 16, 32, 18, 500, hijri);

      outputBlock.Text += "Using the Hijri Calendar with the Default Culture:\n";
      outputBlock.Text += date1.ToString("M/dd/yyyy h:mm:ss.fff tt\n");
      outputBlock.Text += String.Format("{0}/{1}/{2} {3}:{4:D2}:{5:D2}.{6:G3}\n\n",

      // Get current culture so it can later be restored.
      CultureInfo dftCulture = Thread.CurrentThread.CurrentCulture;

      // Define strings for use in composite formatting.
      string dFormat;
      string fmtString;
      // Make ar-SY the current culture and Hijri the current calendar.
      Thread.CurrentThread.CurrentCulture = new CultureInfo("ar-SY");
      CultureInfo current = CultureInfo.CurrentCulture;
      current.DateTimeFormat.Calendar = hijri;
      dFormat = current.DateTimeFormat.ShortDatePattern;
      // Ensure year is displayed as four digits.
      dFormat = Regex.Replace(dFormat, "/yy$", "/yyyy") + " H:mm:ss.fff";
      fmtString = "{0} culture using the {1} calendar: {2:" + dFormat + "}\n";
      outputBlock.Text += String.Format(fmtString, current, GetCalendarName(hijri), date1);

      // Restore previous culture.
      Thread.CurrentThread.CurrentCulture = dftCulture;
      dFormat = DateTimeFormatInfo.CurrentInfo.ShortDatePattern + " H:mm:ss.fff";
      fmtString = "{0} culture using the {1} calendar: {2:" + dFormat + "}\n";
      outputBlock.Text += String.Format(fmtString,

   private static string GetCalendarName(Calendar cal)
      return Regex.Match(cal.ToString(), "\\.(\\w+)Calendar").Groups[1].Value;
// The example displays the following output:
//       8/18/2010 4:32:18.500 PM
//       5/27/1389 16:32:18.500
//       Using the Hijri Calendar:
//       ar-SY culture using the Hijri calendar: 09/09/1431 16:32:18.500
//       en-US culture using the Gregorian calendar: 8/18/2010 16:32:18.500


Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions

© 2018 Microsoft