DateTimeFormatInfo.PMDesignator Property

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

Gets or sets the string designator for hours that are "post meridiem" (after noon).

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

Syntax

'Declaration
Public Property PMDesignator As String
public string PMDesignator { get; set; }

Property Value

Type: System.String
The string designator for hours that are "post meridiem" (after noon). The default for InvariantInfo is "PM".

Exceptions

Exception Condition
ArgumentNullException

An attempt was made to set the property to nulla null reference (Nothing in Visual Basic).

InvalidOperationException

The DateTimeFormatInfo object is read-only.

Remarks

If a custom date and time format string includes the "tt" format specifier and the time is after noon, DateTime.ToString returns the value of PMDesignator in place of "tt" in the custom format string. If the custom format string includes the "t" custom format specifier, only the first character of PMDesignator is displayed. Your application should use "tt" for languages for which it is necessary to maintain the distinction between AM and PM. An example is Japanese, for which the AM and PM designators differ in the second character instead of the first character.

For cultures that do not use a PM designator, this property returns an empty string.

The PMDesignator property is used for all times from 12:00:00 (noon) to 23:59:59.999.

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.