Partager via


DateTimeFormatInfo.AMDesignator Property

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

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

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

Syntax

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

Property Value

Type: System.String
The string designator for hours that are "ante meridiem" (before noon). The default for InvariantInfo is "AM".

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 format string includes the format specifier "tt" and the time is before noon, DateTime.ToString returns the value of AMDesignator in place of "tt" in the format string. If the custom format string includes the format specifier "t", only the first character of AMDesignator 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 an AM designator, this property returns an empty string.

The AMDesignator property is used for all times from 00:00:00 (midnight) to 11: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.