This documentation is archived and is not being maintained.

DateTime.Day Property

Gets the day of the month represented by this instance.

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

public int Day { get; }

Property Value

Type: System.Int32
The day component, expressed as a value between 1 and 31.

The Day property always returns the day of the month in the Gregorian calendar, even if the current DateTime value was instantiated using some other calendar or if the current thread culture's default calendar is not the Gregorian calendar. To retrieve the day of the month of a particular date using some other calendar, call that calendar's Calendar.GetDayOfMonth method. The following example uses both the Day property and the HijriCalendar.GetDayOfMonth method to retrieve the day of the month for a DateTime value that is instantiated using the Hijri calendar.

// Return day of 1/13/2009.
DateTime dateGregorian = new DateTime(2009, 1, 13);
// Displays 13 (Gregorian day).

// Create date of 1/13/2009 using Hijri calendar.
HijriCalendar hijri = new HijriCalendar();
DateTime dateHijri = new DateTime(1430, 1, 17, hijri);
// Return day of date created using Hijri calendar.
// Displays 13 (Gregorian day).

// Display day of date in Hijri calendar.
// Displays 17 (Hijri day).

Similarly, the following example uses both the Day property and the HijriCalendar.GetDayOfMonth method to retrieve the day of the month when the current thread culture is ar-SA, which uses Hijri as its default calendar.

CultureInfo originalCulture = Thread.CurrentThread.CurrentCulture;

// Change current culture to ar-SA.
CultureInfo ci = new CultureInfo("ar-SA");
Thread.CurrentThread.CurrentCulture = ci;

DateTime hijriDate = new DateTime(1430, 1, 17, 
// Display date (uses calendar of current culture by default).
// Displays 17-01-1430.

// Display day of 17th of Muharram
// Displays 13 (corresponding day of January in Gregorian calendar).

// Display day of 17th of Muharram in Hijri calendar.
// Displays 17.

Thread.CurrentThread.CurrentCulture = originalCulture;  

The following example demonstrates the Day property.

			System.DateTime moment = new System.DateTime(
											1999, 1, 13, 3, 57, 32, 11);
			// Year gets 1999.
			int year = moment.Year;
			// Month gets 1 (January).
			int month = moment.Month;
			// Day gets 13.
			int day = moment.Day;
			// Hour gets 3.
			int hour = moment.Hour;
			// Minute gets 57.
			int minute = moment.Minute;
			// Second gets 32.
			int second = moment.Second;
			// Millisecond gets 11.
			int millisecond = moment.Millisecond;

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.