DateTime.TryParseExact Метод

Определение

Преобразует заданное строковое представление даты и времени в его эквивалент 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. Метод возвращает значение, указывающее, успешно ли выполнено преобразование.The method returns a value that indicates whether the conversion succeeded.

Перегрузки

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

Преобразует заданное представление диапазона даты и времени в его эквивалент DateTime, используя заданный формат, указанные сведения о форматировании, связанные с языком и региональными параметрами, а также стиль.Converts the specified span 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. Метод возвращает значение, указывающее, успешно ли выполнено преобразование.The method returns a value that indicates whether the conversion succeeded.

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

Преобразовывает указанный диапазон символов даты и времени в его эквивалент DateTime и возвращает значение, позволяющее определить успешность преобразования.Converts the specified char span of a date and time to its DateTime equivalent and returns a value that indicates whether the conversion succeeded.

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

Преобразует заданное строковое представление даты и времени в его эквивалент 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. Метод возвращает значение, указывающее, успешно ли выполнено преобразование.The method returns a value that indicates whether the conversion succeeded.

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

Преобразует заданное строковое представление даты и времени в его эквивалент 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. Формат представления строки должен полностью соответствовать хотя бы одному заданному формату.The format of the string representation must match at least one of the specified formats exactly. Метод возвращает значение, указывающее, успешно ли выполнено преобразование.The method returns a value that indicates whether the conversion succeeded.

Комментарии

Важно!

Эры в японских календарях основаны на периодах царствования императоров. Таким образом, ожидается наступление новой эры.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Например, 1 мая 2019 года в JapaneseCalendar и JapaneseLunisolarCalendar отмечено как начало эры Рэйва.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, которые поддерживают календарь с несколькими эрами, и рекомендации по использованию таких календарей см. в разделе о работе с эрами.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.

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

Преобразует заданное представление диапазона даты и времени в его эквивалент DateTime, используя заданный формат, указанные сведения о форматировании, связанные с языком и региональными параметрами, а также стиль.Converts the specified span 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. Метод возвращает значение, указывающее, успешно ли выполнено преобразование.The method returns a value that indicates whether the conversion succeeded.

public:
 static bool TryParseExact(ReadOnlySpan<char> s, ReadOnlySpan<char> format, IFormatProvider ^ provider, System::Globalization::DateTimeStyles style, [Runtime::InteropServices::Out] DateTime % result);
public static bool TryParseExact (ReadOnlySpan<char> s, ReadOnlySpan<char> format, IFormatProvider? provider, System.Globalization.DateTimeStyles style, out DateTime result);
public static bool TryParseExact (ReadOnlySpan<char> s, ReadOnlySpan<char> format, IFormatProvider provider, System.Globalization.DateTimeStyles style, out DateTime result);
static member TryParseExact : ReadOnlySpan<char> * ReadOnlySpan<char> * IFormatProvider * System.Globalization.DateTimeStyles * DateTime -> bool
Public Shared Function TryParseExact (s As ReadOnlySpan(Of Char), format As ReadOnlySpan(Of Char), provider As IFormatProvider, style As DateTimeStyles, ByRef result As DateTime) As Boolean

Параметры

s
ReadOnlySpan<Char>

Диапазон, содержащий символы, которые представляют преобразуемые дату и время.A span containing the characters representing a date and time to convert.

format
ReadOnlySpan<Char>

Необходимый формат s.The required format of s.

provider
IFormatProvider

Объект, который предоставляет сведения о форматировании параметра s в зависимости от языка и региональных параметров.An object that supplies culture-specific formatting information about s.

style
DateTimeStyles

Побитовая комбинация одного или нескольких значений перечисления, которые указывают на разрешенный формат параметра s.A bitwise combination of one or more enumeration values that indicate the permitted format of s.

result
DateTime

После возврата из этого метода содержит значение DateTime, эквивалентное дате и времени, заданным в параметре s, если преобразование прошло успешно, или значение MinValue, если преобразование завершилось неудачей.When this method returns, contains the DateTime value equivalent to the date and time contained in s, if the conversion succeeded, or MinValue if the conversion failed. Преобразование завершается неудачей, если в значением параметра s или format является null либо пустая строка, или не является дата и время, соответствующие шаблону, заданному в параметре format.The conversion fails if either the s or format parameter is null, is an empty string, or does not contain a date and time that correspond to the pattern specified in format. Этот параметр передается неинициализированным.This parameter is passed uninitialized.

Возвращаемое значение

Boolean

Значение true, если параметр s успешно преобразован; в противном случае — значение false.true if s was converted successfully; otherwise, false.

Применяется к

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

Преобразовывает указанный диапазон символов даты и времени в его эквивалент DateTime и возвращает значение, позволяющее определить успешность преобразования.Converts the specified char span of a date and time to its DateTime equivalent and returns a value that indicates whether the conversion succeeded.

public:
 static bool TryParseExact(ReadOnlySpan<char> s, cli::array <System::String ^> ^ formats, IFormatProvider ^ provider, System::Globalization::DateTimeStyles style, [Runtime::InteropServices::Out] DateTime % result);
public static bool TryParseExact (ReadOnlySpan<char>? s, string[] formats, IFormatProvider provider, System.Globalization.DateTimeStyles style, out DateTime result);
public static bool TryParseExact (ReadOnlySpan<char> s, string[] formats, IFormatProvider provider, System.Globalization.DateTimeStyles style, out DateTime result);
static member TryParseExact : ReadOnlySpan<char> * string[] * IFormatProvider * System.Globalization.DateTimeStyles * DateTime -> bool
Public Shared Function TryParseExact (s As ReadOnlySpan(Of Char), formats As String(), provider As IFormatProvider, style As DateTimeStyles, ByRef result As DateTime) As Boolean

Параметры

s
ReadOnlySpan<Char>

Диапазон, содержащий строку для анализа.The span containing the string to parse.

formats
String[]

Массив разрешенных форматов s.An array of allowable formats of s.

provider
IFormatProvider

Объект, который предоставляет сведения о форматировании параметра s в зависимости от языка и региональных параметров.An object that supplies culture-specific formatting information about s.

style
DateTimeStyles

Побитовая комбинация значений перечисления, которая определяет, как интерпретировать проанализированную дату по отношению к текущему часовому поясу или текущей дате.A bitwise combination of enumeration values that defines how to interpret the parsed date in relation to the current time zone or the current date. Обычно указывается значение None.A typical value to specify is None.

result
DateTime

После возврата из этого метода содержит значение DateTime, эквивалентное дате и времени, заданным в параметре s, если преобразование прошло успешно, или значение MinValue, если преобразование завершилось неудачей.When this method returns, contains the DateTime value equivalent to the date and time contained in s, if the conversion succeeded, or MinValue if the conversion failed. Преобразование завершается неудачей, если значение параметра s равно null, Empty или в нем не содержится допустимое строковое представление даты и времени.The conversion fails if the s parameter is null, is Empty, or does not contain a valid string representation of a date and time. Этот параметр передается неинициализированным.This parameter is passed uninitialized.

Возвращаемое значение

Boolean

Значение true, если параметр s успешно преобразован; в противном случае — значение false.true if the s parameter was converted successfully; otherwise, false.

Применяется к

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

Преобразует заданное строковое представление даты и времени в его эквивалент 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. Метод возвращает значение, указывающее, успешно ли выполнено преобразование.The method returns a value that indicates whether the conversion succeeded.

public:
 static bool TryParseExact(System::String ^ s, System::String ^ format, IFormatProvider ^ provider, System::Globalization::DateTimeStyles style, [Runtime::InteropServices::Out] DateTime % result);
public static bool TryParseExact (string s, string format, IFormatProvider provider, System.Globalization.DateTimeStyles style, out DateTime result);
static member TryParseExact : string * string * IFormatProvider * System.Globalization.DateTimeStyles * DateTime -> bool
Public Shared Function TryParseExact (s As String, format As String, provider As IFormatProvider, style As DateTimeStyles, ByRef result As DateTime) As Boolean

Параметры

s
String

Строка, содержащая дату и время, которые нужно преобразовать.A string containing a date and time to convert.

format
String

Необходимый формат s.The required format of s.

provider
IFormatProvider

Объект, который предоставляет сведения о форматировании параметра s в зависимости от языка и региональных параметров.An object that supplies culture-specific formatting information about s.

style
DateTimeStyles

Побитовая комбинация одного или нескольких значений перечисления, которые указывают на разрешенный формат параметра s.A bitwise combination of one or more enumeration values that indicate the permitted format of s.

result
DateTime

После возврата из этого метода содержит значение DateTime, эквивалентное дате и времени, заданным в параметре s, если преобразование прошло успешно, или значение MinValue, если преобразование завершилось неудачей.When this method returns, contains the DateTime value equivalent to the date and time contained in s, if the conversion succeeded, or MinValue if the conversion failed. Преобразование завершается неудачей, если в значением параметра s или format является null либо пустая строка, или не является дата и время, соответствующие шаблону, заданному в параметре format.The conversion fails if either the s or format parameter is null, is an empty string, or does not contain a date and time that correspond to the pattern specified in format. Этот параметр передается неинициализированным.This parameter is passed uninitialized.

Возвращаемое значение

Boolean

Значение true, если параметр s успешно преобразован; в противном случае — значение false.true if s was converted successfully; otherwise, false.

Исключения

styles не является допустимым значением DateTimeStyles.styles is not a valid DateTimeStyles value.

- или --or- styles содержит недопустимое сочетание значений DateTimeStyles (например, и AssumeLocal, и AssumeUniversal ).styles contains an invalid combination of DateTimeStyles values (for example, both AssumeLocal and AssumeUniversal).

Примеры

В следующем примере демонстрируется DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) метод.The following example demonstrates the DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) 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/иииихх: mm", так как строка даты не предшествует номеру месяца с нулем в начале, как 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";
      if (DateTime.TryParseExact(dateString, "g", enUS,
                                 DateTimeStyles.None, out dateValue))
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
                           dateValue.Kind);
      else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);

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

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

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

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

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

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

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

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

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

Комментарии

DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)Метод анализирует строковое представление даты, которое должно быть в формате, определенном format параметром.The DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) method parses the string representation of a date, which must be in the format defined by the format parameter. Он аналогичен DateTime.ParseExact(String, String, IFormatProvider, DateTimeStyles) методу, за исключением того, что TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) метод не создает исключение, если преобразование завершается неудачей.It is similar to the DateTime.ParseExact(String, String, IFormatProvider, DateTimeStyles) method, except that the TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) method does not throw an exception if the conversion fails.

sПараметр содержит дату и время для синтаксического анализа и должен иметь формат, определенный format параметром.The s parameter contains the date and time to parse and must be in a format defined by the format parameter. Если элементы даты, времени и часового пояса присутствуют в s , они также должны присутствовать в порядке, указанном параметром format .If date, time, and time zone elements are present in s, they must also appear in the order specified by format. Если format определяет дату без элемента time и операция синтаксического анализа завершилась успешно, полученное DateTime значение будет иметь время полуночи (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 или имеет дату, равное, DateTime.MinValue.Date Если styles включает DateTimeStyles.NoCurrentDateDefault флаг.If format defines a time with no date element and the parse operation succeeds, the resulting DateTime value by default has a date of DateTime.Now.Date, or it has a date of DateTime.MinValue.Date if styles includes the DateTimeStyles.NoCurrentDateDefault flag. styleПараметр определяет s , может ли параметр содержать начальные, внутренние или конечные символы пробела.The style parameter 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 флага, возвращающего DateTime значение Kind , свойство которого равно DateTimeKind.Local или с помощью DateTimeStyles.AssumeUniversal DateTimeStyles.AdjustToUniversal флагов и, которые возвращают DateTime значение, 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. Если параметр содержит сведения о часовом поясе, то при необходимости время преобразуется в местное время, а 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.

formatПараметр содержит шаблон, соответствующий ожидаемому формату s параметра.The format parameter contains a pattern that corresponds to the expected format of the s parameter. Шаблон в format параметре состоит из одного или нескольких настраиваемых описателей формата в таблице строк настраиваемого формата даты и времени или одного стандартного описателя формата, который определяет стандартный шаблон из таблицы строк стандартного формата даты и времени .The pattern in the format 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. Например, если вы хотите указать часы в шаблоне, укажите более широкую форму, "HH", а не более узкую форму "H".For example, if you want to specify hours in the pattern, specify the wider form, "HH", instead of the narrower form, "H".

Примечание

Вместо того чтобы требовать, чтобы s операция синтаксического анализа была выполнена в одном формате, можно вызвать DateTime.TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) метод и указать несколько разрешенных форматов.Rather than requiring that s conform to a single format for the parse operation to succeed, you can call the DateTime.TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) method and specify multiple permitted formats. Это делает операцию анализа более вероятной для выполнения.This makes the parse operation more likely to succeed.

Конкретные символы и строки даты и времени (например, названия дней недели на определенном языке), используемые в, 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:

  • CultureInfoОбъект, представляющий язык и региональные параметры, используемые для интерпретации s .A CultureInfo object that represents the culture used to interpret s. DateTimeFormatInfoОбъект, возвращаемый его DateTimeFormat свойством, определяет символы и форматирование в s .The DateTimeFormatInfo object returned by its DateTimeFormat property defines the symbols and formatting in s.

  • DateTimeFormatInfoОбъект, определяющий формат данных даты и времени.A DateTimeFormatInfo object that defines the format of date and time data.

  • Пользовательская IFormatProvider реализация, GetFormat метод которой возвращает либо CultureInfo объект, либо DateTimeFormatInfo объект, предоставляющий сведения о форматировании.A custom IFormatProvider implementation whose GetFormat method returns either the CultureInfo object or the DateTimeFormatInfo object that provides formatting information.

Если provider параметр имеет значение null , то CultureInfo используется объект, соответствующий текущему языку и региональным параметрам.If provider is null, the CultureInfo object that corresponds to the current culture is used.

stylesПараметр включает один или несколько элементов 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 перечисления влияет на работу TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) метода.The following table describes how each member of the DateTimeStyles enumeration affects the operation of the TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) 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. Если s указывает, что он представляет время в формате UTC или не 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 with its Kind property set to DateTimeKind.Local. Этот флаг, в первую очередь, предотвращает преобразование времени в формате UTC в местное время.This flag primarily prevents the conversion of UTC times to local times.

Примечания для тех, кто вызывает этот метод

В .NET Framework 4.NET Framework 4 TryParseExact метод возвращает значение, false если анализируемая строка содержит компонент часа и указатель AM/PM, который не является соглашением.In the .NET Framework 4.NET Framework 4, the TryParseExact method returns false 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.

См. также раздел

Применяется к

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

Преобразует заданное строковое представление даты и времени в его эквивалент 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. Формат представления строки должен полностью соответствовать хотя бы одному заданному формату.The format of the string representation must match at least one of the specified formats exactly. Метод возвращает значение, указывающее, успешно ли выполнено преобразование.The method returns a value that indicates whether the conversion succeeded.

public:
 static bool TryParseExact(System::String ^ s, cli::array <System::String ^> ^ formats, IFormatProvider ^ provider, System::Globalization::DateTimeStyles style, [Runtime::InteropServices::Out] DateTime % result);
public static bool TryParseExact (string s, string[] formats, IFormatProvider provider, System.Globalization.DateTimeStyles style, out DateTime result);
static member TryParseExact : string * string[] * IFormatProvider * System.Globalization.DateTimeStyles * DateTime -> bool
Public Shared Function TryParseExact (s As String, formats As String(), provider As IFormatProvider, style As DateTimeStyles, ByRef result As DateTime) As Boolean

Параметры

s
String

Строка, содержащая дату и время, которые нужно преобразовать.A string that contains a date and time to convert.

formats
String[]

Массив разрешенных форматов s.An array of allowable formats of s.

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.

result
DateTime

После возврата из этого метода содержит значение DateTime, эквивалентное дате и времени, заданным в параметре s, если преобразование прошло успешно, или значение MinValue, если преобразование завершилось неудачей.When this method returns, contains the DateTime value equivalent to the date and time contained in s, if the conversion succeeded, or MinValue if the conversion failed. Преобразование завершается неудачей, если s или formats имеет значение null, либо s или элемент formats является пустой строкой, либо формат s не в точности соответствует заданному хотя бы одним из шаблонов формата в formats.The conversion fails if s or formats is null, s or an element of formats is an empty string, or the format of s is not exactly as specified by at least one of the format patterns in formats. Этот параметр передается неинициализированным.This parameter is passed uninitialized.

Возвращаемое значение

Boolean

Значение true, если параметр s успешно преобразован; в противном случае — значение false.true if the s parameter was converted successfully; otherwise, false.

Исключения

styles не является допустимым значением DateTimeStyles.styles is not a valid DateTimeStyles value.

- или --or- styles содержит недопустимое сочетание значений DateTimeStyles (например, и AssumeLocal, и AssumeUniversal ).styles contains an invalid combination of DateTimeStyles values (for example, both AssumeLocal and AssumeUniversal).

Примеры

В следующем примере метод используется DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) для проверки возможности успешного анализа строки в ряде возможных форматов.The following example uses the DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) 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"};
      string[] dateStrings = {"5/1/2009 6:32 PM", "05/01/2009 6:32:05 PM",
                              "5/1/2009 6:32:00", "05/01/2009 06:32",
                              "05/01/2009 06:32:00 PM", "05/01/2009 06:32:00"};
      DateTime dateValue;

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

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

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

Комментарии

DateTime.TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)Метод анализирует строковое представление даты, соответствующее любому из шаблонов, назначенных formats параметру.The DateTime.TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) method parses the string representation of a date that matches any one of the patterns assigned to the formats parameter. Он похож на DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles) метод, за исключением того, что TryParseExact метод не создает исключение, если преобразование завершается неудачей.It is like the DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles) method, except the TryParseExact method does not throw an exception if the conversion fails.

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 параметр содержит только дату и время, то используется полночь (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 флага, возвращающего DateTime значение Kind , свойство которого равно DateTimeKind.Local или с помощью DateTimeStyles.AssumeUniversal DateTimeStyles.AdjustToUniversal флагов и, которые возвращают DateTime значение, 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. Если параметр содержит сведения о часовом поясе, то при необходимости время преобразуется в местное время, а 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Параметр содержит массив шаблонов, один из которых s должен точно соответствовать, если операция синтаксического анализа выполнена.The formats parameter contains an array of patterns, one of which s must match exactly if the parse operation is to succeed. Шаблоны в formats параметре состоят из одного или нескольких настраиваемых описателей формата в таблице строк настраиваемого формата даты и времени или одного стандартного описателя формата, который определяет стандартный шаблон из таблицы строк стандартного формата даты и времени .The patterns in the formats parameter consist 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. Например, если вы хотите указать часы в шаблоне, укажите более широкую форму, "HH", а не более узкую форму "H".For example, if you want to specify hours in the 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 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:

  • CultureInfoОбъект, представляющий язык и региональные параметры, используемые для интерпретации s .A CultureInfo object that represents the culture used to interpret s. DateTimeFormatInfoОбъект, возвращаемый его DateTimeFormat свойством, определяет символы и форматирование в s .The DateTimeFormatInfo object returned by its DateTimeFormat property defines the symbols and formatting in s.

  • DateTimeFormatInfoОбъект, определяющий формат данных даты и времени.A DateTimeFormatInfo object that defines the format of date and time data.

  • Пользовательская IFormatProvider реализация, GetFormat метод которой возвращает либо CultureInfo объект, либо DateTimeFormatInfo объект, предоставляющий сведения о форматировании.A custom IFormatProvider implementation whose GetFormat method returns either the CultureInfo object or the DateTimeFormatInfo object that provides formatting information.

Если provider параметр имеет значение null , то CultureInfo используется объект, соответствующий текущему языку и региональным параметрам.If provider is null, the CultureInfo object that corresponds to the current culture is used.

stylesПараметр включает один или несколько элементов 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 перечисления влияет на работу TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) метода.The following table describes how each member of the DateTimeStyles enumeration affects the operation of the TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) 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. Если s указывает, что он представляет время в формате UTC или не 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 with its Kind property set to DateTimeKind.Local. Этот флаг, в первую очередь, предотвращает преобразование времени в формате UTC в местное время.This flag primarily prevents the conversion of UTC times to local times.

Примечания для тех, кто вызывает этот метод

В .NET Framework 4.NET Framework 4 TryParseExact метод возвращает значение, false если анализируемая строка содержит компонент часа и указатель AM/PM, который не является соглашением.In the .NET Framework 4.NET Framework 4, the TryParseExact method returns false 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.

См. также раздел

Применяется к