GregorianCalendar.GetMonthsInYear Method (Int32, Int32)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Returns the number of months in the specified year in the specified era.

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

Syntax

'Declaration
Public Overrides Function GetMonthsInYear ( _
    year As Integer, _
    era As Integer _
) As Integer
public override int GetMonthsInYear(
    int year,
    int era
)

Parameters

  • year
    Type: System.Int32
    An integer that represents the year.
  • era
    Type: System.Int32
    An integer that represents the era.

Return Value

Type: System.Int32
The number of months in the specified year in the specified era.

Exceptions

Exception Condition
ArgumentOutOfRangeException

era is outside the range supported by the calendar.

-or-

year is outside the range supported by the calendar.

Examples

The following code example calls GetMonthsInYear for five years in each era.

Imports System.Globalization

Public Class Example
   Public Shared Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)
      ' Creates and initializes a GregorianCalendar.
      Dim myCal As New GregorianCalendar()

      ' Displays the header.
      outputBlock.Text &= "YEAR" + ControlChars.Tab
      Dim y As Integer
      For y = 2001 To 2005
         outputBlock.Text += String.Format(ControlChars.Tab + "{0}", y)
      Next y
      outputBlock.Text &= vbCrLf

      ' Displays the value of the CurrentEra property.
      outputBlock.Text &= "CurrentEra:"
      For y = 2001 To 2005
         outputBlock.Text += String.Format(ControlChars.Tab + "{0}", myCal.GetMonthsInYear(y, GregorianCalendar.CurrentEra))
      Next y
      outputBlock.Text &= vbCrLf

      ' Displays the values in the Eras property.
      Dim i As Integer
      For i = 0 To myCal.Eras.Length - 1
         outputBlock.Text += String.Format("Era {0}:" + ControlChars.Tab, myCal.Eras(i))
         For y = 2001 To 2005
            outputBlock.Text += String.Format(ControlChars.Tab + "{0}", myCal.GetMonthsInYear(y, myCal.Eras(i)))
         Next y
         outputBlock.Text &= vbCrLf
      Next i
   End Sub  
End Class 
' This example produces the following output.
'       YEAR            2001    2002    2003    2004    2005
'       CurrentEra:     12      12      12      12      12
'       Era 1:          12      12      12      12      12
using System;
using System.Globalization;


public class Example
{

   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {

      // Creates and initializes a GregorianCalendar.
      GregorianCalendar myCal = new GregorianCalendar();

      // Displays the header.
      outputBlock.Text += "YEAR\t";
      for (int y = 2001; y <= 2005; y++)
         outputBlock.Text += String.Format("\t{0}", y);
      outputBlock.Text += "\n";

      // Displays the value of the CurrentEra property.
      outputBlock.Text += "CurrentEra:";
      for (int y = 2001; y <= 2005; y++)
         outputBlock.Text += String.Format("\t{0}", myCal.GetMonthsInYear(y, GregorianCalendar.CurrentEra));
      outputBlock.Text += "\n";

      // Displays the values in the Eras property.
      for (int i = 0; i < myCal.Eras.Length; i++)
      {
         outputBlock.Text += String.Format("Era {0}:\t", myCal.Eras[i]);
         for (int y = 2001; y <= 2005; y++)
            outputBlock.Text += String.Format("\t{0}", myCal.GetMonthsInYear(y, myCal.Eras[i]));
         outputBlock.Text += "\n";
      }

   }

}

/*
This code produces the following output.

YEAR            2001    2002    2003    2004    2005
CurrentEra:     12      12      12      12      12
Era 1:          12      12      12      12      12

*/

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.