判定日期與時間解析方法是否使用調整後的規則來解析包含日期、月份、整點及早晚標記符的日期字串。
<組態>
<運行時間>
<EnableAmPmParseAdjustment>
語法
<EnableAmPmParseAdjustment enabled="0"|"1" />
屬性和項目
下列章節說明屬性、子元素和父元素。
Attributes
| Attribute | Description |
|---|---|
enabled |
必要屬性。 規定日期與時間解析方法是否使用調整過的規則來解析僅包含日期、月份、小時及 AM/PM 指定符的日期字串。 |
啟用屬性
| 價值觀 | Description |
|---|---|
| 0 | 日期與時間解析方法不會使用調整後的規則來解析僅包含日期、月份、小時及早晚指定符的日期字串。 |
| 1 | 日期與時間解析方法使用調整規則來解析僅包含日期、月份、小時及上午/下午指定符的日期字串。 |
子元素
沒有。
父項目
| 元素 | Description |
|---|---|
configuration |
通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。 |
runtime |
包含有關執行階段初始化選項的資訊。 |
備註
此 <EnableAmPmParseAdjustment> 元素控制以下方法如何解析包含數字日期和月份、後面接著一小時及 AM/PM 指示符(例如「4/10 6 AM」)的日期字串:
其他模式則不受影響。
該<EnableAmPmParseAdjustment>元素對 、 DateTime.TryParseExact、 DateTimeOffset.ParseExact及 DateTimeOffset.TryParseExact 方法沒有影響DateTime.ParseExact。
這很重要
在 .NET Core 和 .NET Native 中,預設啟用了調整過的 AM/PM 解析規則。
若未啟用解析調整規則,字串的首位數字會被解讀為12小時鐘的整點,除了AM/PM指定符外,其餘字串會被忽略。 解析方法回傳的日期與時間包含從日期字串中擷取的當前日期及當日時點。
若啟用解析調整規則,解析方法會將日期和月份解釋為屬於當前年份,並將時間解釋為12小時鐘的整點。
下表說明當DateTime.Parse(String)該方法解析字串「4/10 6 AM」時enabled<EnableAmPmParseAdjustment>,元素屬性設為「0」或「1」時,值的差異DateTime。 它假設今天的日期是 2017 年 1 月 5 日,並以指定文化的「G」格式字串格式顯示日期。
| 文化名稱 | enabled=“0” | enabled=“1” |
|---|---|---|
| en-US | 2017年1月5日 凌晨4:00:00 | 2017/4/10 上午6:00:00 |
| en-GB | 5/1/2017 6:00:00 | 10/4/2017 6:00:00 |