DateTime.TryParseExact 方法

定义

将日期和时间的指定字符串表示形式转换为其等效 DateTime。 字符串表示形式的格式必须与指定的格式完全匹配。 该方法返回一个值,该值指示转换是否成功。

重载

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

使用指定的格式、区域性特定的格式信息和样式,将日期和时间的指定范围表示形式转换为其等效 DateTime。 字符串表示形式的格式必须与指定的格式完全匹配。 该方法返回一个值,该值指示转换是否成功。

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

将日期和时间的指定字符范围转换为其等效 DateTime,并返回一个值,该值指示转换是否成功。

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

使用指定的格式、区域性特定的格式信息和样式将日期和时间的指定字符串表示形式转换为其等效 DateTime。 字符串表示形式的格式必须与指定的格式完全匹配。 该方法返回一个值,该值指示转换是否成功。

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

使用指定的格式、区域性特定的格式信息和样式数组,将日期和时间的指定字符串表示形式转换为其等效 DateTime。 字符串表示形式的格式必须与指定格式中的至少一种格式完全匹配。 该方法返回一个值,该值指示转换是否成功。

注解

重要

日本日历中的纪元基于皇帝的统治,因此预计将改变。 例如,2019 年 5 月 1 日标志着雷瓦时代在 JapaneseCalendarJapaneseLunisolarCalendar的开始。 这种时代变化会影响使用这些日历的所有应用程序。 有关详细信息并确定应用程序是否受到影响,请参阅 处理 .NET日本日历中的新纪元。 有关在 Windows 系统上测试应用程序以确保其为纪元更改做好准备的信息,请参阅 为日本时代更改准备应用程序。 有关支持具有多个纪元的日历以及处理支持多个纪元的日历的最佳做法的 .NET 中的功能,请参阅 使用纪元

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

Source:
DateTime.cs
Source:
DateTime.cs
Source:
DateTime.cs

使用指定的格式、区域性特定的格式信息和样式,将日期和时间的指定范围表示形式转换为其等效 DateTime。 字符串表示形式的格式必须与指定的格式完全匹配。 该方法返回一个值,该值指示转换是否成功。

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

参数

s
ReadOnlySpan<Char>

一个范围,包含表示要转换的日期和时间的字符。

format
ReadOnlySpan<Char>

所需的 s格式。

provider
IFormatProvider

一个对象,提供有关 s的区域性特定格式设置信息。

style
DateTimeStyles

一个或多个枚举值的按位组合,指示允许的 s格式。

result
DateTime

此方法返回时,如果转换成功,则包含与 s中包含的日期和时间等效的 DateTime 值;如果转换失败,则 DateTime.MinValue。 如果 sformat 参数 null、为空字符串或不包含与 format中指定的模式对应的日期和时间,则转换失败。 此参数未初始化传递。

返回

如果已成功转换 s,则 true;否则,false

适用于

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

Source:
DateTime.cs
Source:
DateTime.cs
Source:
DateTime.cs

将日期和时间的指定字符范围转换为其等效 DateTime,并返回一个值,该值指示转换是否成功。

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

参数

s
ReadOnlySpan<Char>

包含要分析的字符串的跨度。

formats
String[]

s的允许格式数组。

provider
IFormatProvider

一个对象,提供有关 s的区域性特定格式设置信息。

style
DateTimeStyles

枚举值的按位组合,用于定义如何解释与当前时区或当前日期相关的已分析日期。 要指定的典型值为 None

result
DateTime

此方法返回时,如果转换成功,则包含与 s中包含的日期和时间等效的 DateTime 值;如果转换失败,则 DateTime.MinValue。 如果 s 参数 nullEmpty或不包含日期和时间的有效字符串表示形式,则转换失败。 此参数未初始化传递。

返回

成功转换 s 参数时 true;否则,false

适用于

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

Source:
DateTime.cs
Source:
DateTime.cs
Source:
DateTime.cs

使用指定的格式、区域性特定的格式信息和样式将日期和时间的指定字符串表示形式转换为其等效 DateTime。 字符串表示形式的格式必须与指定的格式完全匹配。 该方法返回一个值,该值指示转换是否成功。

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

参数

s
String

包含要转换的日期和时间的字符串。

format
String

所需的 s格式。

provider
IFormatProvider

一个对象,提供有关 s的区域性特定格式设置信息。

style
DateTimeStyles

一个或多个枚举值的按位组合,指示允许的 s格式。

result
DateTime

此方法返回时,如果转换成功,则包含与 s中包含的日期和时间等效的 DateTime 值;如果转换失败,则 DateTime.MinValue。 如果 sformat 参数 null、为空字符串或不包含与 format中指定的模式对应的日期和时间,则转换失败。 此参数未初始化传递。

返回

如果已成功转换 s,则 true;否则,false

例外

style 不是有效的 DateTimeStyles 值。

-或-

style 包含 DateTimeStyles 值的无效组合(例如,AssumeLocalAssumeUniversal)。

示例

以下示例演示 DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) 方法。 请注意,当 styles 参数等于 DateTimeStyles.None 时,无法成功分析字符串“5/01/2009 8:30 AM”,因为 format不允许前导空格。 此外,字符串“2009/5/01/09:00”无法成功解析为“MM/dd/yyyhh:mm”的 format,因为日期字符串在月份编号之前没有前导零,因为 format 要求。

using System;
using System.Globalization;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    0

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

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

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

注解

DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) 方法分析日期的字符串表示形式,该表示形式必须采用 format 参数定义的格式。 它类似于 DateTime.ParseExact(String, String, IFormatProvider, DateTimeStyles) 方法,只是 TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) 方法在转换失败时不会引发异常。

s 参数包含要分析的日期和时间,并且必须采用 format 参数定义的格式。 如果 s中存在日期、时间和时区元素,则它们还必须按 format指定的顺序显示。 如果 format 定义没有时间元素的日期,并且分析操作成功,则生成的 DateTime 值为午夜(00:00:00)。 如果 format 定义没有日期元素的时间并且分析操作成功,则生成的 DateTime 值默认为 DateTime.Now.Date,或者如果 styles 包含 DateTimeStyles.NoCurrentDateDefault 标志,则其日期为 DateTime.MinValue.Datestyle 参数确定 s 参数是否可以包含前导、内部或尾随空格字符。

如果 s 不包含时区信息,则返回 DateTime 对象的 Kind 属性 DateTimeKind.Unspecified。 可以使用 DateTimeStyles.AssumeLocal 标志来更改此行为,该标志返回 Kind 属性 DateTimeKind.LocalDateTime 值,或者通过使用 DateTimeStyles.AssumeUniversalDateTimeStyles.AdjustToUniversal 标志来更改此行为,该值返回 Kind 属性 DateTimeKind.UtcDateTime 值。 如果 s 包含时区信息,则会根据需要将时间转换为本地时间,并将返回 DateTime 对象的 Kind 属性设置为 DateTimeKind.Local。 可以使用 DateTimeStyles.RoundtripKind 标志将协调世界时(UTC)更改为本地时间,并将 Kind 属性设置为 DateTimeKind.Utc来更改此行为。

format 参数包含与 s 参数的预期格式相对应的模式。 format 参数中的模式由 自定义日期和时间格式字符串 表中的一个或多个自定义格式说明符或一个标准格式说明符(用于从 标准日期和时间格式字符串 表中标识预定义模式)组成。

如果不在自定义格式模式中使用日期或时间分隔符,请使用 provider 参数的固定区域性以及每个自定义格式说明符的最宽格式。 例如,如果要在模式中指定小时数,请指定更宽的窗体“HH”,而不是较窄的窗体“H”。

注意

可以调用 DateTime.TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) 方法并指定多个允许的格式,而不是要求 s 符合分析操作的单个格式。 这使得分析操作更有可能成功。

s 中使用的特定日期和时间符号和字符串(如星期几的名称)由 provider 参数定义,format 是标准格式说明符字符串时 s 的精确格式。 provider 参数可以是以下任一参数:

如果 providernull,则使用与当前区域性对应的 CultureInfo 对象。

styles 参数包括 DateTimeStyles 枚举的一个或多个成员,这些成员确定 format 未定义的空格是否可以出现在 s 中,以及控制分析操作的精确行为。 下表介绍了 DateTimeStyles 枚举的每个成员如何影响 TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) 方法的操作。

DateTimeStyles 成员 描述
AdjustToUniversal 分析 s,并在必要时将其转换为 UTC。 如果 s 包含时区偏移量,或者如果 s 不包含时区信息,但 styles 包含 DateTimeStyles.AssumeLocal 标志,该方法将分析字符串,调用 ToUniversalTime 将返回的 DateTime 值转换为 UTC,并将 Kind 属性设置为 DateTimeKind.Utc。 如果 s 指示它表示 UTC,或者如果 s 不包含时区信息,但 styles 包含 DateTimeStyles.AssumeUniversal 标志,该方法将分析字符串,对返回的 DateTime 值执行时区转换,并将 Kind 属性设置为 DateTimeKind.Utc。 在所有其他情况下,标志不起作用。
AllowInnerWhite 指定 format 未定义的空格可在任何单个日期或时间元素之间显示。
AllowLeadingWhite 指定 format 未定义的空格可以出现在 s的开头。
AllowTrailingWhite 指定 format 未定义的空格可以显示在 s末尾。
AllowWhiteSpaces 指定 s 可能包含 format未定义的前导空格、内部空格和尾随空格。
AssumeLocal 指定如果 s 缺少任何时区信息,则假定它表示本地时间。 除非存在 DateTimeStyles.AdjustToUniversal 标志,否则返回的 DateTime 值的 Kind 属性设置为 DateTimeKind.Local
AssumeUniversal 指定如果 s 缺少任何时区信息,则假定它表示 UTC。 除非存在 DateTimeStyles.AdjustToUniversal 标志,否则该方法将返回的 DateTime 值从 UTC 转换为本地时间,并将其 Kind 属性设置为 DateTimeKind.Local
NoCurrentDateDefault 如果 s 包含没有日期信息的时间,则返回值的日期设置为 DateTime.MinValue.Date
None 使用默认值分析 s 参数。 不允许在 format 中存在的空格。 如果 s 缺少日期组件,则返回的 DateTime 值的日期设置为 1/1/0001。 如果 s 不包含时区信息,则返回 DateTime 对象的 Kind 属性设置为 DateTimeKind.Unspecified。 如果时区信息存在于 s中,则时间将转换为本地时间,并且返回 DateTime 对象的 Kind 属性设置为 DateTimeKind.Local
RoundtripKind 对于包含时区信息的字符串,尝试阻止转换为 DateTime 值,其 Kind 属性设置为 DateTimeKind.Local。 此标志主要阻止将 UTC 时间转换为本地时间。

调用方说明

在 .NET Framework 4 中,如果要分析的字符串包含一小时组件和未达成协议的 AM/PM 设计器,TryParseExact 方法将返回 false。 在 .NET Framework 3.5 及更早版本中,将忽略 AM/PM 设计器。

另请参阅

适用于

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

Source:
DateTime.cs
Source:
DateTime.cs
Source:
DateTime.cs

使用指定的格式、区域性特定的格式信息和样式数组,将日期和时间的指定字符串表示形式转换为其等效 DateTime。 字符串表示形式的格式必须与指定格式中的至少一种格式完全匹配。 该方法返回一个值,该值指示转换是否成功。

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

参数

s
String

包含要转换的日期和时间的字符串。

formats
String[]

s的允许格式数组。

provider
IFormatProvider

一个对象,提供有关 s的区域性特定格式信息。

style
DateTimeStyles

枚举值的按位组合,指示允许的 s格式。 要指定的典型值为 None

result
DateTime

此方法返回时,如果转换成功,则包含与 s中包含的日期和时间等效的 DateTime 值;如果转换失败,则 DateTime.MinValue。 如果 nullsformats,则转换失败,sformats 元素为空字符串,或者 s 的格式不完全按 formats中至少一种格式模式指定。 此参数未初始化传递。

返回

成功转换 s 参数时 true;否则,false

例外

style 不是有效的 DateTimeStyles 值。

-或-

style 包含 DateTimeStyles 值的无效组合(例如,AssumeLocalAssumeUniversal)。

示例

以下示例使用 DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) 方法来确保可以成功分析具有多种可能格式的字符串。

using System;
using System.Globalization;

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

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

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

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

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


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

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

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

注解

DateTime.TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) 方法分析与分配给 formats 参数的任何模式匹配的日期的字符串表示形式。 就像 DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles) 方法一样,除非 TryParseExact 方法在转换失败时不会引发异常。

s 参数包含要分析的日期和时间。 如果 s 参数仅包含一个时间和没有日期,则使用当前日期,除非 style 参数包含 DateTimeStyles.NoCurrentDateDefault 标志,在这种情况下使用默认日期(DateTime.Date.MinValue)。 如果 s 参数仅包含日期且没有时间,则使用午夜 (00:00:00) 。 style 参数还确定 s 参数是否可以包含前导、内部或尾随空格字符,而不是 formats中某个格式字符串允许的空格字符。

如果 s 不包含时区信息,则返回 DateTime 对象的 Kind 属性 DateTimeKind.Unspecified。 可以使用 DateTimeStyles.AssumeLocal 标志来更改此行为,该标志返回 Kind 属性 DateTimeKind.LocalDateTime 值,或者通过使用 DateTimeStyles.AssumeUniversalDateTimeStyles.AdjustToUniversal 标志来更改此行为,该值返回 Kind 属性 DateTimeKind.UtcDateTime 值。 如果 s 包含时区信息,则会根据需要将时间转换为本地时间,并将返回 DateTime 对象的 Kind 属性设置为 DateTimeKind.Local。 可以使用 DateTimeStyles.RoundtripKind 标志将协调世界时(UTC)更改为本地时间,并将 Kind 属性设置为 DateTimeKind.Utc来更改此行为。

formats 参数包含模式数组,其中一个模式 s 在分析操作成功时必须完全匹配。 formats 参数中的模式由 自定义日期和时间格式字符串 表中的一个或多个自定义格式说明符或一个标准格式说明符(用于标识预定义模式)从 标准日期和时间格式字符串 表中组成。

如果不在自定义格式模式中使用日期或时间分隔符,请使用 provider 参数的固定区域性以及每个自定义格式说明符的最宽格式。 例如,如果要在模式中指定小时数,请指定更宽的窗体“HH”,而不是较窄的窗体“H”。

s 中使用的特定日期和时间符号和字符串(如星期几的名称)由 provider 参数定义,format 是标准格式说明符字符串时 s 的精确格式。 provider 参数可以是以下任一参数:

如果 providernull,则使用与当前区域性对应的 CultureInfo 对象。

styles 参数包括 DateTimeStyles 枚举的一个或多个成员,这些成员确定 format 未定义的空格是否可以出现在 s 中,以及控制分析操作的精确行为。 下表介绍了 DateTimeStyles 枚举的每个成员如何影响 TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) 方法的操作。

DateTimeStyles 成员 描述
AdjustToUniversal 分析 s,并在必要时将其转换为 UTC。 如果 s 包含时区偏移量,或者如果 s 不包含时区信息,但 styles 包含 DateTimeStyles.AssumeLocal 标志,该方法将分析字符串,调用 ToUniversalTime 将返回的 DateTime 值转换为 UTC,并将 Kind 属性设置为 DateTimeKind.Utc。 如果 s 指示它表示 UTC,或者如果 s 不包含时区信息,但 styles 包含 DateTimeStyles.AssumeUniversal 标志,该方法将分析字符串,对返回的 DateTime 值执行时区转换,并将 Kind 属性设置为 DateTimeKind.Utc。 在所有其他情况下,标志不起作用。
AllowInnerWhite 指定 format 未定义的空格可在任何单个日期或时间元素之间显示。
AllowLeadingWhite 指定 format 未定义的空格可以出现在 s的开头。
AllowTrailingWhite 指定 format 未定义的空格可以显示在 s末尾。
AllowWhiteSpaces 指定 s 可能包含 format未定义的前导空格、内部空格和尾随空格。
AssumeLocal 指定如果 s 缺少任何时区信息,则假定它表示本地时间。 除非存在 DateTimeStyles.AdjustToUniversal 标志,否则返回的 DateTime 值的 Kind 属性设置为 DateTimeKind.Local
AssumeUniversal 指定如果 s 缺少任何时区信息,则假定它表示 UTC。 除非存在 DateTimeStyles.AdjustToUniversal 标志,否则该方法将返回的 DateTime 值从 UTC 转换为本地时间,并将其 Kind 属性设置为 DateTimeKind.Local
NoCurrentDateDefault 如果 s 包含没有日期信息的时间,则返回值的日期设置为 DateTime.MinValue.Date
None 使用默认值分析 s 参数。 不允许在 format 中存在的空格。 如果 s 缺少日期组件,则返回的 DateTime 值的日期设置为 1/1/0001。 如果 s 不包含时区信息,则返回 DateTime 对象的 Kind 属性设置为 DateTimeKind.Unspecified。 如果时区信息存在于 s中,则时间将转换为本地时间,并且返回 DateTime 对象的 Kind 属性设置为 DateTimeKind.Local
RoundtripKind 对于包含时区信息的字符串,尝试阻止转换为 DateTime 值,其 Kind 属性设置为 DateTimeKind.Local。 此标志主要阻止将 UTC 时间转换为本地时间。

调用方说明

在 .NET Framework 4 中,如果要分析的字符串包含一小时组件和未达成协议的 AM/PM 设计器,TryParseExact 方法将返回 false。 在 .NET Framework 3.5 及更早版本中,将忽略 AM/PM 设计器。

另请参阅

适用于