DateTimeOffset.TryParseExact Método

Definição

Converte a representação de cadeia de caracteres especificada de uma data e hora em seu DateTimeOffset equivalente. O formato da representação de cadeia de caracteres deve corresponder exatamente a um formato especificado.

Sobrecargas

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

Converte a representação de cadeia de caracteres especificada de uma data e hora em seu DateTimeOffset equivalente usando a matriz especificada de formatos, informações de formato específicas da cultura e estilo. O formato da representação de cadeia de caracteres deve corresponder exatamente a um dos formatos especificados.

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

Converte a representação de uma data e hora em um intervalo de caracteres em seu DateTimeOffset equivalente usando o formato especificado, as informações de formato específicas da cultura e o estilo. O formato da representação de data e hora deve corresponder exatamente ao formato especificado.

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

Converte a representação de uma data e hora em um intervalo de caracteres em seu DateTimeOffset equivalente usando os formatos especificados, as informações de formato específicas da cultura e o estilo. O formato da representação de data e hora deve corresponder exatamente a um dos formatos especificados.

TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset)

Converte a representação de cadeia de caracteres especificada de uma data e hora em seu DateTimeOffset equivalente usando o formato especificado, as informações de formato específicas da cultura e o estilo. O formato da representação de cadeia de caracteres deve corresponder exatamente ao formato especificado.

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

Origem:
DateTimeOffset.cs
Origem:
DateTimeOffset.cs
Origem:
DateTimeOffset.cs

Converte a representação de cadeia de caracteres especificada de uma data e hora em seu DateTimeOffset equivalente usando a matriz especificada de formatos, informações de formato específicas da cultura e estilo. O formato da representação de cadeia de caracteres deve corresponder exatamente a um dos formatos especificados.

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

Parâmetros

input
String

Uma cadeia de caracteres que contém uma data e hora a serem convertidas.

formats
String[]

Uma matriz que define os formatos esperados de input.

formatProvider
IFormatProvider

Um objeto que fornece informações de formatação específicas da cultura sobre input.

styles
DateTimeStyles

Uma combinação bit a bit de valores de enumeração que indica o formato permitido de entrada. Um valor típico a ser especificado é None.

result
DateTimeOffset

Quando o método é retornado, contém o DateTimeOffset equivalente à data e hora de input, se a conversão foi bem-sucedida ou DateTimeOffset.MinValue, se a conversão falhou. A conversão falhará se o input não contiver uma representação de cadeia de caracteres válida de uma data e hora ou não contiver a data e a hora no formato esperado definido por formatsou se formats for null. Esse parâmetro é passado sem inicialização.

Retornos

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

Exceções

styles inclui um valor de DateTimeStyles indefinido.

-ou-

não há suporte para NoCurrentDateDefault.

-ou-

styles inclui valores de DateTimeStyles mutuamente exclusivos.

Exemplos

O exemplo a seguir define vários formatos de entrada para a representação de cadeia de caracteres de um valor de data e hora e deslocamento e, em seguida, passa a cadeia de caracteres inserida pelo usuário para o método TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset).

TextReader conIn = Console.In;
TextWriter conOut = Console.Out;
int tries = 0;
string input = String.Empty;

string[] formats = new string[] {"M/dd/yyyy HH:m zzz", "MM/dd/yyyy HH:m zzz",
                                 "M/d/yyyy HH:m zzz", "MM/d/yyyy HH:m zzz",
                                 "M/dd/yy HH:m zzz", "MM/dd/yy HH:m zzz",
                                 "M/d/yy HH:m zzz", "MM/d/yy HH:m zzz",
                                 "M/dd/yyyy H:m zzz", "MM/dd/yyyy H:m zzz",
                                 "M/d/yyyy H:m zzz", "MM/d/yyyy H:m zzz",
                                 "M/dd/yy H:m zzz", "MM/dd/yy H:m zzz",
                                 "M/d/yy H:m zzz", "MM/d/yy H:m zzz",
                                 "M/dd/yyyy HH:mm zzz", "MM/dd/yyyy HH:mm zzz",
                                 "M/d/yyyy HH:mm zzz", "MM/d/yyyy HH:mm zzz",
                                 "M/dd/yy HH:mm zzz", "MM/dd/yy HH:mm zzz",
                                 "M/d/yy HH:mm zzz", "MM/d/yy HH:mm zzz",
                                 "M/dd/yyyy H:mm zzz", "MM/dd/yyyy H:mm zzz",
                                 "M/d/yyyy H:mm zzz", "MM/d/yyyy H:mm zzz",
                                 "M/dd/yy H:mm zzz", "MM/dd/yy H:mm zzz",
                                 "M/d/yy H:mm zzz", "MM/d/yy H:mm zzz"};
IFormatProvider provider = CultureInfo.InvariantCulture.DateTimeFormat;
DateTimeOffset result;

do {
   conOut.WriteLine("Enter a date, time, and offset (MM/DD/YYYY HH:MM +/-HH:MM),");
   conOut.Write("Then press Enter: ");
   input = conIn.ReadLine();
   conOut.WriteLine();
   if (DateTimeOffset.TryParseExact(input, formats, provider,
                                   DateTimeStyles.AllowWhiteSpaces,
                                   out result))
   {
      break;
   }
   else
   {
      Console.WriteLine("Unable to parse {0}.", input);
      tries++;
   }
} while (tries < 3);
if (tries >= 3)
   Console.WriteLine("Exiting application without parsing {0}", input);
else
   Console.WriteLine("{0} was converted to {1}", input, result.ToString());
// Some successful sample interactions with the user might appear as follows:
//    Enter a date, time, and offset (MM/DD/YYYY HH:MM +/-HH:MM),
//    Then press Enter: 12/08/2007 6:54 -6:00
//
//    12/08/2007 6:54 -6:00 was converted to 12/8/2007 6:54:00 AM -06:00
//
//    Enter a date, time, and offset (MM/DD/YYYY HH:MM +/-HH:MM),
//    Then press Enter: 12/8/2007 06:54 -06:00
//
//    12/8/2007 06:54 -06:00 was converted to 12/8/2007 6:54:00 AM -06:00
//
//    Enter a date, time, and offset (MM/DD/YYYY HH:MM +/-HH:MM),
//    Then press Enter: 12/5/07 6:54 -6:00
//
//    12/5/07 6:54 -6:00 was converted to 12/5/2007 6:54:00 AM -06:00

Comentários

O método TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) analisa a representação de cadeia de caracteres de uma data que corresponde a qualquer um dos padrões atribuídos à matriz formats. Se a cadeia de caracteres input não corresponder a nenhum desses padrões com quaisquer variações definidas pelo parâmetro styles, a operação de análise falhará e o método retornará false. Além de comparar input com várias cadeias de caracteres que contêm especificadores de formato, essa sobrecarga se comporta de forma idêntica ao método DateTimeOffset.ParseExact(String, String[], IFormatProvider, DateTimeStyles).

O parâmetro formats é uma matriz de cadeia de caracteres cujos elementos contêm um único especificador de formato padrão ou um ou mais especificadores de formato personalizado que definem o padrão possível de input. Para obter detalhes sobre códigos de formatação válidos, consulte cadeias de caracteres de formato de data e hora padrão e cadeias de caracteres de formato de data e hora personalizadas. Se o elemento correspondente em formats incluir os especificadores de z, zzou zzz formato personalizado para indicar que um deslocamento deve estar presente em input, esse deslocamento deve incluir um sinal negativo ou um sinal positivo. Se o sinal estiver ausente, a operação de análise falhará e o método retornará false.

Importante

Usar o parâmetro formats dessa sobrecarga para especificar vários formatos pode ajudar a reduzir a frustração que muitos usuários experimentam ao inserir datas e horas. Em particular, a capacidade de definir vários padrões de entrada permite que um aplicativo lide com representações de data e hora que podem incluir ou não zeros à esquerda em meses, dias, horas, minutos e segundos. O exemplo fornece uma ilustração disso.

Se o elemento correspondente no formats exigir que input contenham uma data, mas não uma hora, o objeto DateTimeOffset resultante recebe uma hora de meia-noite (0:00:00). Se o elemento correspondente no formats exigir que a entrada contenha uma hora, mas não uma data, o objeto DateTimeOffset resultante recebe a data atual no sistema local. Se o elemento correspondente em formats não exigir que input contenham um deslocamento, o deslocamento do objeto DateTimeOffset resultante depende do valor do parâmetro styles. Se styles incluir AssumeLocal, o deslocamento do fuso horário local será atribuído ao objeto DateTimeOffset. Se styles incluir AssumeUniversal, o deslocamento UTC (Tempo Universal Coordenado) ou +00:00, será atribuído ao objeto DateTimeOffset. Se nenhum dos valores for especificado, o deslocamento do fuso horário local será usado.

Os símbolos e cadeias de caracteres de data e hora específicos usados em input são definidos pelo parâmetro formatProvider. O mesmo vale para o padrão preciso de input se o elemento correspondente de formats for uma cadeia de caracteres do especificador de formato padrão. O parâmetro formatProvider pode ser um dos seguintes:

Se formatprovider for null, o objeto CultureInfo que corresponde à cultura atual será usado.

O parâmetro styles define se o espaço em branco é permitido na cadeia de caracteres de entrada, indica como cadeias de caracteres sem um componente de deslocamento explícito são analisadas e dá suporte à conversão UTC como parte da operação de análise. Todos os membros da enumeração DateTimeStyles têm suporte, exceto NoCurrentDateDefault. A tabela a seguir lista o efeito de cada membro com suporte.

membro DateTimeStyles Comportamento
AdjustToUniversal Analisa input e, se necessário, converte-o em UTC. É equivalente a analisar uma cadeia de caracteres e chamar o método DateTimeOffset.ToUniversalTime do objeto DateTimeOffset retornado.
AssumeLocal Se o elemento correspondente em formats não exigir que input contenham um valor de deslocamento, o objeto DateTimeOffset retornado recebe o deslocamento do fuso horário local. Esse é o valor padrão.
AssumeUniversal Se o elemento correspondente no formats não exigir que input contenham um valor de deslocamento, o objeto DateTimeOffset retornado recebe o deslocamento UTC (+00:00).
AllowInnerWhite Permite que input incluam espaço em branco interno não especificado pelos elementos em formats. O espaço em branco extra pode aparecer entre componentes de data e hora e dentro de componentes individuais (exceto para o deslocamento) e é ignorado ao analisar a cadeia de caracteres.
AllowLeadingWhite Permite que input incluam espaços à esquerda não especificados pelos elementos em formats. Elas são ignoradas ao analisar a cadeia de caracteres.
AllowTrailingWhite Permite que input incluam espaços à direita não especificados pelos elementos em formats. Elas são ignoradas ao analisar a cadeia de caracteres.
AllowWhiteSpaces Permite que input incluam espaços à esquerda, à direita e internos não especificados pelos elementos em formats. Todos os caracteres de espaço em branco extras não especificados no elemento correspondente em formats são ignorados ao analisar a cadeia de caracteres.
None Indica que espaço em branco adicional não é permitido em input. O espaço em branco deve aparecer exatamente como especificado em um elemento específico em formats para que uma correspondência bem-sucedida ocorra. Esse é o comportamento padrão.
RoundtripKind Não tem efeito porque a estrutura de DateTimeOffset não inclui uma propriedade Kind.

Notas aos Chamadores

No .NET Framework 4, o TryParseExact retornará false se a cadeia de caracteres a ser analisada contiver um componente de hora e um designador AM/PM que não estão de acordo. No .NET Framework 3.5 e versões anteriores, o designador AM/PM é ignorado.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Origem:
DateTimeOffset.cs
Origem:
DateTimeOffset.cs
Origem:
DateTimeOffset.cs

Converte a representação de uma data e hora em um intervalo de caracteres em seu DateTimeOffset equivalente usando o formato especificado, as informações de formato específicas da cultura e o estilo. O formato da representação de data e hora deve corresponder exatamente ao formato especificado.

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

Parâmetros

input
ReadOnlySpan<Char>

Um intervalo que contém os caracteres que representam uma data e hora a serem convertidos.

format
ReadOnlySpan<Char>

Um especificador de formato que define o formato necessário de input.

formatProvider
IFormatProvider

Um objeto que fornece informações de formatação específicas da cultura sobre input.

styles
DateTimeStyles

Uma combinação bit a bit de valores de enumeração que indica o formato permitido de input. Um valor típico a ser especificado é None.

result
DateTimeOffset

Quando o método é retornado, contém o DateTimeOffset equivalente à data e hora de input, se a conversão foi bem-sucedida ou DateTimeOffset.MinValue se a conversão falhou. A conversão falhará se o

Retornos

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

Exceções

styles inclui um valor de DateTimeStyles indefinido. Não há suporte para NoCurrentDateDefault. -ou- styles inclui valores de DateTimeStyles mutuamente exclusivos.

Comentários

Essa sobrecarga é como o método DateTimeOffset.ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles), exceto que esse método não gera uma exceção se a conversão falhar. Ele analisa a representação de uma data e hora que deve corresponder exatamente ao padrão especificado pelo parâmetro format. Se input não corresponder a esse padrão, com algumas possíveis variações no espaço em branco definidas pelo parâmetro styles, a operação de análise falhará e o método retornará false.

O parâmetro format é um intervalo de caracteres que contém um único especificador de formato padrão ou um ou mais especificadores de formato personalizado que definem o padrão necessário de input. Para obter detalhes sobre códigos de formatação válidos, consulte cadeias de caracteres de formato de data e hora padrão e cadeias de caracteres de formato de data e hora personalizadas. Se format incluir os especificadores de formato personalizado z, zzou zzz para indicar que um deslocamento deve estar presente em input, esse deslocamento deve incluir um sinal negativo ou um sinal positivo. Se o sinal estiver ausente, a operação de análise falhará e o método retornará false.

Se format exigir que input contenham uma data, mas não uma hora, o objeto DateTimeOffset resultante recebe uma hora de meia-noite (0:00:00). Se format exigir que input contenham uma hora, mas não uma data, o objeto DateTimeOffset resultante recebe a data atual no sistema local. Se format não exigir que input contenham um deslocamento, o deslocamento do objeto DateTimeOffset resultante dependerá do valor do parâmetro styles. Se styles incluir AssumeLocal, o deslocamento do fuso horário local será atribuído ao objeto DateTimeOffset. Se styles incluir AssumeUniversal, o deslocamento UTC (Tempo Universal Coordenado) ou +00:00, será atribuído ao objeto DateTimeOffset. Se nenhum dos valores for especificado, o deslocamento do fuso horário local será usado.

Os símbolos e cadeias de caracteres de data e hora específicos usados em input são definidos pelo parâmetro formatProvider. O mesmo vale para o padrão preciso de input se format for uma cadeia de caracteres do especificador de formato padrão. O parâmetro formatProvider pode ser um dos seguintes:

Se formatprovider for null, o objeto CultureInfo que corresponde à cultura atual será usado.

O parâmetro styles define se o espaço em branco é permitido na cadeia de caracteres de entrada, indica como cadeias de caracteres sem um componente de deslocamento explícito são analisadas e dá suporte à conversão UTC como parte da operação de análise. Todos os membros da enumeração DateTimeStyles têm suporte, exceto NoCurrentDateDefault. A tabela a seguir lista o efeito de cada membro com suporte.

membro DateTimeStyles Comportamento
AdjustToUniversal Analisa input e, se necessário, converte-o em UTC. É equivalente à análise de uma representação de data e hora e, em seguida, chamar o método DateTimeOffset.ToUniversalTime do objeto DateTimeOffset retornado.
AssumeLocal Se format não exigir que input contenham um valor de deslocamento, o objeto DateTimeOffset retornado recebe o deslocamento do fuso horário local. Esse é o comportamento padrão.
AssumeUniversal Se format não exigir que input contenham um valor de deslocamento, o objeto DateTimeOffset retornado recebe o deslocamento UTC (+00:00).
AllowInnerWhite Permite que input incluam espaço em branco interno não especificado por formato. O espaço em branco extra pode aparecer entre componentes de data e hora e dentro de componentes individuais, além do deslocamento, e é ignorado ao analisar a cadeia de caracteres.
AllowLeadingWhite Permite que input incluam espaços à esquerda não especificados por format. Elas são ignoradas ao analisar a cadeia de caracteres.
AllowTrailingWhite Permite que input incluam espaços à direita não especificados por format. Elas são ignoradas ao analisar a cadeia de caracteres.
AllowWhiteSpaces Permite que input incluam espaços à esquerda, à direita e internos não especificados por format. Todos os caracteres de espaço em branco extras não especificados em format são ignorados ao analisar a cadeia de caracteres.
None Indica que espaço em branco adicional não é permitido em input. O espaço em branco deve aparecer exatamente como especificado em format. Esse é o comportamento padrão.
RoundtripKind Não tem efeito, pois a estrutura DateTimeOffset não inclui uma propriedade Kind.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

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

Origem:
DateTimeOffset.cs
Origem:
DateTimeOffset.cs
Origem:
DateTimeOffset.cs

Converte a representação de uma data e hora em um intervalo de caracteres em seu DateTimeOffset equivalente usando os formatos especificados, as informações de formato específicas da cultura e o estilo. O formato da representação de data e hora deve corresponder exatamente a um dos formatos especificados.

public static bool TryParseExact (ReadOnlySpan<char> input, string?[]? formats, IFormatProvider? formatProvider, System.Globalization.DateTimeStyles styles, out DateTimeOffset result);
public static bool TryParseExact (ReadOnlySpan<char> input, string[] formats, IFormatProvider formatProvider, System.Globalization.DateTimeStyles styles, out DateTimeOffset result);

Parâmetros

input
ReadOnlySpan<Char>

Um intervalo que contém os caracteres que representam uma data e hora a serem convertidos.

formats
String[]

Uma matriz de cadeias de caracteres de formato padrão ou personalizado que definem os formatos aceitáveis de input.

formatProvider
IFormatProvider

Um objeto que fornece informações de formatação específicas da cultura sobre input.

styles
DateTimeStyles

Uma combinação bit a bit de valores de enumeração que indica o formato permitido de input. Um valor típico a ser especificado é None.

result
DateTimeOffset

Quando o método é retornado, contém o DateTimeOffset equivalente à data e hora de input, se a conversão foi bem-sucedida ou DateTimeOffset.MinValue se a conversão falhou. A conversão falhará se o

Retornos

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

Exceções

styles inclui um valor de DateTimeStyles indefinido. Não há suporte para NoCurrentDateDefault. -ou- styles inclui valores de DateTimeStyles mutuamente exclusivos.

Comentários

Esse método analisa a representação de cadeia de caracteres de uma data que corresponde a qualquer um dos padrões atribuídos à matriz formats. Se input não corresponder a nenhum desses padrões com quaisquer variações definidas pelo parâmetro styles, a operação de análise falhará e o método retornará false. Além de comparar input com várias cadeias de caracteres que contêm especificadores de formato, essa sobrecarga se comporta de forma idêntica ao método DateTimeOffset.ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles).

O parâmetro formats é uma matriz de cadeia de caracteres cujos elementos contêm um único especificador de formato padrão ou um ou mais especificadores de formato personalizado que definem o padrão possível de input. Para obter detalhes sobre códigos de formatação válidos, consulte cadeias de caracteres de formato de data e hora padrão e cadeias de caracteres de formato de data e hora personalizadas. Se o elemento correspondente em formats incluir os especificadores de z, zzou zzz formato personalizado para indicar que um deslocamento deve estar presente em input, esse deslocamento deve incluir um sinal negativo ou um sinal positivo. Se o sinal estiver ausente, a operação de análise falhará e o método retornará false.

Importante

Usar o parâmetro formats dessa sobrecarga para especificar vários formatos pode ajudar a reduzir a frustração que muitos usuários experimentam ao inserir datas e horas. Em particular, a capacidade de definir vários padrões de entrada permite que um aplicativo lide com representações de data e hora que podem incluir ou não zeros à esquerda em meses, dias, horas, minutos e segundos. O exemplo fornece uma ilustração disso.

Se o elemento correspondente no formats exigir que input contenham uma data, mas não uma hora, o objeto DateTimeOffset resultante recebe uma hora de meia-noite (0:00:00). Se o elemento correspondente no formats exigir que a entrada contenha uma hora, mas não uma data, o objeto DateTimeOffset resultante recebe a data atual no sistema local. Se o elemento correspondente em formats não exigir que input contenham um deslocamento, o deslocamento do objeto DateTimeOffset resultante depende do valor do parâmetro styles. Se styles incluir DateTimeStyles.AssumeLocal, o deslocamento do fuso horário local será atribuído ao objeto DateTimeOffset. Se styles incluir DateTimeStyles.AssumeUniversal, o deslocamento UTC (Tempo Universal Coordenado) ou +00:00, será atribuído ao objeto DateTimeOffset. Se nenhum dos valores for especificado, o deslocamento do fuso horário local será usado.

Os símbolos de data e hora específicos usados em input são definidos pelo parâmetro formatProvider. O mesmo vale para o padrão preciso de input se o elemento correspondente de formats for uma cadeia de caracteres do especificador de formato padrão. O parâmetro formatProvider pode ser um dos seguintes:

Se formatprovider for null, o objeto CultureInfo que corresponde à cultura atual será usado.

O parâmetro styles define se o espaço em branco é permitido na cadeia de caracteres de entrada, indica como cadeias de caracteres sem um componente de deslocamento explícito são analisadas e dá suporte à conversão UTC como parte da operação de análise. Todos os membros da enumeração DateTimeStyles têm suporte, exceto NoCurrentDateDefault. A tabela a seguir lista o efeito de cada membro com suporte.

membro DateTimeStyles Comportamento
AdjustToUniversal Analisa input e, se necessário, converte-o em UTC. É equivalente a analisar uma cadeia de caracteres e chamar o método DateTimeOffset.ToUniversalTime do objeto DateTimeOffset retornado.
AssumeLocal Se o elemento correspondente em formats não exigir que input contenham um valor de deslocamento, o objeto DateTimeOffset retornado recebe o deslocamento do fuso horário local. Esse é o valor padrão.
AssumeUniversal Se o elemento correspondente no formats não exigir que input contenham um valor de deslocamento, o objeto DateTimeOffset retornado recebe o deslocamento UTC (+00:00).
AllowInnerWhite Permite que input incluam espaço em branco interno não especificado pelos elementos em formats. O espaço em branco extra pode aparecer entre componentes de data e hora e dentro de componentes individuais (exceto para o deslocamento) e é ignorado ao analisar a cadeia de caracteres.
AllowLeadingWhite Permite que input incluam espaços à esquerda não especificados pelos elementos em formats. Elas são ignoradas ao analisar a cadeia de caracteres.
AllowTrailingWhite Permite que input incluam espaços à direita não especificados pelos elementos em formats. Elas são ignoradas ao analisar a cadeia de caracteres.
AllowWhiteSpaces Permite que input incluam espaços à esquerda, à direita e internos não especificados pelos elementos em formats. Todos os caracteres de espaço em branco extras não especificados no elemento correspondente em formats são ignorados ao analisar a cadeia de caracteres.
None Indica que espaço em branco adicional não é permitido em input. O espaço em branco deve aparecer exatamente como especificado em um elemento específico em formats para que uma correspondência bem-sucedida ocorra. Esse é o comportamento padrão.
RoundtripKind Não tem efeito porque a estrutura de DateTimeOffset não inclui uma propriedade Kind.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset)

Origem:
DateTimeOffset.cs
Origem:
DateTimeOffset.cs
Origem:
DateTimeOffset.cs

Converte a representação de cadeia de caracteres especificada de uma data e hora em seu DateTimeOffset equivalente usando o formato especificado, as informações de formato específicas da cultura e o estilo. O formato da representação de cadeia de caracteres deve corresponder exatamente ao formato especificado.

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

Parâmetros

input
String

Uma cadeia de caracteres que contém uma data e hora a serem convertidas.

format
String

Um especificador de formato que define o formato necessário de input.

formatProvider
IFormatProvider

Um objeto que fornece informações de formatação específicas da cultura sobre input.

styles
DateTimeStyles

Uma combinação bit a bit de valores de enumeração que indica o formato permitido de entrada. Um valor típico a ser especificado é None.

result
DateTimeOffset

Quando o método é retornado, contém o DateTimeOffset equivalente à data e hora de input, se a conversão foi bem-sucedida ou DateTimeOffset.MinValue, se a conversão falhou. A conversão falhará se o parâmetro input for nullou não contiver uma representação de cadeia de caracteres válida de uma data e hora no formato esperado definido por format e provider. Esse parâmetro é passado sem inicialização.

Retornos

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

Exceções

styles inclui um valor de DateTimeStyles indefinido.

-ou-

não há suporte para NoCurrentDateDefault.

-ou-

styles inclui valores de DateTimeStyles mutuamente exclusivos.

Exemplos

O exemplo a seguir usa o método TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset) com especificadores de formato padrão e personalizado, a cultura invariável e vários valores DateTimeStyles para analisar várias cadeias de caracteres de data e hora.

string dateString, format;
DateTimeOffset result;
IFormatProvider provider = CultureInfo.InvariantCulture;

// Parse date-only value with invariant culture and assume time is UTC.
dateString = "06/15/2008";
format = "d";
if (DateTimeOffset.TryParseExact(dateString, format, provider,
                                 DateTimeStyles.AssumeUniversal,
                                 out result))
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString());
else
   Console.WriteLine("'{0}' is not in the correct format.", dateString);

// Parse date-only value with leading white space.
// Should return False because only trailing white space is
// specified in method call.
dateString = " 06/15/2008";
if (DateTimeOffset.TryParseExact(dateString, format, provider,
                                 DateTimeStyles.AllowTrailingWhite,
                                 out result))
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString());
else
   Console.WriteLine("'{0}' is not in the correct format.", dateString);

// Parse date and time value, and allow all white space.
dateString = " 06/15/   2008  15:15    -05:00";
format = "MM/dd/yyyy H:mm zzz";
if (DateTimeOffset.TryParseExact(dateString, format, provider,
                                 DateTimeStyles.AllowWhiteSpaces,
                                 out result))
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString());
else
   Console.WriteLine("'{0}' is not in the correct format.", dateString);

// Parse date and time and convert to UTC.
dateString = "  06/15/2008 15:15:30 -05:00";
format = "MM/dd/yyyy H:mm:ss zzz";
if (DateTimeOffset.TryParseExact(dateString, format, provider,
                                DateTimeStyles.AllowWhiteSpaces |
                                DateTimeStyles.AdjustToUniversal,
                                out result))
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString());
else
   Console.WriteLine("'{0}' is not in the correct format.", dateString);
// The example displays the following output:
//    '06/15/2008' converts to 6/15/2008 12:00:00 AM +00:00.
//    ' 06/15/2008' is not in the correct format.
//    ' 06/15/   2008  15:15    -05:00' converts to 6/15/2008 3:15:00 PM -05:00.
//    '  06/15/2008 15:15:30 -05:00' converts to 6/15/2008 8:15:30 PM +00:00.

O exemplo a seguir usa uma variedade de valores DateTimeStyles para analisar uma matriz de cadeias de caracteres que devem estar em conformidade com ISO 8601. Como mostra a saída do exemplo, as cadeias de caracteres que estão no formato adequado falharão ao analisar se:

As cadeias de caracteres que não especificam um deslocamento UTC devem ter o deslocamento do fuso horário local (neste caso, -07:00, que reflete o deslocamento do fuso horário de verão do Pacífico), a menos que o sinalizador de DateTimeStyles.AssumeUniversal seja fornecido na chamada do método. Nesse caso, supõe-se que eles sejam Tempo Coordenado Universal.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] dateStrings = { "2018-08-18T12:45:16.0000000Z",
                               "2018/08/18T12:45:16.0000000Z",
                               "2018-18-08T12:45:16.0000000Z",
                               "2018-08-18T12:45:16.0000000",                               
                               " 2018-08-18T12:45:16.0000000Z ",
                               "2018-08-18T12:45:16.0000000+02:00",
                               "2018-08-18T12:45:16.0000000-07:00" }; 
      
      ParseWithISO8601(dateStrings, DateTimeStyles.None);
      Console.WriteLine("\n-----\n");
      ParseWithISO8601(dateStrings, DateTimeStyles.AllowWhiteSpaces);
      Console.WriteLine("\n-----\n");
      ParseWithISO8601(dateStrings, DateTimeStyles.AdjustToUniversal);
      Console.WriteLine("\n-----\n");
      ParseWithISO8601(dateStrings, DateTimeStyles.AssumeLocal);
      Console.WriteLine("\n-----\n");
      ParseWithISO8601(dateStrings, DateTimeStyles.AssumeUniversal);   }

   private static void ParseWithISO8601(string[] dateStrings, DateTimeStyles styles)
   {   
      Console.WriteLine($"Parsing with {styles}:");
      DateTimeOffset date;
      foreach (var dateString in dateStrings)
      {
         if (DateTimeOffset.TryParseExact(dateString, "O", null, styles, out date))
         {
            Console.WriteLine($"   {dateString,-35} --> {date:yyyy-MM-dd HH:mm:ss.FF zzz}");
         }
         else
         {
            Console.WriteLine($"   Unable to convert '{dateString}'");
         }   
      } 
   }
}
// The example displays the following output:
//      Parsing with None:
//         2018-08-18T12:45:16.0000000Z        --> 2018-08-18 12:45:16 +00:00
//         Unable to convert '2018/08/18T12:45:16.0000000Z'
//         Unable to convert '2018-18-08T12:45:16.0000000Z'
//         2018-08-18T12:45:16.0000000         --> 2018-08-18 12:45:16 -07:00
//         Unable to convert ' 2018-08-18T12:45:16.0000000Z '
//         2018-08-18T12:45:16.0000000+02:00   --> 2018-08-18 12:45:16 +02:00
//         2018-08-18T12:45:16.0000000-07:00   --> 2018-08-18 12:45:16 -07:00
//
//      -----
//
//      Parsing with AllowWhiteSpaces:
//         2018-08-18T12:45:16.0000000Z        --> 2018-08-18 12:45:16 +00:00
//         Unable to convert '2018/08/18T12:45:16.0000000Z'
//         Unable to convert '2018-18-08T12:45:16.0000000Z'
//         2018-08-18T12:45:16.0000000         --> 2018-08-18 12:45:16 -07:00
//          2018-08-18T12:45:16.0000000Z       --> 2018-08-18 12:45:16 +00:00
//         2018-08-18T12:45:16.0000000+02:00   --> 2018-08-18 12:45:16 +02:00
//         2018-08-18T12:45:16.0000000-07:00   --> 2018-08-18 12:45:16 -07:00
//
//      -----
//
//      Parsing with AdjustToUniversal:
//         2018-08-18T12:45:16.0000000Z        --> 2018-08-18 12:45:16 +00:00
//         Unable to convert '2018/08/18T12:45:16.0000000Z'
//         Unable to convert '2018-18-08T12:45:16.0000000Z'
//         2018-08-18T12:45:16.0000000         --> 2018-08-18 19:45:16 +00:00
//         Unable to convert ' 2018-08-18T12:45:16.0000000Z '
//         2018-08-18T12:45:16.0000000+02:00   --> 2018-08-18 10:45:16 +00:00
//         2018-08-18T12:45:16.0000000-07:00   --> 2018-08-18 19:45:16 +00:00
//
//      -----
//
//      Parsing with AssumeLocal:
//         2018-08-18T12:45:16.0000000Z        --> 2018-08-18 12:45:16 +00:00
//         Unable to convert '2018/08/18T12:45:16.0000000Z'
//         Unable to convert '2018-18-08T12:45:16.0000000Z'
//         2018-08-18T12:45:16.0000000         --> 2018-08-18 12:45:16 -07:00
//         Unable to convert ' 2018-08-18T12:45:16.0000000Z '
//         2018-08-18T12:45:16.0000000+02:00   --> 2018-08-18 12:45:16 +02:00
//         2018-08-18T12:45:16.0000000-07:00   --> 2018-08-18 12:45:16 -07:00
//
//      -----
//
//      Parsing with AssumeUniversal:
//         2018-08-18T12:45:16.0000000Z        --> 2018-08-18 12:45:16 +00:00
//         Unable to convert '2018/08/18T12:45:16.0000000Z'
//         Unable to convert '2018-18-08T12:45:16.0000000Z'
//         2018-08-18T12:45:16.0000000         --> 2018-08-18 12:45:16 +00:00
//         Unable to convert ' 2018-08-18T12:45:16.0000000Z '
//         2018-08-18T12:45:16.0000000+02:00   --> 2018-08-18 12:45:16 +02:00
//         2018-08-18T12:45:16.0000000-07:00   --> 2018-08-18 12:45:16 -07:00

Comentários

Essa sobrecarga do método TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset) é como o método DateTimeOffset.ParseExact(String, String, IFormatProvider, DateTimeStyles), exceto que esse método não gera uma exceção se a conversão falhar. Ele analisa a representação de cadeia de caracteres de uma data e hora que deve corresponder exatamente ao padrão especificado pelo parâmetro format. Se a cadeia de caracteres input não corresponder a esse padrão, com algumas possíveis variações no espaço em branco definidas pelo parâmetro styles, a operação de análise falhará e o método retornará false.

O parâmetro format é uma cadeia de caracteres que contém um único especificador de formato padrão ou um ou mais especificadores de formato personalizado que definem o padrão necessário de input. Para obter detalhes sobre códigos de formatação válidos, consulte cadeias de caracteres de formato de data e hora padrão e cadeias de caracteres de formato de data e hora personalizadas. Se format incluir os especificadores de formato personalizado z, zzou zzz para indicar que um deslocamento deve estar presente em input, esse deslocamento deve incluir um sinal negativo ou um sinal positivo. Se o sinal estiver ausente, a operação de análise falhará e o método retornará false.

Se format exigir que input contenham uma data, mas não uma hora, o objeto DateTimeOffset resultante recebe uma hora de meia-noite (0:00:00). Se format exigir que input contenham uma hora, mas não uma data, o objeto DateTimeOffset resultante recebe a data atual no sistema local. Se format não exigir que input contenham um deslocamento, o deslocamento do objeto DateTimeOffset resultante dependerá do valor do parâmetro styles. Se styles incluir AssumeLocal, o deslocamento do fuso horário local será atribuído ao objeto DateTimeOffset. Se styles incluir AssumeUniversal, o deslocamento UTC (Tempo Universal Coordenado) ou +00:00, será atribuído ao objeto DateTimeOffset. Se nenhum dos valores for especificado, o deslocamento do fuso horário local será usado.

Os símbolos e cadeias de caracteres de data e hora específicos usados em input são definidos pelo parâmetro formatProvider. O mesmo vale para o padrão preciso de input se format for uma cadeia de caracteres do especificador de formato padrão. O parâmetro formatProvider pode ser um dos seguintes:

Se formatprovider for null, o objeto CultureInfo que corresponde à cultura atual será usado.

O parâmetro styles define se o espaço em branco é permitido na cadeia de caracteres de entrada, indica como cadeias de caracteres sem um componente de deslocamento explícito são analisadas e dá suporte à conversão UTC como parte da operação de análise. Todos os membros da enumeração DateTimeStyles têm suporte, exceto NoCurrentDateDefault. A tabela a seguir lista o efeito de cada membro com suporte.

membro DateTimeStyles Comportamento
AdjustToUniversal Analisa input e, se necessário, converte-o em UTC. É equivalente a analisar uma cadeia de caracteres e chamar o método DateTimeOffset.ToUniversalTime do objeto DateTimeOffset retornado.
AssumeLocal Se format não exigir que input contenham um valor de deslocamento, o objeto DateTimeOffset retornado recebe o deslocamento do fuso horário local. Esse é o comportamento padrão.
AssumeUniversal Se format não exigir que input contenham um valor de deslocamento, o objeto DateTimeOffset retornado recebe o deslocamento UTC (+00:00).
AllowInnerWhite Permite que input incluam espaço em branco interno não especificado por formato. O espaço em branco extra pode aparecer entre componentes de data e hora e dentro de componentes individuais, além do deslocamento, e é ignorado ao analisar a cadeia de caracteres.
AllowLeadingWhite Permite que input incluam espaços à esquerda não especificados por format. Elas são ignoradas ao analisar a cadeia de caracteres.
AllowTrailingWhite Permite que input incluam espaços à direita não especificados por format. Elas são ignoradas ao analisar a cadeia de caracteres.
AllowWhiteSpaces Permite que input incluam espaços à esquerda, à direita e internos não especificados por format. Todos os caracteres de espaço em branco extras não especificados em format são ignorados ao analisar a cadeia de caracteres.
None Indica que espaço em branco adicional não é permitido em input. O espaço em branco deve aparecer exatamente como especificado em format. Esse é o comportamento padrão.
RoundtripKind Não tem efeito, pois a estrutura DateTimeOffset não inclui uma propriedade Kind.

Notas aos Chamadores

No .NET Framework 4, o TryParseExact retornará false se a cadeia de caracteres a ser analisada contiver um componente de hora e um designador AM/PM que não estão de acordo. No .NET Framework 3.5 e versões anteriores, o designador AM/PM é ignorado.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0