<EnableAmPmParseAdjustment> 元素

确定日期和时间分析方法是否使用调整后的一组规则来分析包含天、月、小时和 AM/PM 指示符的日期字符串。

configuration
  runtime
    <EnableAmPmParseAdjustment>

语法

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

特性和元素

下列各节描述了特性、子元素和父元素。

特性

属性 描述
enabled 必需的特性。

指定日期和时间分析方法是否使用调整后的一组规则来分析仅包含天、月、小时和 AM/PM 指示符的日期字符串。

enabled 特性

说明
0 日期和时间分析方法不使用经过调整的规则来分析日期字符串,这些日期字符串仅包含天、月、小时和 AM/PM 指示符。
1 日期和时间分析方法使用经过调整的规则来分析日期字符串,这些日期字符串仅包含天、月、小时和 AM/PM 指示符。

子元素

无。

父元素

元素 说明
configuration 公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
runtime 包含有关运行时初始化选项的信息。

备注

<EnableAmPmParseAdjustment> 元素控制以下方法如何分析包含数字天、月、小时和 AM/PM 指示符(例如“4/10 6 AM”)的日期字符串:

其他模式不受影响。

<EnableAmPmParseAdjustment> 元素对 DateTime.ParseExactDateTime.TryParseExactDateTimeOffset.ParseExactDateTimeOffset.TryParseExact 方法不起作用。

重要

在 .NET Core 和 .NET Native 中,将默认启用调整后的 AM/PM 分析规则。

如果未启用分析调整规则,则会将字符串的第一个数字解释为 12 小时制的小时,而除 AM/PM 指示符之外的字符串的其余部分将被忽略。 分析方法返回的日期和时间由当前日期和从日期字符串提取的日期中的小时组成。

如果启用了分析调整规则,则分析方法会将日期和月份解释为属于当前年份,并将时间解释为 12 小时制的小时。

下表说明了当使用 DateTime.Parse(String) 方法分析字符串“4/10 6 AM”且 <EnableAmPmParseAdjustment> 元素的 enabled 属性设置为“0”或“1”时,DateTime 值的差异。 它假定今天的日期为 2017 年 1 月 5 日,并显示该日期,就像使用指定的区域性的“G”格式字符串进行格式化一样。

区域性名称 enabled="0" enabled="1"
zh-CN 1/5/2017 4:00:00 AM 4/10/2017 6:00:00 AM
en-GB 5/1/2017 6:00:00 10/4/2017 6:00:00

请参阅