DateTime.ParseExact メソッド

定義

指定した文字列形式の日付と時刻を等価の 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)

指定した書式とカルチャ固有の書式情報を使用して、指定した日付と時刻の文字列形式を等価の 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>, 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)

指定した書式の配列、カルチャ固有の書式情報、およびスタイルを使用して、指定した日付と時刻の文字列形式を等価の 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)

指定した書式とカルチャ固有の書式情報を使用して、指定した日付と時刻の文字列形式を等価の 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

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

format
String

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

provider
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.

注釈

@No__t-0 メソッドは、日付の文字列形式を解析します。これは、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. @No__t-0 で、時刻要素のない日付が定義され、解析操作が成功した場合、結果の 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). @No__t-0 で日付要素が指定されていない時刻が定義され、解析操作が成功した場合、結果の 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.

@No__t-0 が特定のタイムゾーンの時刻を表しておらず、解析操作が成功した場合、戻り値 DateTime の @no__t のプロパティは 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. @No__t-0 が特定のタイムゾーンの時刻を表す場合、format はタイムゾーン情報を格納できるようにします (たとえば、format が "o"、"r"、または "u" の標準書式指定子と等しい場合、または "z"、"zz"、"zzz" カスタム書式指定子が含まれる場合)) の場合、DateTime 値が返されるの Kind プロパティは 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.

@No__t-0 パラメーターは、1つの標準書式指定子、または必要な形式 s を定義する1つ以上のカスタム書式指定子を含む文字列です。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. 有効な書式指定コードの詳細については、「標準の日付と時刻の書式指定文字列」または「カスタム日時書式指定文字列」を参照してください。For details about valid formatting codes, see Standard Date and Time Format Strings or Custom Date and Time Format Strings.

注意

@No__t-0 が、日付または時刻の区切り記号を含まないカスタム書式パターン ("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".

@No__t-0 で使用される特定の日付と時刻の記号および文字列 (特定の言語の曜日の名前など) は、provider パラメーターによって定義されます。これは、format が標準書式指定子の文字列である場合の s の正確な形式です。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:

  • @No__t-1 を解釈するために使用されるカルチャを表す @no__t 0 オブジェクト。A CultureInfo object that represents the culture used to interpret s. @No__t-1 プロパティによって返される @no__t 0 オブジェクトは、s の記号と書式を定義します。The DateTimeFormatInfo object returned by its DateTimeFormat property defines the symbols and formatting in s.

  • 日付と時刻のデータの形式を定義する @no__t 0 オブジェクト。A DateTimeFormatInfo object that defines the format of date and time data.

  • @No__t-1 メソッドが CultureInfo オブジェクトまたは書式設定情報を提供する DateTimeFormatInfo オブジェクトを返すカスタム @no__t 0 の実装。A custom IFormatProvider implementation whose GetFormat method returns either the CultureInfo object or the DateTimeFormatInfo object that provides formatting information.

@No__t-0 が null の場合、現在のカルチャに対応する CultureInfo オブジェクトが使用されます。If provider is null, the CultureInfo object that corresponds to the current culture is used.

注意 (呼び出し元)

@No__t-0 の場合、ParseExact のメソッドは、解析対象の文字列に1時間の部分と、アグリーメントに含まれていない AM/PM 指定子が含まれている場合に FormatException をスローします。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. @No__t-0 とそれ以前のバージョンでは、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)

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>
provider
IFormatProvider

戻り値

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[]
provider
IFormatProvider

戻り値

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

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

format
String

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

provider
IFormatProvider

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

style
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. 先頭のスペースは format で許可されていないため、styles パラメーターが DateTimeStyles.None と等しい場合、文字列 "5/01/2009 8:30 AM" を正常に解析できないことに注意してください。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) で正常に解析できません。これは、@no__t にはが必要であるためです。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).

注釈

@No__t-0 メソッドは、日付の文字列形式を解析します。これは、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. また、@no__t 0 の日付と時刻の要素が format で指定された順序で表示される必要があります。It also requires that the date and time elements in s appear in the order specified by format. @No__t-0 が、style パラメーターで定義されたバリエーションを持つ format パラメーターのパターンと一致しない場合、メソッドは 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. @No__t-0 メソッドでは、s の日付と時刻の要素を任意の順序で表示することもできます。The DateTime.Parse(String, IFormatProvider, DateTimeStyles) method also allows the date and time elements in s to appear in any order.

@No__t-0 パラメーターに時刻と日付が含まれていない場合は、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. @No__t-0 パラメーターに日付と時刻のみが含まれている場合は、深夜 (00:00:00) が使用されます。If the s parameter contains only a date and no time, midnight (00:00:00) is used. @No__t-0 パラメーターは、s パラメーターに先頭、内部、または末尾の空白文字を含めることができるかどうかも決定します。The style parameter also determines whether the s parameter can contain leading, inner, or trailing white space characters.

@No__t-0 にタイムゾーン情報が含まれていない場合、返された DateTime オブジェクトの Kind プロパティは DateTimeKind.Unspecified になります。If s contains no time zone information, the Kind property of the returned DateTime object is DateTimeKind.Unspecified. この動作は、DateTimeStyles.AssumeLocal フラグを使用することによって変更できます。このフラグは、Kind プロパティが DateTimeKind.Local である @no__t 1 の値を返すか、DateTimeStyles.AssumeUniversalDateTimeStyles.AdjustToUniversal のフラグを使用します。これにより、Kind プロパティが 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. @No__t-0 にタイムゾーン情報が含まれている場合は、必要に応じて時刻が現地時刻に変換され、返された DateTime オブジェクトの Kind プロパティは 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.

@No__t-0 パラメーターは、s パラメーターの必要なパターンを定義します。The format parameter defines the required pattern of the s parameter. これは、カスタム日時書式指定文字列テーブルの1つ以上のカスタム書式指定子、または標準の日時書式指定文字列の表から定義済みのパターンを識別する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".

注意

解析操作が成功するために @no__t 0 が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.

@No__t-0 パラメーターには、DateTimeStyles 列挙体の1つ以上のメンバーが含まれており、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 @No__t-0 を解析し、必要に応じて UTC に変換します。Parses s and, if necessary, converts it to UTC. @No__t-0 にタイムゾーンオフセットが含まれている場合、または s にタイムゾーン情報が含まれていないにもかかわらず、styles には DateTimeStyles.AssumeLocal フラグが含まれている場合、メソッドは文字列を解析し、ToUniversalTime を呼び出して返された DateTime の値を UTC に変換し、KindIf 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. @No__t-0 が UTC を表すことを示している場合、または s にタイムゾーン情報が含まれておらず、styles には DateTimeStyles.AssumeUniversal フラグが含まれている場合、メソッドは文字列を解析し、返された DateTime の値にタイムゾーン変換を実行し、Kind プロパティを設定します。@no__t します。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 @No__t-0 によって定義されていない空白を、任意の個別の日付または時刻要素の間に表示できることを指定します。Specifies that white space not defined by format can appear between any individual date or time element.
AllowLeadingWhite @No__t-0 で定義されていない空白が s の先頭に表示されることを指定します。Specifies that white space not defined by format can appear at the beginning of s.
AllowTrailingWhite @No__t-0 によって定義されていない空白が s の最後に表示されることを指定します。Specifies that white space not defined by format can appear at the end of s.
AllowWhiteSpaces @No__t-0 に format で定義されていない先頭、内部、および末尾の空白を含めることを指定します。Specifies that s may contain leading, inner, and trailing white spaces not defined by format.
AssumeLocal @No__t-0 にタイムゾーン情報がない場合は、現地時刻を表すと想定されます。Specifies that if s lacks any time zone information, it is assumed to represent a local time. @No__t-0 フラグが指定されていない場合、返される DateTime 値の Kind プロパティは DateTimeKind.Local に設定されます。Unless the DateTimeStyles.AdjustToUniversal flag is present, the Kind property of the returned DateTime value is set to DateTimeKind.Local.
AssumeUniversal @No__t-0 にタイムゾーン情報がない場合、UTC を表すと想定されることを指定します。Specifies that if s lacks any time zone information, it is assumed to represent UTC. @No__t-0 フラグが指定されていない場合、メソッドは、返された 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 @No__t-0 に日付情報が含まれていない場合、戻り値の日付は DateTime.MinValue.Date に設定されます。If s contains time without date information, the date of the return value is set to DateTime.MinValue.Date.
None @No__t-0 パラメーターは、既定値を使用して解析されます。The s parameter is parsed using default values. @No__t-0 に存在しない空白は許可されません。No white space other than that present in format is allowed. @No__t-0 に日付要素がない場合、返される DateTime 値の日付は1/1/0001 に設定されます。If s lacks a date component, the date of the returned DateTime value is set to 1/1/0001. @No__t-0 にタイムゾーン情報が含まれていない場合は、返された DateTime オブジェクトの Kind プロパティが DateTimeKind.Unspecified に設定されます。If s contains no time zone information, the Kind property of the returned DateTime object is set to DateTimeKind.Unspecified. タイムゾーン情報が s に存在する場合、時刻は現地時刻に変換され、返される DateTime オブジェクトの Kind プロパティは 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 に設定された @no__t 0 値の日付と時刻への変換を防止しようとします。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.

@No__t-0 で使用される特定の日付と時刻の記号および文字列 (特定の言語の曜日の名前など) は、provider パラメーターによって定義されます。これは、format が標準書式指定子の文字列である場合の s の正確な形式です。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:

  • @No__t-1 を解釈するために使用されるカルチャを表す @no__t 0 オブジェクト。A CultureInfo object that represents the culture used to interpret s. @No__t-1 プロパティによって返される @no__t 0 オブジェクトは、s の記号と書式を定義します。The DateTimeFormatInfo object returned by its DateTimeFormat property defines the symbols and formatting in s.

  • 日付と時刻のデータの形式を定義する @no__t 0 オブジェクト。A DateTimeFormatInfo object that defines the format of date and time data.

  • @No__t-1 メソッドが CultureInfo オブジェクトまたは書式設定情報を提供する DateTimeFormatInfo オブジェクトを返すカスタム @no__t 0 の実装。A custom IFormatProvider implementation whose GetFormat method returns either the CultureInfo object or the DateTimeFormatInfo object that provides formatting information.

@No__t-0 が null の場合、現在のカルチャに対応する CultureInfo オブジェクトが使用されます。If provider is null, the CultureInfo object that corresponds to the current culture is used.

注意 (呼び出し元)

@No__t-0 の場合、ParseExact のメソッドは、解析対象の文字列に1時間の部分と、アグリーメントに含まれていない AM/PM 指定子が含まれている場合に FormatException をスローします。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. @No__t-0 とそれ以前のバージョンでは、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)

指定した書式の配列、カルチャ固有の書式情報、およびスタイルを使用して、指定した日付と時刻の文字列形式を等価の 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

変換する日時を含む文字列。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

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

style
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.

注釈

@No__t-0 メソッドは、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. 1つの書式パターンではなく 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.

@No__t-0 パラメーターには、解析する日付と時刻が格納されます。The s parameter contains the date and time to parse. @No__t-0 パラメーターに時刻と日付が含まれていない場合は、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. @No__t-0 パラメーターに日付と時刻のみが含まれている場合は、深夜 (00:00:00) が使用されます。If the s parameter contains only a date and no time, midnight (00:00:00) is used. また、style パラメーターは、formats のいずれかの書式指定文字列によって許可されていない空白文字を、s パラメーターに含めることができるかどうかを判断します。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.

@No__t-0 にタイムゾーン情報が含まれていない場合、返された DateTime オブジェクトの Kind プロパティは DateTimeKind.Unspecified になります。If s contains no time zone information, the Kind property of the returned DateTime object is DateTimeKind.Unspecified. この動作は、DateTimeStyles.AssumeLocal フラグを使用することによって変更できます。このフラグは、Kind プロパティが DateTimeKind.Local である @no__t 1 の値を返すか、DateTimeStyles.AssumeUniversalDateTimeStyles.AdjustToUniversal のフラグを使用します。これにより、Kind プロパティが 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. @No__t-0 にタイムゾーン情報が含まれている場合は、必要に応じて時刻が現地時刻に変換され、返された DateTime オブジェクトの Kind プロパティは 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.

@No__t-0 パラメーターにはパターンの配列が含まれており、そのいずれかが、解析操作が成功する場合は、s が正確に一致する必要があります。The formats parameter contains an array of patterns, one of which s must match exactly if the parse operation is to succeed. @No__t-0 パラメーターのパターンは、カスタム日時書式指定文字列テーブルの1つ以上のカスタム書式指定子、または標準の日付と時刻から定義済みのパターンを識別する単一の標準書式指定子で構成されます。書式指定文字列のテーブル。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".

@No__t-0 パラメーターには、DateTimeStyles 列挙体の1つ以上のメンバーが含まれており、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 @No__t-0 を解析し、必要に応じて UTC に変換します。Parses s and, if necessary, converts it to UTC. @No__t-0 にタイムゾーンオフセットが含まれている場合、または s にタイムゾーン情報が含まれていないにもかかわらず、styles には DateTimeStyles.AssumeLocal フラグが含まれている場合、メソッドは文字列を解析し、ToUniversalTime を呼び出して返された DateTime の値を UTC に変換し、KindIf 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. @No__t-0 が UTC を表すことを示している場合、または s にタイムゾーン情報が含まれておらず、styles には DateTimeStyles.AssumeUniversal フラグが含まれている場合、メソッドは文字列を解析し、返された DateTime の値にタイムゾーン変換を実行し、Kind プロパティを設定します。@no__t します。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 @No__t-0 によって定義されていない空白を、任意の個別の日付または時刻要素の間に表示できることを指定します。Specifies that white space not defined by format can appear between any individual date or time element.
AllowLeadingWhite @No__t-0 で定義されていない空白が s の先頭に表示されることを指定します。Specifies that white space not defined by format can appear at the beginning of s.
AllowTrailingWhite @No__t-0 によって定義されていない空白が s の最後に表示されることを指定します。Specifies that white space not defined by format can appear at the end of s.
AllowWhiteSpaces @No__t-0 に format で定義されていない先頭、内部、および末尾の空白を含めることを指定します。Specifies that s may contain leading, inner, and trailing white spaces not defined by format.
AssumeLocal @No__t-0 にタイムゾーン情報がない場合は、現地時刻を表すと想定されます。Specifies that if s lacks any time zone information, it is assumed to represent a local time. @No__t-0 フラグが指定されていない場合、返される DateTime 値の Kind プロパティは DateTimeKind.Local に設定されます。Unless the DateTimeStyles.AdjustToUniversal flag is present, the Kind property of the returned DateTime value is set to DateTimeKind.Local.
AssumeUniversal @No__t-0 にタイムゾーン情報がない場合、UTC を表すと想定されることを指定します。Specifies that if s lacks any time zone information, it is assumed to represent UTC. @No__t-0 フラグが指定されていない場合、メソッドは、返された 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 @No__t-0 に日付情報が含まれていない場合、戻り値の日付は DateTime.MinValue.Date に設定されます。If s contains time without date information, the date of the return value is set to DateTime.MinValue.Date.
None @No__t-0 パラメーターは、既定値を使用して解析されます。The s parameter is parsed using default values. @No__t-0 に存在しない空白は許可されません。No white space other than that present in format is allowed. @No__t-0 に日付要素がない場合、返される DateTime 値の日付は1/1/0001 に設定されます。If s lacks a date component, the date of the returned DateTime value is set to 1/1/0001. @No__t-0 にタイムゾーン情報が含まれていない場合は、返された DateTime オブジェクトの Kind プロパティが DateTimeKind.Unspecified に設定されます。If s contains no time zone information, the Kind property of the returned DateTime object is set to DateTimeKind.Unspecified. タイムゾーン情報が s に存在する場合、時刻は現地時刻に変換され、返される DateTime オブジェクトの Kind プロパティは 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 タイムゾーン情報を含む文字列の場合、は、@no__t 0 のプロパティが 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.

@No__t-0 で使用される特定の日付と時刻の記号および文字列 (特定の言語の曜日の名前など) は、provider パラメーターによって定義されます。これは、format が標準書式指定子の文字列である場合の s の正確な形式です。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:

  • @No__t-1 を解釈するために使用されるカルチャを表す @no__t 0 オブジェクト。A CultureInfo object that represents the culture used to interpret s. @No__t-1 プロパティによって返される @no__t 0 オブジェクトは、s の記号と書式を定義します。The DateTimeFormatInfo object returned by its DateTimeFormat property defines the symbols and formatting in s.

  • 日付と時刻のデータの形式を定義する @no__t 0 オブジェクト。A DateTimeFormatInfo object that defines the format of date and time data.

  • @No__t-1 メソッドが CultureInfo オブジェクトまたは書式設定情報を提供する DateTimeFormatInfo オブジェクトを返すカスタム @no__t 0 の実装。A custom IFormatProvider implementation whose GetFormat method returns either the CultureInfo object or the DateTimeFormatInfo object that provides formatting information.

@No__t-0 が null の場合、現在のカルチャに対応する CultureInfo オブジェクトが使用されます。If provider is null, the CultureInfo object that corresponds to the current culture is used.

注意 (呼び出し元)

@No__t-0 の場合、ParseExact のメソッドは、解析対象の文字列に1時間の部分と、アグリーメントに含まれていない AM/PM 指定子が含まれている場合に FormatException をスローします。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. @No__t-0 とそれ以前のバージョンでは、AM/PM 指定子は無視されます。In the .NET Framework 3.5.NET Framework 3.5 and earlier versions, the AM/PM designator is ignored.

こちらもご覧ください

適用対象