This documentation is archived and is not being maintained.

DateTimeFormatInfo::YearMonthPattern Property

Gets or sets the format pattern for a year and month value, which is associated with the "y" and "Y" format patterns.

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

public:
property String^ YearMonthPattern {
	String^ get ();
	void set (String^ value);
}

Property Value

Type: System::String
The format pattern for a year and month value, which is associated with the "y" and "Y" format patterns.

ExceptionCondition
ArgumentNullException

The property is being set to nullptr.

InvalidOperationException

The property is being set and the DateTimeFormatInfo object is read-only.

See DateTimeFormatInfo for patterns that can be combined to construct custom patterns, for example, "yyyy MMMM".

This property is affected if the value of the Calendar property changes.

Your applications are recommended to set YearMonthPattern to the exact value of interest, instead of attempting to have the date separator replaced. For example, to obtain the pattern MM-yyyy, the application should set "MM-yyyy" specifically.

The following example displays the value of YearMonthPattern for a few cultures.


using namespace System;
using namespace System::Globalization;
void PrintPattern( String^ myCulture )
{
   CultureInfo^ MyCI = gcnew CultureInfo( myCulture,false );
   DateTimeFormatInfo^ myDTFI = MyCI->DateTimeFormat;
   Console::WriteLine( " {0} {1}", myCulture, myDTFI->YearMonthPattern );
}

int main()
{

   // Displays the values of the pattern properties.
   Console::WriteLine( " CULTURE    PROPERTY VALUE" );
   PrintPattern( "en-US" );
   PrintPattern( "ja-JP" );
   PrintPattern( "fr-FR" );
}

/*
This code produces the following output.  The question marks take the place of native script characters.

CULTURE    PROPERTY VALUE
en-US     MMMM, yyyy
ja-JP     yyyy'?'M'?'
fr-FR     MMMM yyyy

*/


.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.
Show: