<EnableAmPmParseAdjustment> 元素

  • 發行項

針對包含日期、月份、小時和上午/下午指示項的日期字串，決定日期及時間剖析方法是否使用一組調整過的規則來剖析。

<configuration>
  <runtime>
    <EnableAmPmParseAdjustment>

Syntax

<EnableAmPmParseAdjustment enabled="0"|"1" />

屬性和項目

下列章節說明屬性、子元素和父元素。

屬性

屬性 描述
enabled 必要屬性。

針對只包含日期、月份、小時和上午/下午指示項的日期字串，指定日期及時間剖析方法是否使用一組調整過的規則來剖析。

啟用屬性

值 描述
0 針對只包含日期、月份、小時和上午/下午指示項的剖析日期字串，日期及時間剖析方法不使用調整過的規則。
1 針對只包含日期、月份、小時和上午/下午指示項的剖析日期字串，日期及時間剖析方法使用調整過的規則。

子元素

無。

父項目

元素 Description
configuration 通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。
runtime 包含有關執行階段初始化選項的資訊。

備註

<EnableAmPmParseAdjustment> 元素會控制下列方法如何剖析包含數值日期和月份的日期字串，後面接著小時和上午/下午指示項 (例如「4/10 6 AM」)：

不會影響任何其他模式。

<EnableAmPmParseAdjustment> 元素對 DateTime.ParseExact、DateTime.TryParseExact、DateTimeOffset.ParseExact 和 DateTimeOffset.TryParseExact 方法沒有任何影響。

重要

在 .NET Core 和 .NET Native 中，預設會啟用調整後的 AM/PM 剖析規則。

如果未啟用剖析調整規則，則會將字串的第一個數字解譯為 12 小時制的小時，而且會忽略上午/下午指示項以外的字串其餘部分。 剖析方法所傳回的日期和時間包含目前日期，以及從日期字串擷取的日期小時。

如果已啟用剖析調整規則，剖析方法會將日期和月份解譯為屬於目前年份，並將時間解譯為 12 小時制的小時。

下表說明當 DateTime.Parse(String) 方法用來剖析字串「4/10 6 AM」，而 <EnableAmPmParseAdjustment> 元素的 enabled 屬性設定為「0」或「1」時，DateTime 值的差異。 其假設今天的日期是 2017 年 1 月 5 日，並顯示日期，就像使用指定文化特性的「G」格式字串格式化一樣。

文化特性名稱 enabled="0" enabled="1"
zh-TW 2017/1/5 上午 4:00:00 2017/4/10 上午 6:00:00
en-GB 2017/5/1 6:00:00 2017/10/4 6:00:00

另請參閱