DateTime.TryParseExact メソッド

リファレンス

定義

名前空間:: System

アセンブリ:: System.Runtime.dll

アセンブリ:: netstandard.dll

アセンブリ:: mscorlib.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定した日付と時刻の文字列形式を等価の DateTime に変換します。文字列形式の形式は、指定した形式と正確に一致する必要があります。このメソッドは、変換が成功したかどうかを示す値を返します。

オーバーロード

TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)	指定した形式、カルチャ固有の書式情報、およびスタイルを使用して、日付と時刻の指定したスパン表現を同等の DateTime に変換します。文字列形式の形式は、指定した形式と正確に一致する必要があります。このメソッドは、変換が成功したかどうかを示す値を返します。
TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime)	日付と時刻の指定した文字範囲を等価の DateTime に変換し、変換が成功したかどうかを示す値を返します。
TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)	指定した形式、カルチャ固有の書式情報、およびスタイルを使用して、日付と時刻の指定した文字列形式を等価の DateTime に変換します。文字列形式の形式は、指定した形式と正確に一致する必要があります。このメソッドは、変換が成功したかどうかを示す値を返します。
TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)	指定した形式の配列、カルチャ固有の書式情報、およびスタイルを使用して、日付と時刻の指定した文字列形式を等価の DateTime に変換します。文字列形式の形式は、指定された形式の少なくとも 1 つと完全に一致する必要があります。このメソッドは、変換が成功したかどうかを示す値を返します。

注釈

大事な

日本暦の年号は天皇の治世に基づいているため、変化することが期待されます。たとえば、2019 年 5 月 1 日は、JapaneseCalendar と JapaneseLunisolarCalendarで令和元年の始まりを示しました。このような時代の変化は、これらのカレンダーを使用するすべてのアプリケーションに影響します。詳細およびアプリケーションが影響を受けるかどうかを確認するには、「.NETの日本語カレンダーで新しい時代 (年号) を処理するを参照してください。 Windows システム上でアプリケーションをテストして時代 (年号) の変更に対する準備を確認する方法については、「日本の時代 (年号) の変更に対応するためのアプリケーションの準備」を参照してください。複数の時代 (年号) を含むカレンダーをサポートする .NET の機能と、複数の時代 (年号) をサポートするカレンダーを使用する場合のベストプラクティスについては、「年号の使用」を参照してください。

TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)

ソース:: DateTime.cs

ソース:: DateTime.cs

ソース:: DateTime.cs

指定した形式、カルチャ固有の書式情報、およびスタイルを使用して、日付と時刻の指定したスパン表現を同等の DateTime に変換します。文字列形式の形式は、指定した形式と正確に一致する必要があります。このメソッドは、変換が成功したかどうかを示す値を返します。

public:
 static bool TryParseExact(ReadOnlySpan<char> s, ReadOnlySpan<char> format, IFormatProvider ^ provider, System::Globalization::DateTimeStyles style, [Runtime::InteropServices::Out] DateTime % result);

public static bool TryParseExact (ReadOnlySpan<char> s, ReadOnlySpan<char> format, IFormatProvider? provider, System.Globalization.DateTimeStyles style, out DateTime result);

public static bool TryParseExact (ReadOnlySpan<char> s, ReadOnlySpan<char> format, IFormatProvider provider, System.Globalization.DateTimeStyles style, out DateTime result);

static member TryParseExact : ReadOnlySpan<char> * ReadOnlySpan<char> * IFormatProvider * System.Globalization.DateTimeStyles * DateTime -> bool

Public Shared Function TryParseExact (s As ReadOnlySpan(Of Char), format As ReadOnlySpan(Of Char), provider As IFormatProvider, style As DateTimeStyles, ByRef result As DateTime) As Boolean

パラメーター

s: ReadOnlySpan<Char>

変換する日付と時刻を表す文字を含むスパン。

format: ReadOnlySpan<Char>

sの必要な形式。

provider: IFormatProvider

sに関するカルチャ固有の書式設定情報を提供するオブジェクト。

style: DateTimeStyles

sの許可された形式を示す 1 つ以上の列挙値のビットごとの組み合わせ。

result: DateTime

このメソッドから制御が戻るときに、変換に成功した場合はに含まれる日付と時刻に相当する値を格納し、変換に失敗した場合は DateTime.MinValue をします。 s パラメーターまたは format パラメーターが null、空の文字列、または formatで指定されたパターンに対応する日付と時刻が含まれていない場合、変換は失敗します。このパラメーターは初期化されていない状態で渡されます。

戻り値

Boolean

s が正常に変換されたかどうかを true します。それ以外の場合は、falseします。

適用対象

TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime)

ソース:: DateTime.cs

ソース:: DateTime.cs

ソース:: DateTime.cs

日付と時刻の指定した文字範囲を等価の DateTime に変換し、変換が成功したかどうかを示す値を返します。

public:
 static bool TryParseExact(ReadOnlySpan<char> s, cli::array <System::String ^> ^ formats, IFormatProvider ^ provider, System::Globalization::DateTimeStyles style, [Runtime::InteropServices::Out] DateTime % result);

public static bool TryParseExact (ReadOnlySpan<char> s, string?[]? formats, IFormatProvider? provider, System.Globalization.DateTimeStyles style, out DateTime result);

public static bool TryParseExact (ReadOnlySpan<char> s, string[] formats, IFormatProvider provider, System.Globalization.DateTimeStyles style, out DateTime result);

static member TryParseExact : ReadOnlySpan<char> * string[] * IFormatProvider * System.Globalization.DateTimeStyles * DateTime -> bool

Public Shared Function TryParseExact (s As ReadOnlySpan(Of Char), formats As String(), provider As IFormatProvider, style As DateTimeStyles, ByRef result As DateTime) As Boolean

パラメーター

s: ReadOnlySpan<Char>

解析する文字列を含むスパン。

formats: String[]

sの許容される形式の配列。

provider: IFormatProvider

sに関するカルチャ固有の書式設定情報を提供するオブジェクト。

style: DateTimeStyles

現在のタイムゾーンまたは現在の日付に関連して解析された日付を解釈する方法を定義する列挙値のビットごとの組み合わせ。指定する一般的な値は Noneです。

result: DateTime

このメソッドから制御が戻るときに、変換に成功した場合はに含まれる日付と時刻に相当する値を格納し、変換に失敗した場合は DateTime.MinValue をします。 s パラメーターが null、Empty、または日付と時刻の有効な文字列表現が含まれていない場合、変換は失敗します。このパラメーターは初期化されていない状態で渡されます。

戻り値

Boolean

s パラメーターが正常に変換されたかどうかを true します。それ以外の場合は、falseします。

適用対象

TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)

ソース:: DateTime.cs

ソース:: DateTime.cs

ソース:: DateTime.cs

指定した形式、カルチャ固有の書式情報、およびスタイルを使用して、日付と時刻の指定した文字列形式を等価の DateTime に変換します。文字列形式の形式は、指定した形式と正確に一致する必要があります。このメソッドは、変換が成功したかどうかを示す値を返します。

public:
 static bool TryParseExact(System::String ^ s, System::String ^ format, IFormatProvider ^ provider, System::Globalization::DateTimeStyles style, [Runtime::InteropServices::Out] DateTime % result);

public static bool TryParseExact (string s, string format, IFormatProvider provider, System.Globalization.DateTimeStyles style, out DateTime result);

public static bool TryParseExact (string? s, string? format, IFormatProvider? provider, System.Globalization.DateTimeStyles style, out DateTime result);

static member TryParseExact : string * string * IFormatProvider * System.Globalization.DateTimeStyles * DateTime -> bool

Public Shared Function TryParseExact (s As String, format As String, provider As IFormatProvider, style As DateTimeStyles, ByRef result As DateTime) As Boolean

パラメーター

s: String

変換する日付と時刻を含む文字列。

format: String

sの必要な形式。

provider: IFormatProvider

sに関するカルチャ固有の書式設定情報を提供するオブジェクト。

style: DateTimeStyles

sの許可された形式を示す 1 つ以上の列挙値のビットごとの組み合わせ。

result: DateTime

戻り値

Boolean

s が正常に変換されたかどうかを true します。それ以外の場合は、falseします。

例外

ArgumentException

style は有効な DateTimeStyles 値ではありません。

-又は-

style には、DateTimeStyles 値の無効な組み合わせ (たとえば、AssumeLocal と AssumeUniversalの両方) が含まれています。

例

次の例では、DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) メソッドを示します。 styles パラメーターが DateTimeStyles.None と等しい場合、先頭のスペースは formatで許可されないため、文字列 "5/01/2009 8:30 AM" は正常に解析できないことに注意してください。さらに、文字列 "5/01/2009 09:00" は、"MM/dd/yyyyhh:mm" の format で正常に解析できません。これは、日付文字列が先頭に 0 を付けた月番号の前に存在しないため format 必要です。

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      CultureInfo enUS = new CultureInfo("en-US");
      string dateString;
      DateTime dateValue;

      // Parse date with no style flags.
      dateString = " 5/01/2009 8:30 AM";
      if (DateTime.TryParseExact(dateString, "g", enUS,
                                 DateTimeStyles.None, out dateValue))
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
                           dateValue.Kind);
      else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);

      // Allow a leading space in the date string.
      if (DateTime.TryParseExact(dateString, "g", enUS,
                                 DateTimeStyles.AllowLeadingWhite, out dateValue))
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
                           dateValue.Kind);
      else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);

      // Use custom formats with M and MM.
      dateString = "5/01/2009 09:00";
      if (DateTime.TryParseExact(dateString, "M/dd/yyyy hh:mm", enUS,
                                 DateTimeStyles.None, out dateValue))
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
                           dateValue.Kind);
      else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);

      // Allow a leading space in the date string.
      if (DateTime.TryParseExact(dateString, "MM/dd/yyyy hh:mm", enUS,
                              DateTimeStyles.None, out dateValue))
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
                           dateValue.Kind);
      else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);

      // Parse a string with time zone information.
      dateString = "05/01/2009 01:30:42 PM -05:00";
      if (DateTime.TryParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS,
                              DateTimeStyles.None, out dateValue))
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
                           dateValue.Kind);
      else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);

      // Allow a leading space in the date string.
      if (DateTime.TryParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS,
                              DateTimeStyles.AdjustToUniversal, out dateValue))
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
                           dateValue.Kind);
      else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);

      // Parse a string representing UTC.
      dateString = "2008-06-11T16:11:20.0904778Z";
      if (DateTime.TryParseExact(dateString, "o", CultureInfo.InvariantCulture,
                                     DateTimeStyles.None, out dateValue))
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
                           dateValue.Kind);
      else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);

      if (DateTime.TryParseExact(dateString, "o", CultureInfo.InvariantCulture,
                                 DateTimeStyles.RoundtripKind, out dateValue))
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
                           dateValue.Kind);
      else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);
   }
}
// The example displays the following output:
//    ' 5/01/2009 8:30 AM' is not in an acceptable format.
//    Converted ' 5/01/2009 8:30 AM' to 5/1/2009 8:30:00 AM (Unspecified).
//    Converted '5/01/2009 09:00' to 5/1/2009 9:00:00 AM (Unspecified).
//    '5/01/2009 09:00' is not in an acceptable format.
//    Converted '05/01/2009 01:30:42 PM -05:00' to 5/1/2009 11:30:42 AM (Local).
//    Converted '05/01/2009 01:30:42 PM -05:00' to 5/1/2009 6:30:42 PM (Utc).
//    Converted '2008-06-11T16:11:20.0904778Z' to 6/11/2008 9:11:20 AM (Local).
//    Converted '2008-06-11T16:11:20.0904778Z' to 6/11/2008 4:11:20 PM (Utc).

open System
open System.Globalization

[<EntryPoint>]
let main _ =
    let enUS = CultureInfo "en-US"

    // Parse date with no style flags.
    let dateString = " 5/01/2009 8:30 AM"
    match DateTime.TryParseExact(dateString, "g", enUS, DateTimeStyles.None) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue} ({dateValue.Kind})."              
    | _ ->
        printfn $"'{dateString}' is not in an acceptable format."

    // Allow a leading space in the date string.
    match DateTime.TryParseExact(dateString, "g", enUS, DateTimeStyles.AllowLeadingWhite) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue} ({dateValue.Kind})."
    | _ ->
        printfn $"'{dateString}' is not in an acceptable format."

    // Use custom formats with M and MM.
    let dateString = "5/01/2009 09:00"
    match DateTime.TryParseExact(dateString, "M/dd/yyyy hh:mm", enUS, DateTimeStyles.None) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue} ({dateValue.Kind})."
    | _ ->
        printfn $"'{dateString}' is not in an acceptable format."

    // Allow a leading space in the date string.
    match DateTime.TryParseExact(dateString, "MM/dd/yyyy hh:mm", enUS, DateTimeStyles.None) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue} ({dateValue.Kind})."
    | _ ->
        printfn $"'{dateString}' is not in an acceptable format."

    // Parse a string with time zone information.
    let dateString = "05/01/2009 01:30:42 PM -05:00"
    match DateTime.TryParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS, DateTimeStyles.None) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue} ({dateValue.Kind})."
    | _ ->
        printfn $"'{dateString}' is not in an acceptable format."

    // Allow a leading space in the date string.
    match DateTime.TryParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS, DateTimeStyles.AdjustToUniversal) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue} ({dateValue.Kind})."
    | _ ->
        printfn $"'{dateString}' is not in an acceptable format."

    // Parse a string representing UTC.
    let dateString = "2008-06-11T16:11:20.0904778Z"
    match DateTime.TryParseExact(dateString, "o", CultureInfo.InvariantCulture, DateTimeStyles.None) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue} ({dateValue.Kind})."
    | _ ->
        printfn $"'{dateString}' is not in an acceptable format."

    match DateTime.TryParseExact(dateString, "o", CultureInfo.InvariantCulture, DateTimeStyles.RoundtripKind) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue} ({dateValue.Kind})."
    | _ ->
        printfn $"'{dateString}' is not in an acceptable format."

    0

    // The example displays the following output:
    //    ' 5/01/2009 8:30 AM' is not in an acceptable format.
    //    Converted ' 5/01/2009 8:30 AM' to 5/1/2009 8:30:00 AM (Unspecified).
    //    Converted '5/01/2009 09:00' to 5/1/2009 9:00:00 AM (Unspecified).
    //    '5/01/2009 09:00' is not in an acceptable format.
    //    Converted '05/01/2009 01:30:42 PM -05:00' to 5/1/2009 11:30:42 AM (Local).
    //    Converted '05/01/2009 01:30:42 PM -05:00' to 5/1/2009 6:30:42 PM (Utc).
    //    Converted '2008-06-11T16:11:20.0904778Z' to 6/11/2008 9:11:20 AM (Local).
    //    Converted '2008-06-11T16:11:20.0904778Z' to 6/11/2008 4:11:20 PM (Utc).

Imports System.Globalization

Public Module Example
   Public Sub Main()
      Dim enUS As New CultureInfo("en-US") 
      Dim dateString As String
      Dim dateValue As Date
      
      ' Parse date with no style flags.
      dateString = " 5/01/2009 8:30 AM"
      If Date.TryParseExact(dateString, "g", enUS, _
                            DateTimeStyles.None, dateValue) Then
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End If
      ' Allow a leading space in the date string.
      If Date.TryParseExact(dateString, "g", enUS, _
                            DateTimeStyles.AllowLeadingWhite, dateValue) Then
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End If
      
      ' Use custom formats with M and MM.
      dateString = "5/01/2009 09:00"
      If Date.TryParseExact(dateString, "M/dd/yyyy hh:mm", enUS, _
                            DateTimeStyles.None, dateValue) Then
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End If
      ' Allow a leading space in the date string.
      If Date.TryParseExact(dateString, "MM/dd/yyyy hh:mm", enUS, _
                            DateTimeStyles.None, dateValue) Then
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End If

      ' Parse a string with time zone information.
      dateString = "05/01/2009 01:30:42 PM -05:00" 
      If Date.TryParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS, _
                            DateTimeStyles.None, dateValue) Then
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End If
      ' Allow a leading space in the date string.
      If Date.TryParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS, _
                            DateTimeStyles.AdjustToUniversal, dateValue) Then
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End If
           
      ' Parse a string representing UTC.
      dateString = "2008-06-11T16:11:20.0904778Z"
      If Date.TryParseExact(dateString, "o", CultureInfo.InvariantCulture, _
                                     DateTimeStyles.None, dateValue) Then
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End If
      
      If Date.TryParseExact(dateString, "o", CultureInfo.InvariantCulture, _
                            DateTimeStyles.RoundtripKind, dateValue) Then
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End If
   End Sub
End Module
' The example displays the following output:
'    ' 5/01/2009 8:30 AM' is not in an acceptable format.
'    Converted ' 5/01/2009 8:30 AM' to 5/1/2009 8:30:00 AM (Unspecified).
'    Converted '5/01/2009 09:00' to 5/1/2009 9:00:00 AM (Unspecified).
'    '5/01/2009 09:00' is not in an acceptable format.
'    Converted '05/01/2009 01:30:42 PM -05:00' to 5/1/2009 11:30:42 AM (Local).
'    Converted '05/01/2009 01:30:42 PM -05:00' to 5/1/2009 6:30:42 PM (Utc).
'    Converted '2008-06-11T16:11:20.0904778Z' to 6/11/2008 9:11:20 AM (Local).
'    Converted '2008-06-11T16:11:20.0904778Z' to 6/11/2008 4:11:20 PM (Utc).

注釈

DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) メソッドは、日付の文字列形式を解析します。この形式は、format パラメーターで定義されている形式である必要があります。 DateTime.ParseExact(String, String, IFormatProvider, DateTimeStyles) メソッドに似ていますが、変換が失敗した場合、TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) メソッドが例外をスローしない点が異なります。

s パラメーターには、解析する日時が含まれており、format パラメーターで定義された形式である必要があります。日付、時刻、タイムゾーンの要素が sに存在する場合は、formatで指定された順序で表示する必要もあります。 format が time 要素のない日付を定義し、解析操作が成功した場合、結果の DateTime 値の時刻は午前 0 時 (00:00:00) になります。 format が date 要素を持たない時刻を定義し、解析操作が成功した場合、結果の DateTime の値は既定で DateTime.Now.Dateの日付になります。または、DateTimeStyles.NoCurrentDateDefault フラグが含まれている場合は DateTime.MinValue.Date の日付 styles。 style パラメーターは、s パラメーターに先頭、内側、または末尾の空白文字を含めることができるかどうかを決定します。

s にタイムゾーン情報が含まれている場合、返される DateTime オブジェクトの Kind プロパティは DateTimeKind.Unspecified。この動作は、Kind プロパティが DateTimeKind.Local DateTime 値を返す DateTimeStyles.AssumeLocal フラグを使用するか、Kind プロパティが DateTimeKind.Utc DateTime 値を返す DateTimeStyles.AssumeUniversal フラグと DateTimeStyles.AdjustToUniversal フラグを使用して変更できます。 s にタイムゾーン情報が含まれている場合、時刻は必要に応じて現地時刻に変換され、返される DateTime オブジェクトの Kind プロパティは DateTimeKind.Localに設定されます。この動作は、DateTimeStyles.RoundtripKind フラグを使用して協定世界時 (UTC) を現地時刻に変換せず、Kind プロパティを DateTimeKind.Utcに設定することで変更できます。

format パラメーターには、s パラメーターの予期される形式に対応するパターンが含まれています。 format パラメーターのパターンは、カスタム日時書式指定文字列テーブルの 1 つ以上のカスタム書式指定子、または標準日時書式指定文字列テーブルから定義済みのパターンを識別する 1 つの標準書式指定子で構成されます。

カスタム書式パターンで日付または時刻の区切り記号を使用しない場合は、provider パラメーターと各カスタム書式指定子の最も広い形式のインバリアントカルチャを使用します。たとえば、パターンで時間を指定する場合は、狭い形式の "H" ではなく、より広い形式 "HH" を指定します。

手記

解析操作を成功させるために、s が 1 つの形式に準拠していることを要求するのではなく、DateTime.TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) メソッドを呼び出して、複数の許可される形式を指定できます。これにより、解析操作が成功する可能性が高くなります。

s で使用される特定の日付と時刻の記号と文字列 (特定の言語の曜日の名前など) は、provider パラメーターによって定義されます。format が標準書式指定子文字列の場合、s の正確な形式も定義されます。 provider パラメーターには、次のいずれかを指定できます。

sの解釈に使用するカルチャを表す CultureInfo オブジェクト。 DateTimeFormat プロパティによって返される DateTimeFormatInfo オブジェクトは、sでシンボルと書式設定を定義します。
日付と時刻のデータの形式を定義する DateTimeFormatInfo オブジェクト。
GetFormat メソッドが CultureInfo オブジェクトまたは書式設定情報を提供する DateTimeFormatInfo オブジェクトを返すカスタム IFormatProvider 実装。

provider が nullされている場合は、現在のカルチャに対応する CultureInfo オブジェクトが使用されます。

styles パラメーターには、format によって定義されていない空白を s に表示できるかどうかを決定し、解析操作の正確な動作を制御する、DateTimeStyles 列挙体の 1 つ以上のメンバーが含まれます。次の表では、DateTimeStyles 列挙体の各メンバーが、TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) メソッドの操作にどのように影響するかを説明します。

DateTimeStyles メンバー	形容
AdjustToUniversal	`s` を解析し、必要に応じて UTC に変換します。 `s` にタイムゾーンオフセットが含まれている場合、または `s` にタイムゾーン情報が含まれているが、`styles` に DateTimeStyles.AssumeLocal フラグが含まれている場合、メソッドは文字列を解析し、ToUniversalTime を呼び出して返された DateTime 値を UTC に変換し、Kind プロパティを DateTimeKind.Utcに設定します。 `s` が UTC を表していることを示す場合、または `s` にタイムゾーン情報が含まれていないが、DateTimeStyles.AssumeUniversal フラグが含まれている `styles` 場合、メソッドは文字列を解析し、返された DateTime 値に対してタイムゾーン変換を実行せず、Kind プロパティを DateTimeKind.Utcに設定します。それ以外の場合は、フラグは無効です。
AllowInnerWhite	`format` で定義されていない空白を個々の日付または時刻要素の間に表示できることを指定します。
AllowLeadingWhite	`format` で定義されていない空白を `s`の先頭に表示できることを指定します。
AllowTrailingWhite	`format` で定義されていない空白を `s`の末尾に表示できることを指定します。
AllowWhiteSpaces	`s` に、`format`で定義されていない先頭、内側、および末尾の空白を含めることができます。
AssumeLocal	`s` にタイムゾーン情報がない場合は、現地時刻を表すと見なされることを指定します。 DateTimeStyles.AdjustToUniversal フラグが存在しない限り、返される DateTime 値の Kind プロパティは DateTimeKind.Localに設定されます。
AssumeUniversal	`s` にタイムゾーン情報がない場合は、UTC を表すと見なされることを指定します。 DateTimeStyles.AdjustToUniversal フラグが存在しない限り、メソッドは返された DateTime 値を UTC から現地時刻に変換し、Kind プロパティを DateTimeKind.Localに設定します。
NoCurrentDateDefault	`s` に日付情報のない時刻が含まれている場合、戻り値の日付は `DateTime.MinValue.Date`に設定されます。
None	`s` パラメーターは、既定値を使用して解析されます。 `format` に存在する空白以外の空白は使用できません。 `s` に日付コンポーネントがない場合、返される DateTime 値の日付は 1/1/0001 に設定されます。タイムゾーン情報 `s` 含まない場合、返される DateTime オブジェクトの Kind プロパティは DateTimeKind.Unspecifiedに設定されます。タイムゾーン情報が `s`に存在する場合、時刻は現地時刻に変換され、返された DateTime オブジェクトの Kind プロパティは DateTimeKind.Localに設定されます。
RoundtripKind	タイムゾーン情報を含む文字列の場合は、Kind プロパティが DateTimeKind.Localに設定された DateTime 値への変換を回避します。このフラグは、主に UTC 時刻から現地時刻への変換を禁止します。

注意 (呼び出し元)

.NET Framework 4 では、解析する文字列に時間コンポーネントと、一致しない AM/PM 指定子が含まれている場合、TryParseExact メソッドは false を返します。 .NET Framework 3.5 以前のバージョンでは、AM/PM 指定子は無視されます。

こちらもご覧ください

ParseExact
CultureInfo
DateTimeFormatInfo
.NET Framework での日付と時刻の文字列の解析の
標準の日時書式指定文字列をする
カスタム日時書式指定文字列をする

適用対象

TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)

ソース:: DateTime.cs

ソース:: DateTime.cs

ソース:: DateTime.cs

指定した形式の配列、カルチャ固有の書式情報、およびスタイルを使用して、日付と時刻の指定した文字列形式を等価の DateTime に変換します。文字列形式の形式は、指定された形式の少なくとも 1 つと完全に一致する必要があります。このメソッドは、変換が成功したかどうかを示す値を返します。

public:
 static bool TryParseExact(System::String ^ s, cli::array <System::String ^> ^ formats, IFormatProvider ^ provider, System::Globalization::DateTimeStyles style, [Runtime::InteropServices::Out] DateTime % result);

public static bool TryParseExact (string s, string[] formats, IFormatProvider provider, System.Globalization.DateTimeStyles style, out DateTime result);

public static bool TryParseExact (string? s, string?[]? formats, IFormatProvider? provider, System.Globalization.DateTimeStyles style, out DateTime result);

static member TryParseExact : string * string[] * IFormatProvider * System.Globalization.DateTimeStyles * DateTime -> bool

Public Shared Function TryParseExact (s As String, formats As String(), provider As IFormatProvider, style As DateTimeStyles, ByRef result As DateTime) As Boolean

パラメーター

s: String

変換する日付と時刻を含む文字列。

formats: String[]

sの許容される形式の配列。

provider: IFormatProvider

sに関するカルチャ固有の書式情報を提供するオブジェクト。

style: DateTimeStyles

sの許可された形式を示す列挙値のビットごとの組み合わせ。指定する一般的な値は Noneです。

result: DateTime

このメソッドから制御が戻るときに、変換に成功した場合はに含まれる日付と時刻に相当する値を格納し、変換に失敗した場合は DateTime.MinValue をします。 s または formats が null、s、または formats の要素が空の文字列であるか、s の形式が formatsの形式パターンの少なくとも 1 つで指定されているとおりでない場合、変換は失敗します。このパラメーターは初期化されていない状態で渡されます。

戻り値

Boolean

s パラメーターが正常に変換されたかどうかを true します。それ以外の場合は、falseします。

例外

ArgumentException

style は有効な DateTimeStyles 値ではありません。

-又は-

style には、DateTimeStyles 値の無効な組み合わせ (たとえば、AssumeLocal と AssumeUniversalの両方) が含まれています。

例

次の例では、DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) メソッドを使用して、さまざまな形式の文字列を正常に解析できるようにします。

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] formats= {"M/d/yyyy h:mm:ss tt", "M/d/yyyy h:mm tt",
                         "MM/dd/yyyy hh:mm:ss", "M/d/yyyy h:mm:ss",
                         "M/d/yyyy hh:mm tt", "M/d/yyyy hh tt",
                         "M/d/yyyy h:mm", "M/d/yyyy h:mm",
                         "MM/dd/yyyy hh:mm", "M/dd/yyyy hh:mm"};
      string[] dateStrings = {"5/1/2009 6:32 PM", "05/01/2009 6:32:05 PM",
                              "5/1/2009 6:32:00", "05/01/2009 06:32",
                              "05/01/2009 06:32:00 PM", "05/01/2009 06:32:00"};
      DateTime dateValue;

      foreach (string dateString in dateStrings)
      {
         if (DateTime.TryParseExact(dateString, formats,
                                    new CultureInfo("en-US"),
                                    DateTimeStyles.None,
                                    out dateValue))
            Console.WriteLine("Converted '{0}' to {1}.", dateString, dateValue);
         else
            Console.WriteLine("Unable to convert '{0}' to a date.", dateString);
      }
   }
}
// The example displays the following output:
//       Converted '5/1/2009 6:32 PM' to 5/1/2009 6:32:00 PM.
//       Converted '05/01/2009 6:32:05 PM' to 5/1/2009 6:32:05 PM.
//       Converted '5/1/2009 6:32:00' to 5/1/2009 6:32:00 AM.
//       Converted '05/01/2009 06:32' to 5/1/2009 6:32:00 AM.
//       Converted '05/01/2009 06:32:00 PM' to 5/1/2009 6:32:00 PM.
//       Converted '05/01/2009 06:32:00' to 5/1/2009 6:32:00 AM.

open System
open System.Globalization

let formats= 
    [| "M/d/yyyy h:mm:ss tt"; "M/d/yyyy h:mm tt"
       "MM/dd/yyyy hh:mm:ss"; "M/d/yyyy h:mm:ss"
       "M/d/yyyy hh:mm tt"; "M/d/yyyy hh tt"
       "M/d/yyyy h:mm"; "M/d/yyyy h:mm"
       "MM/dd/yyyy hh:mm"; "M/dd/yyyy hh:mm" |]

let dateStrings = 
    [ "5/1/2009 6:32 PM"; "05/01/2009 6:32:05 PM"
      "5/1/2009 6:32:00"; "05/01/2009 06:32"
      "05/01/2009 06:32:00 PM"; "05/01/2009 06:32:00" ]

for dateString in dateStrings do
    match DateTime.TryParseExact(dateString, formats, CultureInfo "en-US", DateTimeStyles.None) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue}."
    | _ ->
        printfn $"Unable to convert '{dateString}' to a date."


// The example displays the following output:
//       Converted '5/1/2009 6:32 PM' to 5/1/2009 6:32:00 PM.
//       Converted '05/01/2009 6:32:05 PM' to 5/1/2009 6:32:05 PM.
//       Converted '5/1/2009 6:32:00' to 5/1/2009 6:32:00 AM.
//       Converted '05/01/2009 06:32' to 5/1/2009 6:32:00 AM.
//       Converted '05/01/2009 06:32:00 PM' to 5/1/2009 6:32:00 PM.
//       Converted '05/01/2009 06:32:00' to 5/1/2009 6:32:00 AM.

Imports System.Globalization

Public Module Example
   Public Sub Main()
      Dim formats() As String = {"M/d/yyyy h:mm:ss tt", "M/d/yyyy h:mm tt", _
                                 "MM/dd/yyyy hh:mm:ss", "M/d/yyyy h:mm:ss", _
                                 "M/d/yyyy hh:mm tt", "M/d/yyyy hh tt", _
                                 "M/d/yyyy h:mm", "M/d/yyyy h:mm", _
                                 "MM/dd/yyyy hh:mm", "M/dd/yyyy hh:mm"}
      Dim dateStrings() As String = {"5/1/2009 6:32 PM", "05/01/2009 6:32:05 PM", _
                                     "5/1/2009 6:32:00", "05/01/2009 06:32", _
                                     "05/01/2009 06:32:00 PM", "05/01/2009 06:32:00"} 

      Dim dateValue As DateTime
      
      For Each dateString As String In dateStrings
         If Date.TryParseExact(dateString, formats, _
                               New CultureInfo("en-US"), _
                               DateTimeStyles.None, _
                               dateValue) Then
            Console.WriteLine("Converted '{0}' to {1}.", dateString, dateValue)
         Else
            Console.WriteLine("Unable to convert '{0}' to a date.", dateString)
         End If                                               
      Next
   End Sub   
End Module
' The example displays the following output:
'       Converted '5/1/2009 6:32 PM' to 5/1/2009 6:32:00 PM.
'       Converted '05/01/2009 6:32:05 PM' to 5/1/2009 6:32:05 PM.
'       Converted '5/1/2009 6:32:00' to 5/1/2009 6:32:00 AM.
'       Converted '05/01/2009 06:32' to 5/1/2009 6:32:00 AM.
'       Converted '05/01/2009 06:32:00 PM' to 5/1/2009 6:32:00 PM.
'       Converted '05/01/2009 06:32:00' to 5/1/2009 6:32:00 AM.

注釈

DateTime.TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) メソッドは、formats パラメーターに割り当てられているパターンのいずれかに一致する日付の文字列形式を解析します。これは DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles) メソッドに似ていますが、変換が失敗した場合、TryParseExact メソッドは例外をスローしません。

s パラメーターには、解析する日時が含まれます。 s パラメーターに時刻のみが含まれ、日付がない場合は、style パラメーターに DateTimeStyles.NoCurrentDateDefault フラグが含まれている場合を除き、現在の日付が使用されます。この場合、既定の日付 (DateTime.Date.MinValue) が使用されます。 s パラメーターに日付のみが含まれており、時刻がない場合は、午前 0 時 (00:00:00) が使用されます。 style パラメーターは、s パラメーターに、formatsのいずれかの書式指定文字列で許可されている空白文字以外の先頭、内側、または末尾の空白文字を含めることができるかどうかを決定します。

formats パラメーターにはパターンの配列が含まれています。そのうちの 1 つは、解析操作が成功する場合に s 正確に一致する必要があります。 formats パラメーターのパターンは、カスタム日時書式指定文字列テーブルの 1 つ以上のカスタム書式指定子、または標準日時書式指定文字列テーブルから定義済みのパターンを識別する 1 つの標準書式指定子で構成されます。

sの解釈に使用するカルチャを表す CultureInfo オブジェクト。 DateTimeFormat プロパティによって返される DateTimeFormatInfo オブジェクトは、sでシンボルと書式設定を定義します。
日付と時刻のデータの形式を定義する DateTimeFormatInfo オブジェクト。
GetFormat メソッドが CultureInfo オブジェクトまたは書式設定情報を提供する DateTimeFormatInfo オブジェクトを返すカスタム IFormatProvider 実装。

provider が nullされている場合は、現在のカルチャに対応する CultureInfo オブジェクトが使用されます。

styles パラメーターには、format によって定義されていない空白を s に表示できるかどうかを決定し、解析操作の正確な動作を制御する、DateTimeStyles 列挙体の 1 つ以上のメンバーが含まれます。次の表では、DateTimeStyles 列挙体の各メンバーが、TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) メソッドの操作にどのように影響するかを説明します。

DateTimeStyles メンバー	形容
AdjustToUniversal	`s` を解析し、必要に応じて UTC に変換します。 `s` にタイムゾーンオフセットが含まれている場合、または `s` にタイムゾーン情報が含まれているが、`styles` に DateTimeStyles.AssumeLocal フラグが含まれている場合、メソッドは文字列を解析し、ToUniversalTime を呼び出して返された DateTime 値を UTC に変換し、Kind プロパティを DateTimeKind.Utcに設定します。 `s` が UTC を表していることを示す場合、または `s` にタイムゾーン情報が含まれていないが、DateTimeStyles.AssumeUniversal フラグが含まれている `styles` 場合、メソッドは文字列を解析し、返された DateTime 値に対してタイムゾーン変換を実行せず、Kind プロパティを DateTimeKind.Utcに設定します。それ以外の場合は、フラグは無効です。
AllowInnerWhite	`format` で定義されていない空白を個々の日付または時刻要素の間に表示できることを指定します。
AllowLeadingWhite	`format` で定義されていない空白を `s`の先頭に表示できることを指定します。
AllowTrailingWhite	`format` で定義されていない空白を `s`の末尾に表示できることを指定します。
AllowWhiteSpaces	`s` に、`format`で定義されていない先頭、内側、および末尾の空白を含めることができます。
AssumeLocal	`s` にタイムゾーン情報がない場合は、現地時刻を表すと見なされることを指定します。 DateTimeStyles.AdjustToUniversal フラグが存在しない限り、返される DateTime 値の Kind プロパティは DateTimeKind.Localに設定されます。
AssumeUniversal	`s` にタイムゾーン情報がない場合は、UTC を表すと見なされることを指定します。 DateTimeStyles.AdjustToUniversal フラグが存在しない限り、メソッドは返された DateTime 値を UTC から現地時刻に変換し、Kind プロパティを DateTimeKind.Localに設定します。
NoCurrentDateDefault	`s` に日付情報のない時刻が含まれている場合、戻り値の日付は `DateTime.MinValue.Date`に設定されます。
None	`s` パラメーターは、既定値を使用して解析されます。 `format` に存在する空白以外の空白は使用できません。 `s` に日付コンポーネントがない場合、返される DateTime 値の日付は 1/1/0001 に設定されます。タイムゾーン情報 `s` 含まない場合、返される DateTime オブジェクトの Kind プロパティは DateTimeKind.Unspecifiedに設定されます。タイムゾーン情報が `s`に存在する場合、時刻は現地時刻に変換され、返された DateTime オブジェクトの Kind プロパティは DateTimeKind.Localに設定されます。
RoundtripKind	タイムゾーン情報を含む文字列の場合は、Kind プロパティが DateTimeKind.Localに設定された DateTime 値への変換を回避します。このフラグは、主に UTC 時刻から現地時刻への変換を禁止します。

注意 (呼び出し元)

こちらもご覧ください

ParseExact
CultureInfo
DateTimeFormatInfo
.NET Framework での日付と時刻の文字列の解析の
標準の日時書式指定文字列をする
カスタム日時書式指定文字列をする

適用対象

次の方法で共有

DateTime.TryParseExact メソッド

定義

オーバーロード

注釈

TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)

パラメーター

戻り値

適用対象

TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime)

パラメーター

戻り値

適用対象

TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)

パラメーター

戻り値

例外

例

注釈

注意 (呼び出し元)

こちらもご覧ください

適用対象

TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)

パラメーター

戻り値

例外

例

注釈

注意 (呼び出し元)

こちらもご覧ください

適用対象

その他のリソース