DateTimeOffset.TryParse Método

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

public:
 static bool TryParse(System::String ^ input, IFormatProvider ^ formatProvider, System::Globalization::DateTimeStyles styles, [Runtime::InteropServices::Out] DateTimeOffset % result);

public static bool TryParse(string input, IFormatProvider formatProvider, System.Globalization.DateTimeStyles styles, out DateTimeOffset result);

public static bool TryParse(string? input, IFormatProvider? formatProvider, System.Globalization.DateTimeStyles styles, out DateTimeOffset result);

static member TryParse : string * IFormatProvider * System.Globalization.DateTimeStyles * DateTimeOffset -> bool

Public Shared Function TryParse (input As String, formatProvider As IFormatProvider, styles As DateTimeStyles, ByRef result As DateTimeOffset) As Boolean

Parâmetros

Devoluções

true se o input parâmetro for convertido com sucesso; caso contrário, false.

Exceções

Exemplos

O exemplo seguinte chama o TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset) método com uma variedade de DateTimeStyles valores para analisar algumas cadeias com vários formatos de data e hora.

string dateString;
DateTimeOffset parsedDate;

dateString = "05/01/2008 6:00:00";
// Assume time is local
if (DateTimeOffset.TryParse(dateString, null as IFormatProvider,
                            DateTimeStyles.AssumeLocal,
                            out parsedDate))
   Console.WriteLine("'{0}' was converted to {1}.",
                     dateString, parsedDate.ToString());
else
   Console.WriteLine("Unable to parse '{0}'.", dateString);

// Assume time is UTC
if (DateTimeOffset.TryParse(dateString, null as IFormatProvider,
                            DateTimeStyles.AssumeUniversal,
                            out parsedDate))
   Console.WriteLine("'{0}' was converted to {1}.",
                     dateString, parsedDate.ToString());
else
   Console.WriteLine("Unable to parse '{0}'.", dateString);

// Parse and convert to UTC
dateString = "05/01/2008 6:00:00AM +5:00";
if (DateTimeOffset.TryParse(dateString, null as IFormatProvider,
                           DateTimeStyles.AdjustToUniversal,
                           out parsedDate))
   Console.WriteLine("'{0}' was converted to {1}.",
                     dateString, parsedDate.ToString());
else
   Console.WriteLine("Unable to parse '{0}'.", dateString);
// The example displays the following output to the console:
//    '05/01/2008 6:00:00' was converted to 5/1/2008 6:00:00 AM -07:00.
//    '05/01/2008 6:00:00' was converted to 5/1/2008 6:00:00 AM +00:00.
//    '05/01/2008 6:00:00AM +5:00' was converted to 5/1/2008 1:00:00 AM +00:00.

let dateString = "05/01/2008 6:00:00"
// Assume time is local
match DateTimeOffset.TryParse(dateString, null, DateTimeStyles.AssumeLocal) with
| true, parsedDate ->
    printfn $"'{dateString}' was converted to {parsedDate}."
| _ ->
    printfn $"Unable to parse '{dateString}'."

// Assume time is UTC
match DateTimeOffset.TryParse(dateString, null, DateTimeStyles.AssumeUniversal) with
| true, parsedDate ->
    printfn $"'{dateString}' was converted to {parsedDate}."
| _ ->
    printfn $"Unable to parse '{dateString}'."

// Parse and convert to UTC
let dateString = "05/01/2008 6:00:00AM +5:00"
match DateTimeOffset.TryParse(dateString, null, DateTimeStyles.AdjustToUniversal) with
| true, parsedDate ->
    printfn $"'{dateString}' was converted to {parsedDate}."
| _ ->
    printfn $"Unable to parse '{dateString}'."

// The example displays the following output to the console:
//    '05/01/2008 6:00:00' was converted to 5/1/2008 6:00:00 AM -07:00.
//    '05/01/2008 6:00:00' was converted to 5/1/2008 6:00:00 AM +00:00.
//    '05/01/2008 6:00:00AM +5:00' was converted to 5/1/2008 1:00:00 AM +00:00.

Dim dateString As String
Dim parsedDate As DateTimeOffset

dateString = "05/01/2008 6:00:00"
' Assume time is local 
If DateTimeOffset.TryParse(dateString, Nothing, _
                           DateTimeStyles.AssumeLocal, _
                           parsedDate) Then
   Console.WriteLine("'{0}' was converted to {1}.", _
                     dateString, parsedDate.ToString())
Else
   Console.WriteLine("Unable to parse '{0}'.", dateString)    
End If

' Assume time is UTC
If DateTimeOffset.TryParse(dateString, Nothing, _
                           DateTimeStyles.AssumeUniversal, _
                           parsedDate) Then
   Console.WriteLine("'{0}' was converted to {1}.", _
                     dateString, parsedDate.ToString())
Else
   Console.WriteLine("Unable to parse '{0}'.", dateString)    
End If

' Parse and convert to UTC 
dateString = "05/01/2008 6:00:00AM +5:00"
If DateTimeOffset.TryParse(dateString, Nothing, _
                           DateTimeStyles.AdjustToUniversal, _
                           parsedDate) Then
   Console.WriteLine("'{0}' was converted to {1}.", _
                     dateString, parsedDate.ToString())
Else
   Console.WriteLine("Unable to parse '{0}'.", dateString)    
End If
' The example displays the following output to the console:
'    '05/01/2008 6:00:00' was converted to 5/1/2008 6:00:00 AM -07:00.
'    '05/01/2008 6:00:00' was converted to 5/1/2008 6:00:00 AM +00:00.
'    '05/01/2008 6:00:00AM +5:00' was converted to 5/1/2008 1:00:00 AM +00:00.

Observações

Esta sobrecarga do TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset) método é semelhante ao DateTimeOffset.Parse(String, IFormatProvider, DateTimeStyles) método, exceto que não lança uma exceção se a conversão falhar. O método analisa uma cadeia com três elementos que podem aparecer em qualquer ordem e são delimitados por espaços em branco. Estes três elementos são apresentados na tabela seguinte.

Elemento	Example
<Data>	"2/10/2007"
<Tempo>	"13:02:03"
<Deslocamento>	"-7:30"

Embora cada um destes elementos seja opcional, <o Deslocamento> não pode aparecer sozinho. Deve ser fornecido juntamente com <a data> ou <a hora>. Se <a Data> estiver em falta, o seu valor padrão é o dia atual. Se <a Data> estiver presente mas o seu componente anual consistir apenas em dois dígitos, é convertida para um ano no provider calendário atual do parâmetro com base no valor da Calendar.TwoDigitYearMax propriedade. Se <o Time> estiver em falta, o seu valor padrão é 12:00:00 AM. Se o deslocamento< estiver em falta, o seu valor por defeito é o deslocamento do fuso horário local, ou > se o Zero valor ou DateTimeStyles.AdjustToUniversal for especificado em DateTimeStyles.AssumeUniversal.styles Se <o deslocamento> estiver presente, pode representar um deslocamento negativo ou positivo em relação ao Tempo Universal Coordenado (UTC). Em qualquer dos casos, <o deslocamento> deve incluir um símbolo de sinal ou o método devolve false.

A input cadeia é analisada usando a informação de formatação específica da cultura num DateTimeFormatInfo objeto fornecido pelo formatProvider parâmetro. O formatProvider parâmetro pode ser um dos seguintes:

• Um CultureInfo objeto que representa a cultura cuja formatação é usada em input. O DateTimeFormatInfo objeto devolvido pela CultureInfo.DateTimeFormat propriedade define o formato que é usado em input.

• Um DateTimeFormatInfo objeto que define o formato dos dados de data e hora.

Além disso, cada elemento pode ser delimitado por espaços em branco à frente ou ao fim, e os <componentes Data> e <Hora> podem incluir espaço em branco interior (como 6: 00:00). Apenas o <componente Offset> não pode incluir espaço em branco interior.

Se provider for null, o CultureInfo objeto que corresponde à cultura atual é usado.

O sinal positivo ou negativo usado no <Deslocamento> deve ser ou + ou -. Não é definido pelas PositiveSign propriedades ou NegativeSign do NumberFormatInfo objeto devolvidas pela formatprovider propriedade do NumberFormat parâmetro.

Os seguintes membros da DateTimeStyles enumeração são suportados:

Membro do DateTimeStyles	Comentários
AdjustToUniversal	Analisa a cadeia representada por input e, se necessário, converte-a para UTC. É equivalente a analisar uma cadeia e depois chamar o método do ToUniversalTime() objeto devolvido.
AllowInnerWhite	Embora válido, esse valor é ignorado. O espaço em branco interior é permitido nos <componentes Data> e <Hora> .
AllowLeadingWhite	Embora válido, esse valor é ignorado. O espaço em branco inicial é permitido à frente de cada componente da cadeia analisada.
AllowTrailingWhite	Embora válido, esse valor é ignorado. O espaço em branco final é permitido à frente de cada componente da cadeia analisada.
AllowWhiteSpaces	Este é o comportamento padrão. Não pode ser anulado fornecendo um valor de enumeração mais restritivo DateTimeStyles , como DateTimeStyles.None.
AssumeLocal	Indica que, se o input parâmetro não tiver um <elemento de deslocamento> , o deslocamento do fuso horário local deve ser fornecido. Este é o comportamento padrão do TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset) método.
AssumeUniversal	Indica que, se o input parâmetro não tiver um <elemento de deslocamento> , o deslocamento UTC (00:00) deve ser fornecido.
None	Embora válido, este valor é ignorado e não tem efeito.
RoundtripKind	Como a DateTimeOffset estrutura não inclui uma Kind propriedade, este valor não tem efeito.

Apenas o DateTimeStyles.NoCurrentDateDefault valor não é suportado. An ArgumentException é lançado se este valor for incluído no styles parâmetro.

Ver também

• Parse

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

public:
 static bool TryParse(ReadOnlySpan<char> input, IFormatProvider ^ formatProvider, System::Globalization::DateTimeStyles styles, [Runtime::InteropServices::Out] DateTimeOffset % result);

public static bool TryParse(ReadOnlySpan<char> input, IFormatProvider? formatProvider, System.Globalization.DateTimeStyles styles, out DateTimeOffset result);

public static bool TryParse(ReadOnlySpan<char> input, IFormatProvider formatProvider, System.Globalization.DateTimeStyles styles, out DateTimeOffset result);

static member TryParse : ReadOnlySpan<char> * IFormatProvider * System.Globalization.DateTimeStyles * DateTimeOffset -> bool

Public Shared Function TryParse (input As ReadOnlySpan(Of Char), formatProvider As IFormatProvider, styles As DateTimeStyles, ByRef result As DateTimeOffset) As Boolean

Parâmetros

Devoluções

true se o input parâmetro for convertido com sucesso; caso contrário, false.

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

public:
 static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] DateTimeOffset % result) = IParsable<DateTimeOffset>::TryParse;

public static bool TryParse(string? s, IFormatProvider? provider, out DateTimeOffset result);

static member TryParse : string * IFormatProvider * DateTimeOffset -> bool

Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As DateTimeOffset) As Boolean

Parâmetros

Devoluções

true se s foi analisado com sucesso; caso contrário, false.

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

public:
 static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] DateTimeOffset % result) = ISpanParsable<DateTimeOffset>::TryParse;

public static bool TryParse(ReadOnlySpan<char> s, IFormatProvider? provider, out DateTimeOffset result);

static member TryParse : ReadOnlySpan<char> * IFormatProvider * DateTimeOffset -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As DateTimeOffset) As Boolean

Parâmetros

Devoluções

true se s foi analisado com sucesso; caso contrário, false.

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

public:
 static bool TryParse(ReadOnlySpan<char> input, [Runtime::InteropServices::Out] DateTimeOffset % result);

public static bool TryParse(ReadOnlySpan<char> input, out DateTimeOffset result);

static member TryParse : ReadOnlySpan<char> * DateTimeOffset -> bool

Public Shared Function TryParse (input As ReadOnlySpan(Of Char), ByRef result As DateTimeOffset) As Boolean

Parâmetros

Devoluções

true se o input parâmetro for convertido com sucesso; caso contrário, false.

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

public:
 static bool TryParse(System::String ^ input, [Runtime::InteropServices::Out] DateTimeOffset % result);

public static bool TryParse(string input, out DateTimeOffset result);

public static bool TryParse(string? input, out DateTimeOffset result);

static member TryParse : string * DateTimeOffset -> bool

Public Shared Function TryParse (input As String, ByRef result As DateTimeOffset) As Boolean

Parâmetros

Devoluções

true se o input parâmetro for convertido com sucesso; caso contrário, false.

Exemplos

O exemplo seguinte chama o TryParse(String, DateTimeOffset) método para analisar várias cadeias com vários formatos de data e hora.

DateTimeOffset parsedDate;
string dateString;

// String with date only
dateString = "05/01/2008";
if (DateTimeOffset.TryParse(dateString, out parsedDate))
   Console.WriteLine("{0} was converted to {1}.",
                     dateString, parsedDate);

// String with time only
dateString = "11:36 PM";
if (DateTimeOffset.TryParse(dateString, out parsedDate))
   Console.WriteLine("{0} was converted to {1}.",
                     dateString, parsedDate);

// String with date and offset
dateString = "05/01/2008 +7:00";
if (DateTimeOffset.TryParse(dateString, out parsedDate))
   Console.WriteLine("{0} was converted to {1}.",
                     dateString, parsedDate);

// String with day abbreviation
dateString = "Thu May 01, 2008";
if (DateTimeOffset.TryParse(dateString, out parsedDate))
   Console.WriteLine("{0} was converted to {1}.",
                     dateString, parsedDate);

// String with date, time with AM/PM designator, and offset
dateString = "5/1/2008 10:00 AM -07:00";
if (DateTimeOffset.TryParse(dateString, out parsedDate))
   Console.WriteLine("{0} was converted to {1}.",
                     dateString, parsedDate);
// if (run on 3/29/07, the example displays the following output
// to the console:
//    05/01/2008 was converted to 5/1/2008 12:00:00 AM -07:00.
//    11:36 PM was converted to 3/29/2007 11:36:00 PM -07:00.
//    05/01/2008 +7:00 was converted to 5/1/2008 12:00:00 AM +07:00.
//    Thu May 01, 2008 was converted to 5/1/2008 12:00:00 AM -07:00.
//    5/1/2008 10:00 AM -07:00 was converted to 5/1/2008 10:00:00 AM -07:00.

// String with date only
let dateString = "05/01/2008"
match DateTimeOffset.TryParse dateString with
| true, parsedDate ->
    printfn $"{dateString} was converted to {parsedDate}."
| _ -> ()

// String with time only
let dateString = "11:36 PM"
match DateTimeOffset.TryParse dateString with
| true, parsedDate ->
    printfn $"{dateString} was converted to {parsedDate}."
| _ -> ()

// String with date and offset
let dateString = "05/01/2008 +7:00"
match DateTimeOffset.TryParse dateString with
| true, parsedDate ->
    printfn $"{dateString} was converted to {parsedDate}."
| _ -> ()

// String with day abbreviation
let dateString = "Thu May 01, 2008"
match DateTimeOffset.TryParse dateString with
| true, parsedDate ->
    printfn $"{dateString} was converted to {parsedDate}."
| _ -> ()

// String with date, time with AM/PM designator, and offset
let dateString = "5/1/2008 10:00 AM -07:00"
match DateTimeOffset.TryParse dateString with
| true, parsedDate ->
    printfn $"{dateString} was converted to {parsedDate}."
| _ -> ()

// if (run on 3/29/07, the example displays the following output
// to the console:
//    05/01/2008 was converted to 5/1/2008 12:00:00 AM -07:00.
//    11:36 PM was converted to 3/29/2007 11:36:00 PM -07:00.
//    05/01/2008 +7:00 was converted to 5/1/2008 12:00:00 AM +07:00.
//    Thu May 01, 2008 was converted to 5/1/2008 12:00:00 AM -07:00.
//    5/1/2008 10:00 AM -07:00 was converted to 5/1/2008 10:00:00 AM -07:00.

Dim parsedDate As DateTimeOffset
Dim dateString As String

' String with date only
dateString = "05/01/2008"
If DateTimeOffset.TryParse(dateString, parsedDate) Then _
   Console.WriteLine("{0} was converted to {1}.", _
                     dateString, parsedDate)

' String with time only
dateString = "11:36 PM"
If DateTimeOffset.TryParse(dateString, parsedDate) Then _
   Console.WriteLine("{0} was converted to {1}.", _
                     dateString, parsedDate)

' String with date and offset 
dateString = "05/01/2008 +7:00"
If DateTimeOffset.TryParse(dateString, parsedDate) Then _
   Console.WriteLine("{0} was converted to {1}.", _
                     dateString, parsedDate)

' String with day abbreviation
dateString = "Thu May 01, 2008"
If DateTimeOffset.TryParse(dateString, parsedDate) Then _
   Console.WriteLine("{0} was converted to {1}.", _
                     dateString, parsedDate)

' String with date, time with AM/PM designator, and offset
dateString = "5/1/2008 10:00 AM -07:00"
If DateTimeOffset.TryParse(dateString, parsedDate) Then _
   Console.WriteLine("{0} was converted to {1}.", _
                     dateString, parsedDate)
' If run on 3/29/07, the example displays the following output
' to the console:
'    05/01/2008 was converted to 5/1/2008 12:00:00 AM -07:00.
'    11:36 PM was converted to 3/29/2007 11:36:00 PM -07:00.
'    05/01/2008 +7:00 was converted to 5/1/2008 12:00:00 AM +07:00.
'    Thu May 01, 2008 was converted to 5/1/2008 12:00:00 AM -07:00.
'    5/1/2008 10:00 AM -07:00 was converted to 5/1/2008 10:00:00 AM -07:00.

Observações

Esta sobrecarga do TryParse(String, DateTimeOffset) método é semelhante ao DateTimeOffset.Parse(String) método, exceto que não lança uma exceção se a conversão falhar. Analisa uma cadeia com três elementos que podem aparecer em qualquer ordem e são delimitados por espaços em branco. Estes três elementos são apresentados na tabela seguinte.

Elemento	Example
<Data>	"2/10/2007"
<Tempo>	"13:02:03"
<Deslocamento>	"-7:30"

Embora cada um destes elementos seja opcional, <o Deslocamento> não pode aparecer sozinho. Deve ser fornecido juntamente com <a data> ou <a hora>. Se <a Data> estiver em falta, o seu valor padrão é o dia atual. Se <a Data> estiver presente mas o seu componente anual consistir apenas em dois dígitos, é convertida para um ano no calendário atual da cultura atual com base no valor da Calendar.TwoDigitYearMax propriedade. Se <o Time> estiver em falta, o seu valor padrão é 12:00:00 AM. Se <o deslocamento> estiver em falta, o seu valor padrão é o deslocamento do fuso horário local. Se <o deslocamento> estiver presente, pode representar um deslocamento negativo ou positivo em relação ao Tempo Universal Coordenado (UTC). Em qualquer dos casos, <o deslocamento> deve incluir um símbolo de sinal ou o método devolve false.

A input cadeia é analisada utilizando a informação de formatação num DateTimeFormatInfo objeto inicializado para a cultura atual. Para analisar uma cadeia que contenha formatação designada que não corresponde necessariamente à da cultura atual, use o TryParseExact método e forneça um especificador de formato.

Ver também

• Parse
• Exemplo: Utilitário de formatação WinForms .NET Core (C#)
• Exemplo: Utilitário de formatação do .NET Core WinForms (Visual Basic)