DateTimeFormatInfo.AMDesignator Property

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

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

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

Syntax

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 nullNothingnullptra 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

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

DateTimeFormatInfo Class

System.Globalization Namespace

PMDesignator