DateTime.ParseExact DateTime.ParseExact DateTime.ParseExact DateTime.ParseExact Method

定義

指定した文字列形式の日付と時刻を等価の DateTime の値に変換します。Converts the specified string representation of a date and time to its DateTime equivalent. 文字列形式の書式は、指定した書式と完全に一致する必要があります。それ以外の場合は、例外がスローされます。The format of the string representation must match a specified format exactly or an exception is thrown.

オーバーロード

ParseExact(String, String, IFormatProvider) ParseExact(String, String, IFormatProvider) ParseExact(String, String, IFormatProvider) ParseExact(String, String, IFormatProvider)

指定した書式とカルチャ固有の書式情報を使用して、指定した日付と時刻の文字列形式を等価の DateTime の値に変換します。Converts the specified string representation of a date and time to its DateTime equivalent using the specified format and culture-specific format information. 文字列形式の書式は、指定した書式と完全に一致する必要があります。The format of the string representation must match the specified format exactly.

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

指定した書式、カルチャ固有の書式情報、およびスタイルを使用して、指定した日付と時刻の文字列形式を等価の DateTime に変換します。Converts the specified string representation of a date and time to its DateTime equivalent using the specified format, culture-specific format information, and style. 文字列形式の書式は、指定した書式と完全に一致する必要があります。それ以外の場合は、例外がスローされます。The format of the string representation must match the specified format exactly or an exception is thrown.

ParseExact(String, String[], IFormatProvider, DateTimeStyles) ParseExact(String, String[], IFormatProvider, DateTimeStyles) ParseExact(String, String[], IFormatProvider, DateTimeStyles) ParseExact(String, String[], IFormatProvider, DateTimeStyles)

指定した書式の配列、カルチャ固有の書式情報、およびスタイルを使用して、指定した日付と時刻の文字列形式を等価の DateTime に変換します。Converts the specified string representation of a date and time to its DateTime equivalent using the specified array of formats, culture-specific format information, and style. 文字列形式の書式は、指定した書式の少なくとも 1 つと完全に一致する必要があります。それ以外の場合は、例外がスローされます。The format of the string representation must match at least one of the specified formats exactly or an exception is thrown.

注釈

重要

和暦の時代 (年号) は天皇の代に基づいているため、変更されることが予想されます。Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. たとえば、JapaneseCalendarJapaneseLunisolarCalendar において、2019 年 5 月 1 日から令和時代が始まることになりました。For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. このような時代 (年号) の変更は、これらのカレンダーを使用するすべてのアプリケーションに影響します。Such a change of era affects all applications that use these calendars. 詳細については「.NET での日本語のカレンダーの新しい時代」をご覧いただき、アプリケーションが影響を受けるかどうかを判断します。See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. 日本語の時代の変更のためのアプリケーションの準備」をご覧いただき、時代の変更に対する状況を確認するために Windows システムでアプリケーションをテストします。See Prepare your application for the Japanese era change for information on testing your applications on Windows systems to ensure their readiness for the era change. 複数の時代 (年号) を含むカレンダーをサポートしている .NET の機能や、複数の時代 (年号) をサポートしているカレンダーを操作する際のベスト プラクティスについては、「Working with eras (時代 (年号) の操作)」をご覧ください。See Working with eras for features in .NET that support calendars with multiple eras and for best practices when working with calendars that support multiple eras.

ParseExact(String, String, IFormatProvider) ParseExact(String, String, IFormatProvider) ParseExact(String, String, IFormatProvider) ParseExact(String, String, IFormatProvider)

指定した書式とカルチャ固有の書式情報を使用して、指定した日付と時刻の文字列形式を等価の DateTime の値に変換します。Converts the specified string representation of a date and time to its DateTime equivalent using the specified format and culture-specific format information. 文字列形式の書式は、指定した書式と完全に一致する必要があります。The format of the string representation must match the specified format exactly.

public:
 static DateTime ParseExact(System::String ^ s, System::String ^ format, IFormatProvider ^ provider);
public static DateTime ParseExact (string s, string format, IFormatProvider provider);
static member ParseExact : string * string * IFormatProvider -> DateTime
Public Shared Function ParseExact (s As String, format As String, provider As IFormatProvider) As DateTime

パラメーター

s
String String String String

変換する日時を含む文字列。A string that contains a date and time to convert.

format
String String String String

s の必要な形式を定義する形式指定子。A format specifier that defines the required format of s. 詳細については、「解説」を参照してください。For more information, see the Remarks section.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

s に関するカルチャ固有の書式情報を提供するオブジェクト。An object that supplies culture-specific format information about s.

戻り値

format および provider で指定された書式に従って表記された s に含まれる日時と等価のオブジェクト。An object that is equivalent to the date and time contained in s, as specified by format and provider.

例外

s または formatnull です。s or format is null.

s または format が空の文字列です。s or format is an empty string.

- または --or- s に、format で指定されているパターンに対応する日付と時刻が含まれていません。s does not contain a date and time that corresponds to the pattern specified in format.

- または --or- s の時間の部分と AM/PM 指定子が一致していません。The hour component and the AM/PM designator in s do not agree.

次の例で、ParseExactメソッド。The following example demonstrates the ParseExact method.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string dateString, format;  
      DateTime result;
      CultureInfo provider = CultureInfo.InvariantCulture;

      // Parse date-only value with invariant culture.
      dateString = "06/15/2008";
      format = "d";
      try {
         result = DateTime.ParseExact(dateString, format, provider);
         Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
      }
      catch (FormatException) {
         Console.WriteLine("{0} is not in the correct format.", dateString);
      } 

      // Parse date-only value without leading zero in month using "d" format.
      // Should throw a FormatException because standard short date pattern of 
      // invariant culture requires two-digit month.
      dateString = "6/15/2008";
      try {
         result = DateTime.ParseExact(dateString, format, provider);
         Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
      }
      catch (FormatException) {
         Console.WriteLine("{0} is not in the correct format.", dateString);
      }
      
      // Parse date and time with custom specifier.
      dateString = "Sun 15 Jun 2008 8:30 AM -06:00";
      format = "ddd dd MMM yyyy h:mm tt zzz";
      try {
         result = DateTime.ParseExact(dateString, format, provider);
         Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
      }
      catch (FormatException) {
         Console.WriteLine("{0} is not in the correct format.", dateString);
      }
      
      // Parse date and time with offset but without offset's minutes.
      // Should throw a FormatException because "zzz" specifier requires leading  
      // zero in hours.
      dateString = "Sun 15 Jun 2008 8:30 AM -06";
      try {
         result = DateTime.ParseExact(dateString, format, provider);
         Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
      }   
      catch (FormatException) {
         Console.WriteLine("{0} is not in the correct format.", dateString);
      } 
      
      dateString = "15/06/2008 08:30";
      format = "g";
      provider = new CultureInfo("fr-FR");
      try {
         result = DateTime.ParseExact(dateString, format, provider);
         Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
      }   
      catch (FormatException) {
         Console.WriteLine("{0} is not in the correct format.", dateString);
      } 

      // Parse a date that includes seconds and milliseconds
      // by using the French (France) and invariant cultures.
      dateString = "18/08/2015 06:30:15.006542";
      format = "dd/MM/yyyy HH:mm:ss.ffffff";
      try {
         result = DateTime.ParseExact(dateString, format, provider);
         Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
      }
      catch (FormatException) {
         Console.WriteLine("{0} is not in the correct format.", dateString);
      }
   }
}
// The example displays the following output:
//       06/15/2008 converts to 6/15/2008 12:00:00 AM.
//       6/15/2008 is not in the correct format.
//       Sun 15 Jun 2008 8:30 AM -06:00 converts to 6/15/2008 7:30:00 AM.
//       Sun 15 Jun 2008 8:30 AM -06 is not in the correct format.
//       15/06/2008 08:30 converts to 6/15/2008 8:30:00 AM.
//       18/08/2015 06:30:15.006542 converts to 8/18/2015 6:30:15 AM.
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim dateString, format As String  
      Dim result As Date
      Dim provider As CultureInfo = CultureInfo.InvariantCulture

      ' Parse date-only value with invariant culture.
      dateString = "06/15/2008"
      format = "d"
      Try
         result = Date.ParseExact(dateString, format, provider)
         Console.WriteLine("{0} converts to {1}.", dateString, result.ToString())
      Catch e As FormatException
         Console.WriteLine("{0} is not in the correct format.", dateString)
      End Try 

      ' Parse date-only value without leading zero in month using "d" format.
      ' Should throw a FormatException because standard short date pattern of 
      ' invariant culture requires two-digit month.
      dateString = "6/15/2008"
      Try
         result = Date.ParseExact(dateString, format, provider)
         Console.WriteLine("{0} converts to {1}.", dateString, result.ToString())
      Catch e As FormatException
         Console.WriteLine("{0} is not in the correct format.", dateString)
      End Try 
      
      ' Parse date and time with custom specifier.
      dateString = "Sun 15 Jun 2008 8:30 AM -06:00"
      format = "ddd dd MMM yyyy h:mm tt zzz"        
      Try
         result = Date.ParseExact(dateString, format, provider)
         Console.WriteLine("{0} converts to {1}.", dateString, result.ToString())
      Catch e As FormatException
         Console.WriteLine("{0} is not in the correct format.", dateString)
      End Try 
      
      ' Parse date and time with offset but without offset's minutes.
      ' Should throw a FormatException because "zzz" specifier requires leading  
      ' zero in hours.
      dateString = "Sun 15 Jun 2008 8:30 AM -06"
      Try
         result = Date.ParseExact(dateString, format, provider)
         Console.WriteLine("{0} converts to {1}.", dateString, result.ToString())
      Catch e As FormatException
         Console.WriteLine("{0} is not in the correct format.", dateString)
      End Try 
      
      ' Parse a date string using the French (France) culture.
      dateString = "15/06/2008 08:30"
      format = "g"
      provider = New CultureInfo("fr-FR")
      Try
         result = Date.ParseExact(dateString, format, provider)
         Console.WriteLine("{0} converts to {1}.", dateString, result.ToString())
      Catch e As FormatException
         Console.WriteLine("{0} is not in the correct format.", dateString)
      End Try

      ' Parse a date that includes seconds and milliseconds
      ' by using the French (France) and invariant cultures.
      dateString = "18/08/2015 06:30:15.006542"
      format = "dd/MM/yyyy HH:mm:ss.ffffff"
      Try
         result = Date.ParseExact(dateString, format, provider)
         Console.WriteLine("{0} converts to {1}.", dateString, result.ToString())
      Catch e As FormatException
         Console.WriteLine("{0} is not in the correct format.", dateString)
      End Try
   End Sub
End Module
' The example displays the following output:
'       06/15/2008 converts to 6/15/2008 12:00:00 AM.
'       6/15/2008 is not in the correct format.
'       Sun 15 Jun 2008 8:30 AM -06:00 converts to 6/15/2008 7:30:00 AM.
'       Sun 15 Jun 2008 8:30 AM -06 is not in the correct format.
'       15/06/2008 08:30 converts to 6/15/2008 8:30:00 AM.
'       18/08/2015 06:30:15.006542 converts to 8/18/2015 6:30:15 AM.

注釈

DateTime.ParseExact(String, String, IFormatProvider)メソッドで定義された書式である必要があります日付の文字列表現を解析し、formatパラメーター。The DateTime.ParseExact(String, String, IFormatProvider) method parses the string representation of a date, which must be in the format defined by the format parameter. 必要、<日付 > と<時間 > で指定された順序で表示される日付と時刻の文字列形式の要素format、およびsで許可されている以外の空白があるないですformatIt also requires that the <Date> and <Time> elements of the string representation of a date and time appear in the order specified by format, and that s have no white space other than that permitted by format. 場合format日付を定義します。 時刻要素がないと、解析操作が成功した結果DateTime値が午前 0 時 (00: 00:00)。If format defines a date with no time element and the parse operation succeeds, the resulting DateTime value has a time of midnight (00:00:00). 場合format、時間を定義する日付要素がないと、解析操作が成功すると、結果DateTime値が日付DateTime.Now.Dateします。If format defines a time with no date element and the parse operation succeeds, the resulting DateTime value has a date of DateTime.Now.Date.

場合sが成功すると、特定のタイム ゾーンと、解析操作の時刻を表していない、 Kind 、返されたプロパティDateTime値はDateTimeKind.Unspecifiedします。If s does not represent a time in a particular time zone and the parse operation succeeds, the Kind property of the returned DateTime value is DateTimeKind.Unspecified. 場合sわけでは、特定のタイム ゾーンの時刻とformat存在するタイム ゾーン情報は、(場合など、 format "o"、"r"または"u"標準書式指定子は、"z"、"zz"または"zzz"が含まれている場合、またはカスタム書式指定子の場合)、 Kind 、返されたプロパティDateTime値はDateTimeKind.Localします。If s does represent the time in a particular time zone and format allows time zone information to be present (for example, if format is equal to the "o", "r", or "u" standard format specifiers, or if it contains the "z", "zz", or "zzz" custom format specifiers), the Kind property of the returned DateTime value is DateTimeKind.Local.

formatパラメーターは、1 つの標準書式指定子、または必要な書式を定義する 1 つまたは複数のカスタム書式指定子を含む文字列sします。The format parameter is a string that contains either a single standard format specifier, or one or more custom format specifiers that define the required format of s. 詳細については、有効な書式設定コードは、次を参照してください。 Standard Date and Time Format StringsまたはCustom Date and Time Format Stringsします。For details about valid formatting codes, see Standard Date and Time Format Strings or Custom Date and Time Format Strings.

注意

場合formatされません ("yyyyMMddHHmm") などの日付または時刻の区切り記号を含めるのインバリアント カルチャを使用するカスタム書式パターンには、providerパラメーターおよび各カスタムの最も長い形式の書式指定子。If format is a custom format pattern that does not include date or time separators (such as "yyyyMMddHHmm"), use the invariant culture for the provider parameter and the widest form of each custom format specifier. たとえば、書式パターンに時間を指定する場合は、"H"狭義の形式ではなくより多くのフォーム"HH"を指定します。For example, if you want to specify hours in the format pattern, specify the wider form, "HH", instead of the narrower form, "H".

特定の日付と時刻のシンボルとで使用される特定の言語で曜日の名前) などの文字列sによって定義されます、providerパラメーターの正確な形式はs場合formatは標準的な形式です。指定子の文字列。The particular date and time symbols and strings (such as names of the days of the week in a particular language) used in s are defined by the provider parameter, as is the precise format of s if format is a standard format specifier string. providerパラメーターには、次のいずれかを指定できます。The provider parameter can be any of the following:

場合providernullCultureInfo現在のカルチャに対応するオブジェクトを使用します。If provider is null, the CultureInfo object that corresponds to the current culture is used.

注意 (呼び出し元)

.NET Framework 4.NET Framework 4ParseExactメソッドがスローされます、FormatException解析する文字列が、時間の部分と契約に含まれていない AM/PM 指定子を含むかどうか。In the .NET Framework 4.NET Framework 4, the ParseExact method throws a FormatException if the string to be parsed contains an hour component and an AM/PM designator that are not in agreement. .NET Framework 3.5.NET Framework 3.5と以前のバージョン、AM/PM 指定子は無視されます。In the .NET Framework 3.5.NET Framework 3.5 and earlier versions, the AM/PM designator is ignored.

こちらもご覧ください

ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

public static DateTime ParseExact (ReadOnlySpan<char> s, ReadOnlySpan<char> format, IFormatProvider provider, System.Globalization.DateTimeStyles style = System.Globalization.DateTimeStyles.None);
static member ParseExact : ReadOnlySpan<char> * ReadOnlySpan<char> * IFormatProvider * System.Globalization.DateTimeStyles -> DateTime
Public Shared Function ParseExact (s As ReadOnlySpan(Of Char), format As ReadOnlySpan(Of Char), provider As IFormatProvider, Optional style As DateTimeStyles = System.Globalization.DateTimeStyles.None) As DateTime

パラメーター

format
ReadOnlySpan<Char>

戻り値

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

public static DateTime ParseExact (ReadOnlySpan<char> s, string[] formats, IFormatProvider provider, System.Globalization.DateTimeStyles style = System.Globalization.DateTimeStyles.None);
static member ParseExact : ReadOnlySpan<char> * string[] * IFormatProvider * System.Globalization.DateTimeStyles -> DateTime
Public Shared Function ParseExact (s As ReadOnlySpan(Of Char), formats As String(), provider As IFormatProvider, Optional style As DateTimeStyles = System.Globalization.DateTimeStyles.None) As DateTime

パラメーター

formats
String[]

戻り値

ParseExact(String, String, IFormatProvider, DateTimeStyles) ParseExact(String, String, IFormatProvider, DateTimeStyles) ParseExact(String, String, IFormatProvider, DateTimeStyles) ParseExact(String, String, IFormatProvider, DateTimeStyles)

指定した書式、カルチャ固有の書式情報、およびスタイルを使用して、指定した日付と時刻の文字列形式を等価の DateTime に変換します。Converts the specified string representation of a date and time to its DateTime equivalent using the specified format, culture-specific format information, and style. 文字列形式の書式は、指定した書式と完全に一致する必要があります。それ以外の場合は、例外がスローされます。The format of the string representation must match the specified format exactly or an exception is thrown.

public:
 static DateTime ParseExact(System::String ^ s, System::String ^ format, IFormatProvider ^ provider, System::Globalization::DateTimeStyles style);
public static DateTime ParseExact (string s, string format, IFormatProvider provider, System.Globalization.DateTimeStyles style);
static member ParseExact : string * string * IFormatProvider * System.Globalization.DateTimeStyles -> DateTime
Public Shared Function ParseExact (s As String, format As String, provider As IFormatProvider, style As DateTimeStyles) As DateTime

パラメーター

s
String String String String

変換する日付と時刻を格納した文字列。A string containing a date and time to convert.

format
String String String String

s の必要な形式を定義する形式指定子。A format specifier that defines the required format of s. 詳細については、「解説」を参照してください。For more information, see the Remarks section.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

s に関するカルチャ固有の書式情報を提供するオブジェクト。An object that supplies culture-specific formatting information about s.

style
DateTimeStyles DateTimeStyles DateTimeStyles DateTimeStyles

ss に指定できるスタイル要素、または s から DateTime 値への変換に関する追加情報を提供する列挙値のビットごとの組み合わせ。A bitwise combination of the enumeration values that provides additional information about s, about style elements that may be present in s, or about the conversion from s to a DateTime value. 通常指定する値は、None です。A typical value to specify is None.

戻り値

formatprovider、および style で指定された書式に従って表記された s に含まれる日時と等価のオブジェクト。An object that is equivalent to the date and time contained in s, as specified by format, provider, and style.

例外

s または formatnull です。s or format is null.

s または format が空の文字列です。s or format is an empty string.

または-or- s に、format で指定されているパターンに対応する日付と時刻が含まれていません。s does not contain a date and time that corresponds to the pattern specified in format.

または-or- s の時間の部分と AM/PM 指定子が一致していません。The hour component and the AM/PM designator in s do not agree.

styleDateTimeStyles 値の正しくない組み合わせが含まれています。style contains an invalid combination of DateTimeStyles values. たとえば、AssumeLocalAssumeUniversal の両方です。For example, both AssumeLocal and AssumeUniversal.

次の例で、ParseExact(String, String, IFormatProvider)メソッド。The following example demonstrates the ParseExact(String, String, IFormatProvider) method. なお、文字列"5/01/2009 8時 30分 AM"ことはできませんが正常に解析されたときに、stylesパラメーターと等しいDateTimeStyles.Noneでは、先頭のスペースは許可されていないため、formatします。Note that the string " 5/01/2009 8:30 AM" cannot be parsed successfully when the styles parameter equals DateTimeStyles.None because leading spaces are not allowed by format. 文字列ではさらに、"5/01/2009 09時 00分"を正常に解析されたことはできません、formatの"MM dd/yyyyhh:mm"日付文字列としての先頭をゼロ、1 か月の数の前はためformatが必要です。Additionally, the string "5/01/2009 09:00" cannot be parsed successfully with a format of "MM/dd/yyyyhh:mm" because the date string does not precede the month number with a leading zero, as format requires.

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";
      try {
         dateValue = DateTime.ParseExact(dateString, "g", enUS, DateTimeStyles.None);
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, 
                           dateValue.Kind);
      }                           
      catch (FormatException) {
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);
      }
      // Allow a leading space in the date string.
      try {
         dateValue = DateTime.ParseExact(dateString, "g", enUS, DateTimeStyles.AllowLeadingWhite);
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, 
                           dateValue.Kind);
      }                           
      catch (FormatException) {
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);
      }
      
      // Use custom formats with M and MM.
      dateString = "5/01/2009 09:00";
      try {
         dateValue = DateTime.ParseExact(dateString, "M/dd/yyyy hh:mm", enUS, DateTimeStyles.None);
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, 
                           dateValue.Kind);
      }                           
      catch (FormatException) {
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);
      }
      // Allow a leading space in the date string.
      try {
         dateValue = DateTime.ParseExact(dateString, "MM/dd/yyyy hh:mm", enUS, DateTimeStyles.None);
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, 
                           dateValue.Kind);
      }                           
      catch (FormatException) {
         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"; 
      try {
         dateValue = DateTime.ParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS, DateTimeStyles.None);
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, 
                           dateValue.Kind);
      }                           
      catch (FormatException) {
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);
      }
      // Allow a leading space in the date string.
      try {
         dateValue = DateTime.ParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS, 
                                     DateTimeStyles.AdjustToUniversal);
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, 
                           dateValue.Kind);
      }                           
      catch (FormatException) {
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);
      }
           
      // Parse a string representing UTC.
      dateString = "2008-06-11T16:11:20.0904778Z";
      try {
         dateValue = DateTime.ParseExact(dateString, "o", CultureInfo.InvariantCulture, 
                                     DateTimeStyles.None);
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, 
                           dateValue.Kind);
      }                           
      catch (FormatException) {
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);
      }
      try {
         dateValue = DateTime.ParseExact(dateString, "o", CultureInfo.InvariantCulture, 
                                     DateTimeStyles.RoundtripKind);
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, 
                           dateValue.Kind);
      }                           
      catch (FormatException) {
         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).
Imports System.Globalization

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"
      Try
         dateValue = Date.ParseExact(dateString, "g", enUS, DateTimeStyles.None)
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Catch e As FormatException
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End Try
      ' Allow a leading space in the date string.
      Try
         dateValue = Date.ParseExact(dateString, "g", enUS, DateTimeStyles.AllowLeadingWhite)
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Catch e As FormatException
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End Try
      
      ' Use custom formats with M and MM.
      dateString = "5/01/2009 09:00"
      Try
         dateValue = Date.ParseExact(dateString, "M/dd/yyyy hh:mm", enUS, DateTimeStyles.None)
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Catch e As FormatException
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End Try
      ' Allow a leading space in the date string.
      Try
         dateValue = Date.ParseExact(dateString, "MM/dd/yyyy hh:mm", enUS, DateTimeStyles.None)
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Catch e As FormatException
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End Try

      ' Parse a string with time zone information.
      dateString = "05/01/2009 01:30:42 PM -05:00" 
      Try
         dateValue = Date.ParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS, DateTimeStyles.None)
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Catch e As FormatException
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End Try
      ' Allow a leading space in the date string.
      Try
         dateValue = Date.ParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS, _
                                     DateTimeStyles.AdjustToUniversal)
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Catch e As FormatException
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End Try
           
      ' Parse a string representing UTC.
      dateString = "2008-06-11T16:11:20.0904778Z"
      Try
         dateValue = Date.ParseExact(dateString, "o", CultureInfo.InvariantCulture, _
                                     DateTimeStyles.None)
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Catch e As FormatException
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End Try
      Try
         dateValue = Date.ParseExact(dateString, "o", CultureInfo.InvariantCulture, _
                                     DateTimeStyles.RoundtripKind)
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Catch e As FormatException
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End Try
   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.ParseExact(String, String, IFormatProvider, DateTimeStyles)メソッドで定義された書式である必要があります日付の文字列表現を解析し、formatパラメーター。The DateTime.ParseExact(String, String, IFormatProvider, DateTimeStyles) method parses the string representation of a date, which must be in a format defined by the format parameter. 必要で、日付と時刻の要素sで指定された順序で表示されるformatします。It also requires that the date and time elements in s appear in the order specified by format. 場合sのパターンに一致しない、formatによって定義されたすべてのバリエーションのパラメーター、styleパラメーター、メソッドはスロー、FormatExceptionします。If s does not match the pattern of the format parameter, with any variations defined by the style parameter, the method throws a FormatException. これに対し、DateTime.Parse(String, IFormatProvider, DateTimeStyles)メソッドは、書式プロバイダーのによって認識される形式のいずれかの日付の文字列表現を解析しDateTimeFormatInfoオブジェクト。In contrast, the DateTime.Parse(String, IFormatProvider, DateTimeStyles) method parses the string representation of a date in any one of the formats recognized by the format provider's DateTimeFormatInfo object. DateTime.Parse(String, IFormatProvider, DateTimeStyles)メソッドで日付と時刻要素こともできますsを任意の順序で表示します。The DateTime.Parse(String, IFormatProvider, DateTimeStyles) method also allows the date and time elements in s to appear in any order.

場合、sパラメーターに時刻のみが含まれ、日なししない限り、現在の日付が使用される、styleパラメーターが含まれる、DateTimeStyles.NoCurrentDateDefaultフラグ場合、既定の日付 (DateTime.Date.MinValue) 使用されます。If the s parameter contains only a time and no date, the current date is used unless the style parameter includes the DateTimeStyles.NoCurrentDateDefault flag, in which case the default date (DateTime.Date.MinValue) is used. 場合、sパラメーターが含まれるは、日付のみといいえ時、午前 0 時 (00: 00:00) が使用されます。If the s parameter contains only a date and no time, midnight (00:00:00) is used. styleパラメーターも決定するかどうか、sパラメーターは、先頭、内部、または末尾の空白文字を含めることができます。The style parameter also determines whether the s parameter can contain leading, inner, or trailing white space characters.

場合sタイム ゾーンの情報が含まれていない、 Kind 、返されたプロパティDateTimeオブジェクトがDateTimeKind.Unspecifiedします。If s contains no time zone information, the Kind property of the returned DateTime object is DateTimeKind.Unspecified. 使用してこの動作を変更することができます、DateTimeStyles.AssumeLocalフラグ、返された、DateTimeKindプロパティはDateTimeKind.Local、またはを使用して、DateTimeStyles.AssumeUniversalDateTimeStyles.AdjustToUniversalフラグ、返された、DateTimeKindプロパティはDateTimeKind.Utcします。This behavior can be changed by using the DateTimeStyles.AssumeLocal flag, which returns a DateTime value whose Kind property is DateTimeKind.Local, or by using the DateTimeStyles.AssumeUniversal and DateTimeStyles.AdjustToUniversal flags, which returns a DateTime value whose Kind property is DateTimeKind.Utc. 場合s、タイム ゾーン情報を含む、時刻は、必要に応じて、現地時刻に変換されます、 Kind 、返されたプロパティDateTimeにオブジェクトが設定されているDateTimeKind.Localします。If s contains time zone information, the time is converted to local time, if necessary, and the Kind property of the returned DateTime object is set to DateTimeKind.Local. 使用してこの動作を変更することができます、DateTimeStyles.RoundtripKindフラグを設定して、現地時刻を世界協定時刻 (UTC) の変換を行わない、KindプロパティをDateTimeKind.Utcします。This behavior can be changed by using the DateTimeStyles.RoundtripKind flag to not convert Coordinated Universal Time (UTC) to a local time and to set the Kind property to DateTimeKind.Utc.

formatの必要なパターンを定義するパラメーター、sパラメーター。The format parameter defines the required pattern of the s parameter. 1 つまたは複数のいずれかのカスタム書式指定子で構成されていることができます、カスタム Date and Time Format Stringsテーブル、またはから定義済みのパターンを識別する 1 つの標準書式指定子、標準の日付と時刻の書式指定文字列テーブル。It can consist of either one or more custom format specifiers from the Custom Date and Time Format Strings table, or a single standard format specifier, which identifies a predefined pattern, from the Standard Date and Time Format Strings table.

カスタム書式パターンでは日付または時刻の区切り記号を使用しない場合は、インバリアント カルチャを使用して、providerパラメーターおよび各カスタムの最も長い形式の書式指定子。If you do not use date or time separators in a custom format pattern, use the invariant culture for the provider parameter and the widest form of each custom format specifier. たとえば、パターンに時間を指定する場合は、"H"狭義の形式ではなくより多くのフォーム"HH"を指定します。For example, if you want to specify hours in the pattern, specify the wider form, "HH", instead of the narrower form, "H".

注意

必要とするのではなくs解析操作が成功するための 1 つの形式に準拠して、呼び出すことができます、DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles)メソッドと、許可されている複数の形式を指定します。Rather than requiring that s conform to a single format for the parse operation to succeed, you can call the DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles) method and specify multiple permitted formats. これにより、解析操作が成功する可能性が高くなります。This makes the parse operation more likely to succeed.

stylesパラメーターには 1 つまたは複数のメンバーが含まれています、DateTimeStylesかどうかと、空白文字で定義されていないかを決定する列挙体formatに表示できるs解析操作の正確な動作を制御します。The styles parameter includes one or more members of the DateTimeStyles enumeration that determine whether and where white space not defined by format can appear in s and that control the precise behavior of the parse operation. 次の表をそれぞれどのように説明のメンバー、DateTimeStyles列挙型の運用に与える影響、ParseExact(String, String, IFormatProvider, DateTimeStyles)メソッド。The following table describes how each member of the DateTimeStyles enumeration affects the operation of the ParseExact(String, String, IFormatProvider, DateTimeStyles) method.

DateTimeStyles メンバーDateTimeStyles member 説明Description
AdjustToUniversal 解析sと、必要に応じて、UTC に変換します。Parses s and, if necessary, converts it to UTC. 場合s、タイム ゾーン オフセットが含まれて 場合sタイム ゾーン情報が含まれていないが、stylesが含まれています、DateTimeStyles.AssumeLocalフラグは、メソッド呼び出し、文字列を解析してToUniversalTime、返されたに変換するDateTime値を UTC にを設定し、KindプロパティをDateTimeKind.Utcします。If s includes a time zone offset, or if s contains no time zone information but styles includes the DateTimeStyles.AssumeLocal flag, the method parses the string, calls ToUniversalTime to convert the returned DateTime value to UTC, and sets the Kind property to DateTimeKind.Utc. 場合sUTC で表すことを示す場合、またはsタイム ゾーン情報は含まれませんが、stylesが含まれています、DateTimeStyles.AssumeUniversalフラグは、メソッド、文字列を解析して、返されたのタイム ゾーンの変換は行われませんDateTime値、およびセット、KindプロパティをDateTimeKind.Utcします。If s indicates that it represents UTC, or if s does not contain time zone information but styles includes the DateTimeStyles.AssumeUniversal flag, the method parses the string, performs no time zone conversion on the returned DateTime value, and sets the Kind property to DateTimeKind.Utc. その他のすべてのケースでは、フラグには影響はありません。In all other cases, the flag has no effect.
AllowInnerWhite 定義されていない、空白文字を指定しますformat任意の個々 の日付または時刻の要素の間に表示できます。Specifies that white space not defined by format can appear between any individual date or time element.
AllowLeadingWhite 定義されていない、空白文字を指定しますformatの先頭に表示できるsします。Specifies that white space not defined by format can appear at the beginning of s.
AllowTrailingWhite 定義されていない、空白文字を指定しますformatの末尾に記述できるsします。Specifies that white space not defined by format can appear at the end of s.
AllowWhiteSpaces 指定しますs先頭、内部、および末尾の空白で定義されていない場合がありますformatします。Specifies that s may contain leading, inner, and trailing white spaces not defined by format.
AssumeLocal 場合を指定しますsのタイム ゾーン情報がない、現地時刻を表すと見なされます。Specifies that if s lacks any time zone information, it is assumed to represent a local time. しない限り、DateTimeStyles.AdjustToUniversalフラグが存在する、 Kind 、返されたプロパティDateTime値に設定されてDateTimeKind.Localします。Unless the DateTimeStyles.AdjustToUniversal flag is present, the Kind property of the returned DateTime value is set to DateTimeKind.Local.
AssumeUniversal 指定された場合s任意のタイム ゾーン情報が不足しています utc と見なされます。Specifies that if s lacks any time zone information, it is assumed to represent UTC. しない限り、DateTimeStyles.AdjustToUniversalフラグが存在する、メソッドは、返された変換DateTime値を UTC から現地時刻とセットにそのKindプロパティをDateTimeKind.Localします。Unless the DateTimeStyles.AdjustToUniversal flag is present, the method converts the returned DateTime value from UTC to local time and sets its Kind property to DateTimeKind.Local.
NoCurrentDateDefault 場合sの時刻に設定されている戻り値の日付の日付の情報がないDateTime.MinValue.Dateします。If s contains time without date information, the date of the return value is set to DateTime.MinValue.Date.
None sパラメーターは、既定値を使用して解析されます。The s parameter is parsed using default values. 空白以外に含まれているformatは許可されています。No white space other than that present in format is allowed. 場合s、返された日付、日付部分がないDateTime値は 1/1/0001 を設定します。If s lacks a date component, the date of the returned DateTime value is set to 1/1/0001. 場合sタイム ゾーンの情報が含まれていない、 Kind 、返されたプロパティDateTimeにオブジェクトが設定されているDateTimeKind.Unspecifiedします。If s contains no time zone information, the Kind property of the returned DateTime object is set to DateTimeKind.Unspecified. タイム ゾーン情報が存在する場合s、時刻は現地時刻に変換し、 Kind 、返されたプロパティDateTimeにオブジェクトが設定されているDateTimeKind.Localします。If time zone information is present in s, the time is converted to local time and the Kind property of the returned DateTime object is set to DateTimeKind.Local.
RoundtripKind のタイム ゾーン情報を含む文字列への変換を防止しようとするDateTime値の日付と時刻の使用そのKindプロパティに設定DateTimeKind.Localします。For strings that contain time zone information, tries to prevent the conversion to a DateTime value date and time with its Kind property set to DateTimeKind.Local. 主に、このフラグには、ローカル時刻を UTC 時刻の変換ができないようにします。This flag primarily prevents the conversion of UTC times to local times.

特定の日付と時刻のシンボルとで使用される特定の言語で曜日の名前) などの文字列sによって定義されます、providerパラメーターの正確な形式はs場合formatは標準的な形式です。指定子の文字列。The particular date and time symbols and strings (such as the names of the days of the week in a particular language) used in s are defined by the provider parameter, as is the precise format of s if format is a standard format specifier string. providerパラメーターには、次のいずれかを指定できます。The provider parameter can be any of the following:

場合providernullCultureInfo現在のカルチャに対応するオブジェクトを使用します。If provider is null, the CultureInfo object that corresponds to the current culture is used.

注意 (呼び出し元)

.NET Framework 4.NET Framework 4ParseExactメソッドがスローされます、FormatException解析する文字列が、時間の部分と契約に含まれていない AM/PM 指定子を含むかどうか。In the .NET Framework 4.NET Framework 4, the ParseExact method throws a FormatException if the string to be parsed contains an hour component and an AM/PM designator that are not in agreement. .NET Framework 3.5.NET Framework 3.5と以前のバージョン、AM/PM 指定子は無視されます。In the .NET Framework 3.5.NET Framework 3.5 and earlier versions, the AM/PM designator is ignored.

こちらもご覧ください

ParseExact(String, String[], IFormatProvider, DateTimeStyles) ParseExact(String, String[], IFormatProvider, DateTimeStyles) ParseExact(String, String[], IFormatProvider, DateTimeStyles) ParseExact(String, String[], IFormatProvider, DateTimeStyles)

指定した書式の配列、カルチャ固有の書式情報、およびスタイルを使用して、指定した日付と時刻の文字列形式を等価の DateTime に変換します。Converts the specified string representation of a date and time to its DateTime equivalent using the specified array of formats, culture-specific format information, and style. 文字列形式の書式は、指定した書式の少なくとも 1 つと完全に一致する必要があります。それ以外の場合は、例外がスローされます。The format of the string representation must match at least one of the specified formats exactly or an exception is thrown.

public:
 static DateTime ParseExact(System::String ^ s, cli::array <System::String ^> ^ formats, IFormatProvider ^ provider, System::Globalization::DateTimeStyles style);
public static DateTime ParseExact (string s, string[] formats, IFormatProvider provider, System.Globalization.DateTimeStyles style);
static member ParseExact : string * string[] * IFormatProvider * System.Globalization.DateTimeStyles -> DateTime
Public Shared Function ParseExact (s As String, formats As String(), provider As IFormatProvider, style As DateTimeStyles) As DateTime

パラメーター

s
String String String String

変換する日時を含む文字列。A string that contains a date and time to convert.

formats
String[]

s の許可された形式の配列。An array of allowable formats of s. 詳細については、「解説」を参照してください。For more information, see the Remarks section.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

s に関するカルチャ固有の書式情報を提供するオブジェクト。An object that supplies culture-specific format information about s.

style
DateTimeStyles DateTimeStyles DateTimeStyles DateTimeStyles

s で使用可能な書式を示す、列挙値のビットごとの組み合わせ。A bitwise combination of enumeration values that indicates the permitted format of s. 通常指定する値は、None です。A typical value to specify is None.

戻り値

formatsprovider、および style で指定された書式に従って表記された s に含まれる日時と等価のオブジェクト。An object that is equivalent to the date and time contained in s, as specified by formats, provider, and style.

例外

s または formatsnull です。s or formats is null.

s が空の文字列です。s is an empty string.

または-or- formats の要素は空の文字列です。an element of formats is an empty string.

または-or- s には、 formatsのどの要素に対応する日時も含まれていません。s does not contain a date and time that corresponds to any element of formats.

- または --or- s の時間の部分と AM/PM 指定子が一致していません。The hour component and the AM/PM designator in s do not agree.

styleDateTimeStyles 値の正しくない組み合わせが含まれています。style contains an invalid combination of DateTimeStyles values. たとえば、AssumeLocalAssumeUniversal の両方です。For example, both AssumeLocal and AssumeUniversal.

次の例では、DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles)メソッドを使用できる形式の数値の文字列を正常に解析できることを確認します。The following example uses the DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles) method to ensure that a string in a number of possible formats can be successfully parsed .

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",
                         "MM/d/yyyy HH:mm:ss.ffffff" };
      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",
                              "08/28/2015 16:17:39.125", "08/28/2015 16:17:39.125000" };
      DateTime dateValue;
      
      foreach (string dateString in dateStrings)
      {
         try {
            dateValue = DateTime.ParseExact(dateString, formats, 
                                            new CultureInfo("en-US"), 
                                            DateTimeStyles.None);
            Console.WriteLine("Converted '{0}' to {1}.", dateString, dateValue);
         }
         catch (FormatException) {
            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.
//       Unable to convert '08/28/2015 16:17:39.125' to a date.
//       Converted '08/28/2015 16:17:39.125000' to 8/28/2015 4:17:39 PM.
Imports System.Globalization

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",
                                 "MM/d/yyyy HH:mm:ss.ffffff" }
      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",
                                     "08/28/2015 16:17:39.125", "08/28/2015 16:17:39.125000" }

      Dim dateValue As DateTime
      
      For Each dateString As String In dateStrings
         Try
            dateValue = DateTime.ParseExact(dateString, formats, _
                                            New CultureInfo("en-US"), _
                                            DateTimeStyles.None)
            Console.WriteLine("Converted '{0}' to {1}.", dateString, dateValue)
         Catch e As FormatException
            Console.WriteLine("Unable to convert '{0}' to a date.", dateString)
         End Try                                               
      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.
'       Unable to convert '08/28/2015 16:17:39.125' to a date.
'       Converted '08/28/2015 16:17:39.125000' to 8/28/2015 4:17:39 PM.

注釈

DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles)メソッドに割り当てられているパターンのいずれかに一致する日付の文字列表現を解析し、formatsパラメーター。The DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles) method parses the string representation of a date that matches any one of the patterns assigned to the formats parameter. 場合、文字列sによって定義されたバリエーションのいずれかでこれらのパターンのいずれかと一致しません、stylesパラメーター、メソッドはスロー、FormatExceptionします。If the string s does not match any one of these patterns with any of the variations defined by the styles parameter, the method throws a FormatException. 別に比較するs複数の書式設定パターンになく単一の書式設定パターンでは、このオーバー ロードの動作、DateTime.ParseExact(String, String, IFormatProvider, DateTimeStyles)メソッド。Aside from comparing s to multiple formatting patterns, rather than to a single formatting pattern, this overload behaves identically to the DateTime.ParseExact(String, String, IFormatProvider, DateTimeStyles) method.

sパラメーターには、解析するには、日付と時刻が含まれています。The s parameter contains the date and time to parse. 場合、sパラメーターに時刻のみが含まれ、日なししない限り、現在の日付が使用される、styleパラメーターが含まれる、DateTimeStyles.NoCurrentDateDefaultフラグ場合、既定の日付 (DateTime.Date.MinValue) 使用されます。If the s parameter contains only a time and no date, the current date is used unless the style parameter includes the DateTimeStyles.NoCurrentDateDefault flag, in which case the default date (DateTime.Date.MinValue) is used. 場合、sパラメーターが含まれるは、日付のみといいえ時、午前 0 時 (00: 00:00) が使用されます。If the s parameter contains only a date and no time, midnight (00:00:00) is used. styleパラメーターも決定かどうか、sパラメーターは、先頭を含めることができます、内部、または末尾の空白文字で書式指定文字列のいずれかで許可されているもの以外のformatsします。The style parameter also determines whether the s parameter can contain leading, inner, or trailing white space characters other than those permitted by one of the format strings in formats.

場合sタイム ゾーンの情報が含まれていない、 Kind 、返されたプロパティDateTimeオブジェクトがDateTimeKind.Unspecifiedします。If s contains no time zone information, the Kind property of the returned DateTime object is DateTimeKind.Unspecified. 使用してこの動作を変更することができます、DateTimeStyles.AssumeLocalフラグ、返された、DateTimeKindプロパティはDateTimeKind.Local、またはを使用して、DateTimeStyles.AssumeUniversalDateTimeStyles.AdjustToUniversalフラグ、返された、DateTimeKindプロパティはDateTimeKind.Utcします。This behavior can be changed by using the DateTimeStyles.AssumeLocal flag, which returns a DateTime value whose Kind property is DateTimeKind.Local, or by using the DateTimeStyles.AssumeUniversal and DateTimeStyles.AdjustToUniversal flags, which returns a DateTime value whose Kind property is DateTimeKind.Utc. 場合s、タイム ゾーン情報を含む、時刻は、必要に応じて、現地時刻に変換されます、 Kind 、返されたプロパティDateTimeにオブジェクトが設定されているDateTimeKind.Localします。If s contains time zone information, the time is converted to local time, if necessary, and the Kind property of the returned DateTime object is set to DateTimeKind.Local. 使用してこの動作を変更することができます、DateTimeStyles.RoundtripKindせず、現地時刻を世界協定時刻 (UTC) に変換を設定するフラグ、KindプロパティをDateTimeKind.Utcします。This behavior can be changed by using the DateTimeStyles.RoundtripKind flag to not convert Coordinated Universal Time (UTC) to a local time and set the Kind property to DateTimeKind.Utc.

formatsパラメーターには、パターンの配列が含まれています。 その 1 つs解析操作が成功する場合に正確に一致する必要があります。The formats parameter contains an array of patterns, one of which s must match exactly if the parse operation is to succeed. 内のパターン、formatsパラメーターは、1 つまたは複数のカスタム書式指定子から、カスタム Date and Time Format Stringsテーブル、またはから定義済みのパターンを識別する 1 つの標準書式指定子、Standard Date and Time Format Stringsテーブル。The patterns in the formats parameter consists of one or more custom format specifiers from the Custom Date and Time Format Strings table, or a single standard format specifier, which identifies a predefined pattern, from the Standard Date and Time Format Strings table.

カスタム書式パターンでは日付または時刻の区切り記号を使用しない場合は、インバリアント カルチャを使用して、providerパラメーターおよび各カスタムの最も長い形式の書式指定子。If you do not use date or time separators in a custom format pattern, use the invariant culture for the provider parameter and the widest form of each custom format specifier. たとえば、パターンに時間を指定する場合は、"H"狭義の形式ではなくより多くのフォーム"HH"を指定します。For example, if you want to specify hours in the pattern, specify the wider form, "HH", instead of the narrower form, "H".

stylesパラメーターには 1 つまたは複数のメンバーが含まれています、DateTimeStylesかどうかと、空白文字で定義されていないかを決定する列挙体formatに表示できるs解析操作の正確な動作を制御します。The styles parameter includes one or more members of the DateTimeStyles enumeration that determine whether and where white space not defined by format can appear in s and that control the precise behavior of the parse operation. 次の表をそれぞれどのように説明のメンバー、DateTimeStyles列挙型の運用に与える影響、ParseExact(String, String, IFormatProvider, DateTimeStyles)メソッド。The following table describes how each member of the DateTimeStyles enumeration affects the operation of the ParseExact(String, String, IFormatProvider, DateTimeStyles) method.

DateTimeStyles メンバーDateTimeStyles member 説明Description
AdjustToUniversal 解析sと、必要に応じて、UTC に変換します。Parses s and, if necessary, converts it to UTC. 場合s、タイム ゾーン オフセットが含まれて 場合sタイム ゾーン情報が含まれていないが、stylesが含まれています、DateTimeStyles.AssumeLocalフラグは、メソッド呼び出し、文字列を解析してToUniversalTime、返されたに変換するDateTime値を UTC にを設定し、KindプロパティをDateTimeKind.Utcします。If s includes a time zone offset, or if s contains no time zone information but styles includes the DateTimeStyles.AssumeLocal flag, the method parses the string, calls ToUniversalTime to convert the returned DateTime value to UTC, and sets the Kind property to DateTimeKind.Utc. 場合sUTC で表すことを示す場合、またはsタイム ゾーン情報は含まれませんが、stylesが含まれています、DateTimeStyles.AssumeUniversalフラグは、メソッド、文字列を解析して、返されたのタイム ゾーンの変換は行われませんDateTime値、およびセット、KindプロパティをDateTimeKind.Utcします。If s indicates that it represents UTC, or if s does not contain time zone information but styles includes the DateTimeStyles.AssumeUniversal flag, the method parses the string, performs no time zone conversion on the returned DateTime value, and sets the Kind property to DateTimeKind.Utc. その他のすべてのケースでは、フラグには影響はありません。In all other cases, the flag has no effect.
AllowInnerWhite 定義されていない、空白文字を指定しますformat任意の個々 の日付または時刻の要素の間に表示できます。Specifies that white space not defined by format can appear between any individual date or time element.
AllowLeadingWhite 定義されていない、空白文字を指定しますformatの先頭に表示できるsします。Specifies that white space not defined by format can appear at the beginning of s.
AllowTrailingWhite 定義されていない、空白文字を指定しますformatの末尾に記述できるsします。Specifies that white space not defined by format can appear at the end of s.
AllowWhiteSpaces 指定しますs先頭、内部、および末尾の空白で定義されていない場合がありますformatします。Specifies that s may contain leading, inner, and trailing white spaces not defined by format.
AssumeLocal 場合を指定しますsのタイム ゾーン情報がない、現地時刻を表すと見なされます。Specifies that if s lacks any time zone information, it is assumed to represent a local time. しない限り、DateTimeStyles.AdjustToUniversalフラグが存在する、 Kind 、返されたプロパティDateTime値に設定されてDateTimeKind.Localします。Unless the DateTimeStyles.AdjustToUniversal flag is present, the Kind property of the returned DateTime value is set to DateTimeKind.Local.
AssumeUniversal 指定された場合s任意のタイム ゾーン情報が不足しています utc と見なされます。Specifies that if s lacks any time zone information, it is assumed to represent UTC. しない限り、DateTimeStyles.AdjustToUniversalフラグが存在する、メソッドは、返された変換DateTime値を UTC から現地時刻とセットにそのKindプロパティをDateTimeKind.Localします。Unless the DateTimeStyles.AdjustToUniversal flag is present, the method converts the returned DateTime value from UTC to local time and sets its Kind property to DateTimeKind.Local.
NoCurrentDateDefault 場合sの時刻に設定されている戻り値の日付の日付の情報がないDateTime.MinValue.Dateします。If s contains time without date information, the date of the return value is set to DateTime.MinValue.Date.
None sパラメーターは、既定値を使用して解析されます。The s parameter is parsed using default values. 空白以外に含まれているformatは許可されています。No white space other than that present in format is allowed. 場合s、返された日付、日付部分がないDateTime値は 1/1/0001 を設定します。If s lacks a date component, the date of the returned DateTime value is set to 1/1/0001. 場合sタイム ゾーンの情報が含まれていない、 Kind 、返されたプロパティDateTimeにオブジェクトが設定されているDateTimeKind.Unspecifiedします。If s contains no time zone information, the Kind property of the returned DateTime object is set to DateTimeKind.Unspecified. タイム ゾーン情報が存在する場合s、時刻は現地時刻に変換し、 Kind 、返されたプロパティDateTimeにオブジェクトが設定されているDateTimeKind.Localします。If time zone information is present in s, the time is converted to local time and the Kind property of the returned DateTime object is set to DateTimeKind.Local.
RoundtripKind タイム ゾーン情報が含まれている文字列の場合は、日付に変換できないし、時刻の使用を試みますそのKindプロパティに設定DateTimeKind.Localします。For strings that contain time zone information, tries to prevent the conversion to a date and time with its Kind property set to DateTimeKind.Local. 主に、このフラグには、ローカル時刻を UTC 時刻の変換ができないようにします。This flag primarily prevents the conversion of UTC times to local times.

特定の日付と時刻のシンボルとで使用される特定の言語で曜日の名前) などの文字列sによって定義されます、providerパラメーターの正確な形式はs場合formatは標準的な形式です。指定子の文字列。The particular date and time symbols and strings (such as the names of the days of the week in a particular language) used in s are defined by the provider parameter, as is the precise format of s if format is a standard format specifier string. providerパラメーターには、次のいずれかを指定できます。The provider parameter can be any of the following:

場合providernullCultureInfo現在のカルチャに対応するオブジェクトを使用します。If provider is null, the CultureInfo object that corresponds to the current culture is used.

注意 (呼び出し元)

.NET Framework 4.NET Framework 4ParseExactメソッドがスローされます、FormatException解析する文字列が、時間の部分と契約に含まれていない AM/PM 指定子を含むかどうか。In the .NET Framework 4.NET Framework 4, the ParseExact method throws a FormatException if the string to be parsed contains an hour component and an AM/PM designator that are not in agreement. .NET Framework 3.5.NET Framework 3.5と以前のバージョン、AM/PM 指定子は無視されます。In the .NET Framework 3.5.NET Framework 3.5 and earlier versions, the AM/PM designator is ignored.

こちらもご覧ください

適用対象