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