DateTime.Day Property

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Source:

DateTime.cs

Gets the day of the month represented by this instance.

public:
 property int Day { int get(); };

public int Day { get; }

member this.Day : int

Public ReadOnly Property Day As Integer

Property Value

Int32

The day component, expressed as a value between 1 and 31.

Examples

The following example demonstrates the Day property.

System::DateTime moment = 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;

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;

open System


let moment = System.DateTime(1999, 1, 13, 3, 57, 32, 11)

// Year gets 1999.
let year = moment.Year

// Month gets 1 (January).
let month = moment.Month

// Day gets 13.
let day = moment.Day

// Hour gets 3.
let hour = moment.Hour

// Minute gets 57.
let minute = moment.Minute

// Second gets 32.
let second = moment.Second

// Millisecond gets 11.
let millisecond = moment.Millisecond

Dim moment As New System.DateTime(1999, 1, 13, 3, 57, 32, 11)

' Year gets 1999.
Dim year As Integer = moment.Year

' Month gets 1 (January).
Dim month As Integer = moment.Month

' Day gets 13.
Dim day As Integer = moment.Day

' Hour gets 3.
Dim hour As Integer = moment.Hour

' Minute gets 57.
Dim minute As Integer = moment.Minute

' Second gets 32.
Dim second As Integer = moment.Second

' Millisecond gets 11.
Dim millisecond As Integer = moment.Millisecond

Remarks

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 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);
Console.WriteLine(dateGregorian.Day);
// 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.
Console.WriteLine(dateHijri.Day);
// Displays 13 (Gregorian day).

// Display day of date in Hijri calendar.
Console.WriteLine(hijri.GetDayOfMonth(dateHijri));
// Displays 17 (Hijri day).

// Return day of 1/13/2009.
let dateGregorian = DateTime(2009, 1, 13)
printfn $"{dateGregorian.Day}"
// Displays 13 (Gregorian day).

// Create date of 1/13/2009 using Hijri calendar.
let hijri = HijriCalendar()
let dateHijri = DateTime(1430, 1, 17, hijri)
// Return day of date created using Hijri calendar.
printfn $"{dateHijri.Day}"
// Displays 13 (Gregorian day).

// Display day of date in Hijri calendar.
printfn $"{hijri.GetDayOfMonth dateHijri}"
// Displays 17 (Hijri day).

' Return day of 1/13/2009.
Dim dateGregorian As Date = #1/13/2009#
Console.WriteLine(dateGregorian.Day)
' Displays 13 (Gregorian date).

' Create date of 1/13/2009 using Hijri calendar.
Dim hijri As New HijriCalendar()
Dim dateHijri As Date = New Date(1430, 1, 17, hijri)
' Return day of date created using Hijri calendar.
Console.WriteLine(dateHijri.Day)                   
' Displays 13 (Gregorian date).

' Display day of date in Hijri calendar.
Console.WriteLine(hijri.GetDayOfMonth(dateHijri))  
' Displays 17 (Hijri date).

Similarly, the following example uses both the Day property and the HijriCalendar.GetDayOfMonth method to retrieve the day of the month when the current 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,
                         Thread.CurrentThread.CurrentCulture.Calendar);
// Display date (uses calendar of current culture by default).
Console.WriteLine(hijriDate.ToString("dd-MM-yyyy"));
// Displays 17-01-1430.

// Display day of 17th of Muharram
Console.WriteLine(hijriDate.Day);
// Displays 13 (corresponding day of January in Gregorian calendar).

// Display day of 17th of Muharram in Hijri calendar.
Console.WriteLine(Thread.CurrentThread.CurrentCulture.Calendar.GetDayOfMonth(hijriDate));
// Displays 17.

Thread.CurrentThread.CurrentCulture = originalCulture;

open System
open System.Globalization
open System.Threading

let originalCulture = Thread.CurrentThread.CurrentCulture

// Change current culture to ar-SA.
let ci = CultureInfo "ar-SA"
Thread.CurrentThread.CurrentCulture <- ci

let hijriDate = new DateTime(1430, 1, 17,
                        Thread.CurrentThread.CurrentCulture.Calendar);
// Display date (uses calendar of current culture by default).
printfn $"""{hijriDate.ToString "dd-MM-yyyy"}"""
// Displays 17-01-1430.

// Display day of 17th of Muharram
printfn $"{hijriDate.Day}"
// Displays 13 (corresponding day of January in Gregorian calendar).

// Display day of 17th of Muharram in Hijri calendar.
printfn $"{Thread.CurrentThread.CurrentCulture.Calendar.GetDayOfMonth hijriDate}"
// Displays 17.

Thread.CurrentThread.CurrentCulture <- originalCulture

Dim originalCulture As CultureInfo = Thread.CurrentThread.CurrentCulture

' Change current culture to ar-SA.
Dim ci As New CultureInfo("ar-SA")
Thread.CurrentThread.CurrentCulture = ci

Dim hijriDate As New Date(1430, 1, 17, _
                          Thread.CurrentThread.CurrentCulture.Calendar)
' Display date (uses calendar of current culture by default).
Console.WriteLine(hijriDate.ToString("dd-MM-yyyy"))
' Displays 17-01-1430.

' Display day of 17th of Muharram
Console.WriteLine(hijriDate.Day)
' Displays 13 (corresponding day of January in Gregorian calendar).

' Display day of 17th of Muharram in Hijri calendar.
Console.WriteLine(Thread.CurrentThread.CurrentCulture.Calendar.GetDayOfMonth(hijriDate))
' Displays 17.

Thread.CurrentThread.CurrentCulture = originalCulture