System.Globalization.DateTimeFormatInfo.AMDesignator Property

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

Syntax

public string AMDesignator { get; set; }

Value

The string designator for hours that are before noon.

Exceptions

TypeReason
ArgumentNullExceptionThe value specified for a set operation is a null reference.
InvalidOperationExceptionThe current instance is read-only and a set operation was attempted.

Remarks

The DateTimeFormatInfo.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 DateTimeOffset.ToString method includes the value of the DateTimeFormatInfo.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 DateTimeFormatInfo.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.

Requirements

Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0