Calendar.GetMonth Method
Microsoft Silverlight will reach end of support after October 2021. Learn more.
When overridden in a derived class, returns the month in the specified DateTime.
Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public MustOverride Function GetMonth ( _
time As DateTime _
) As Integer
public abstract int GetMonth(
DateTime time
)
Parameters
- time
Type: System.DateTime
The DateTime to read.
Return Value
Type: System.Int32
A positive integer that represents the month in time.
Remarks
For example, in HebrewCalendar, GetMonth for Tishrei returns 1, and GetMonth for Elul returns 12 in a common year or 13 in a leap year.
Examples
The following code example demonstrates the members of the Calendar class.
Imports System.Globalization
Public Class Example
Public Shared Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)
' Sets a DateTime to April 3, 2002 of the Gregorian calendar.
Dim myDT As New DateTime(2002, 4, 3, New GregorianCalendar())
' Uses the default calendar of the InvariantCulture.
Dim myCal As Calendar = CultureInfo.InvariantCulture.Calendar
' Displays the values of the DateTime.
outputBlock.Text += String.Format("April 3, 2002 of the Gregorian calendar:") & vbCrLf
DisplayValues(outputBlock, myCal, myDT)
' Adds 5 to every component of the DateTime.
myDT = myCal.AddYears(myDT, 5)
myDT = myCal.AddMonths(myDT, 5)
myDT = myCal.AddWeeks(myDT, 5)
myDT = myCal.AddDays(myDT, 5)
myDT = myCal.AddHours(myDT, 5)
myDT = myCal.AddMinutes(myDT, 5)
myDT = myCal.AddSeconds(myDT, 5)
myDT = myCal.AddMilliseconds(myDT, 5)
' Displays the values of the DateTime.
outputBlock.Text &= "After adding 5 to each component of the DateTime:" & vbCrLf
DisplayValues(outputBlock, myCal, myDT)
End Sub
Public Shared Sub DisplayValues(ByVal outputBlock As System.Windows.Controls.TextBlock, ByVal myCal As Calendar, ByVal myDT As DateTime)
outputBlock.Text += String.Format(" Era: {0}", myCal.GetEra(myDT)) & vbCrLf
outputBlock.Text += String.Format(" Year: {0}", myCal.GetYear(myDT)) & vbCrLf
outputBlock.Text += String.Format(" Month: {0}", myCal.GetMonth(myDT)) & vbCrLf
outputBlock.Text += String.Format(" DayOfYear: {0}", myCal.GetDayOfYear(myDT)) & vbCrLf
outputBlock.Text += String.Format(" DayOfMonth: {0}", myCal.GetDayOfMonth(myDT)) & vbCrLf
outputBlock.Text += String.Format(" DayOfWeek: {0}", myCal.GetDayOfWeek(myDT)) & vbCrLf
outputBlock.Text += String.Format(" Hour: {0}", myCal.GetHour(myDT)) & vbCrLf
outputBlock.Text += String.Format(" Minute: {0}", myCal.GetMinute(myDT)) & vbCrLf
outputBlock.Text += String.Format(" Second: {0}", myCal.GetSecond(myDT)) & vbCrLf
outputBlock.Text += String.Format(" Milliseconds: {0}", myCal.GetMilliseconds(myDT)) & vbCrLf
outputBlock.Text &= vbCrLf
End Sub
End Class
' This example produces the following output.
' April 3, 2002 of the Gregorian calendar:
' Era: 1
' Year: 2002
' Month: 4
' DayOfYear: 93
' DayOfMonth: 3
' DayOfWeek: Wednesday
' Hour: 0
' Minute: 0
' Second: 0
' Milliseconds: 0
'
' After adding 5 to each component of the DateTime:
' Era: 1
' Year: 2007
' Month: 10
' DayOfYear: 286
' DayOfMonth: 13
' DayOfWeek: Saturday
' Hour: 5
' Minute: 5
' Second: 5
' Milliseconds: 5
using System;
using System.Globalization;
public class Example
{
public static void Demo(System.Windows.Controls.TextBlock outputBlock)
{
// Sets a DateTime to April 3, 2002 of the Gregorian calendar.
DateTime myDT = new DateTime(2002, 4, 3, new GregorianCalendar());
// Uses the default calendar of the InvariantCulture.
Calendar myCal = CultureInfo.InvariantCulture.Calendar;
// Displays the values of the DateTime.
outputBlock.Text += String.Format("April 3, 2002 of the Gregorian calendar:") + "\n";
DisplayValues(outputBlock, myCal, myDT);
// Adds 5 to every component of the DateTime.
myDT = myCal.AddYears(myDT, 5);
myDT = myCal.AddMonths(myDT, 5);
myDT = myCal.AddWeeks(myDT, 5);
myDT = myCal.AddDays(myDT, 5);
myDT = myCal.AddHours(myDT, 5);
myDT = myCal.AddMinutes(myDT, 5);
myDT = myCal.AddSeconds(myDT, 5);
myDT = myCal.AddMilliseconds(myDT, 5);
// Displays the values of the DateTime.
outputBlock.Text += "After adding 5 to each component of the DateTime:" + "\n";
DisplayValues(outputBlock, myCal, myDT);
}
public static void DisplayValues(System.Windows.Controls.TextBlock outputBlock, Calendar myCal, DateTime myDT)
{
outputBlock.Text += String.Format(" Era: {0}", myCal.GetEra(myDT)) + "\n";
outputBlock.Text += String.Format(" Year: {0}", myCal.GetYear(myDT)) + "\n";
outputBlock.Text += String.Format(" Month: {0}", myCal.GetMonth(myDT)) + "\n";
outputBlock.Text += String.Format(" DayOfYear: {0}", myCal.GetDayOfYear(myDT)) + "\n";
outputBlock.Text += String.Format(" DayOfMonth: {0}", myCal.GetDayOfMonth(myDT)) + "\n";
outputBlock.Text += String.Format(" DayOfWeek: {0}", myCal.GetDayOfWeek(myDT)) + "\n";
outputBlock.Text += String.Format(" Hour: {0}", myCal.GetHour(myDT)) + "\n";
outputBlock.Text += String.Format(" Minute: {0}", myCal.GetMinute(myDT)) + "\n";
outputBlock.Text += String.Format(" Second: {0}", myCal.GetSecond(myDT)) + "\n";
outputBlock.Text += String.Format(" Milliseconds: {0}", myCal.GetMilliseconds(myDT)) + "\n";
outputBlock.Text += "\n";
}
}
/*
This code produces the following output.
April 3, 2002 of the Gregorian calendar:
Era: 1
Year: 2002
Month: 4
DayOfYear: 93
DayOfMonth: 3
DayOfWeek: Wednesday
Hour: 0
Minute: 0
Second: 0
Milliseconds: 0
After adding 5 to each component of the DateTime:
Era: 1
Year: 2007
Month: 10
DayOfYear: 286
DayOfMonth: 13
DayOfWeek: Saturday
Hour: 5
Minute: 5
Second: 5
Milliseconds: 5
*/
Version Information
Silverlight
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
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.