Export (0) Print
Expand All

DateTimeFormatInfo.AMDesignator Property

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

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

public string AMDesignator { get; set; }

Property Value

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

ExceptionCondition
ArgumentNullException

The property is being set to null.

InvalidOperationException

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

The AMDesignator property is used for all times from 0:00:00 (midnight) to 11:59:59.999.

If a custom format string includes the "tt" format specifier and the time is before noon, the DateTime.ToString or ToString method includes the value of the AMDesignator property in place of "tt" in the result string. If the custom format string includes the "t" custom format specifier, only the first character of the AMDesignator property value is included. You should use "tt" for languages for which it is necessary to maintain the distinction between A.M. and P.M. An example is Japanese, in which the A.M. and P.M. designators differ in the second character instead of the first character.

For cultures that do not use an A.M. designator, this property returns an empty string.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 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

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft