<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.ParseExact、DateTime.TryParseExact、DateTimeOffset.ParseExact、および DateTimeOffset.TryParseExact メソッドには影響しません。

重要

.NET Core と .NET Native では、調整された AM/PM 解析規則は既定で有効になっています。

解析調整規則が有効になっていない場合、文字列の最初の桁は 12 時間形式の時間として解釈され、AM/PM 指定子を除く文字列の残りの部分は無視されます。 解析メソッドによって返される日付と時刻は、現在の日付と、日付文字列から抽出される日の時間で構成されます。

解析調整規則が有効になっている場合、解析メソッドでは、日と月が現在の年に属するものとして解釈し、時刻を 12 時間形式の時間として解釈します。

次の表には、DateTime.Parse(String) メソッドを使用して、<EnableAmPmParseAdjustment> 要素の enabled プロパティが "0" または "1" に設定された文字列 "4/10 6 AM" を解析する場合の DateTime 値の違いが示されています。 今日の日付が 2017 年 1 月 5 日であると想定し、指定されたカルチャの "G" 書式文字列を使用して書式設定されているかのように日付を表示します。

カルチャ名 enabled="0" enabled="1"
ja-JP 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

関連項目