DateTimeOffset.TryParse Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Converte uma representação de cadeia de caracteres especificada de uma data e hora ao seu equivalente DateTimeOffset.
Sobrecargas
TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset) |
Tenta converter a representação de cadeia de caracteres especificada de uma data e hora em seu DateTimeOffset equivalente e retorna um valor que indica se a conversão foi bem-sucedida. |
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset) |
Tenta converter a representação de intervalo especificada de uma data e hora em seu DateTimeOffset equivalente e retorna um valor que indica se a conversão foi bem-sucedida. |
TryParse(String, IFormatProvider, DateTimeOffset) |
Tenta analisar uma cadeia de caracteres em um valor. |
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeOffset) |
Tenta analisar um intervalo de caracteres em um valor. |
TryParse(ReadOnlySpan<Char>, DateTimeOffset) |
Tenta converter a representação de intervalo especificada de uma data e hora em seu DateTimeOffset equivalente e retorna um valor que indica se a conversão foi bem-sucedida. |
TryParse(String, DateTimeOffset) |
Tenta converter a representação de cadeia de caracteres especificada de uma data e hora em seu DateTimeOffset equivalente e retorna um valor que indica se a conversão foi bem-sucedida. |
TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset)
- Origem:
- DateTimeOffset.cs
- Origem:
- DateTimeOffset.cs
- Origem:
- DateTimeOffset.cs
Tenta converter a representação de cadeia de caracteres especificada de uma data e hora em seu DateTimeOffset equivalente e retorna um valor que indica se a conversão foi bem-sucedida.
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
- input
- String
Uma cadeia de caracteres que contém uma data e hora a ser convertida.
- formatProvider
- IFormatProvider
Um objeto que fornece informações de formatação específicas à cultura sobre input
.
- styles
- DateTimeStyles
Um combinação bit a bit de valores de enumeração que indica o formato permitido de input
.
- result
- DateTimeOffset
Quando o método retorna, contém o DateTimeOffset valor 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 null
ou não contiver uma representação de cadeia de caracteres válida de uma data e hora. Este parâmetro é passado não inicializado.
Retornos
true
caso o parâmetro input
seja convertido com êxito; do contrário, false
.
Exceções
styles
inclui um valor DateTimeStyles indefinido.
- ou -
NoCurrentDateDefault não é suportado.
- ou -
styles
inclui valores DateTimeStyles mutuamente exclusivos.
Exemplos
O exemplo a seguir chama o TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset) método com uma variedade de DateTimeStyles valores para analisar algumas cadeias de caracteres 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.
Comentários
Essa sobrecarga do TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset) método é como o DateTimeOffset.Parse(String, IFormatProvider, DateTimeStyles) método , exceto que ele não gera uma exceção se a conversão falhar. O método analisa uma cadeia de caracteres com três elementos que podem aparecer em qualquer ordem e são delimitados por espaço em branco. Esses três elementos são mostrados na tabela a seguir.
Elemento | Exemplo |
---|---|
<Data> | "2/10/2007" |
<Hora> | "1:02:03 PM" |
<Deslocamento> | "-7:30" |
Embora cada um desses elementos seja opcional, <Offset> não pode aparecer sozinho. Ele deve ser fornecido junto com <Data> ou <Hora>. Se <Date> estiver ausente, seu valor padrão será o dia atual. Se <Date> estiver presente, mas seu componente de ano consistir em apenas dois dígitos, ele será convertido em um ano no provider
calendário atual do parâmetro com base no valor da Calendar.TwoDigitYearMax propriedade . Se <Time> estiver ausente, seu valor padrão será 12:00:00 AM. Se <Offset> estiver ausente, seu valor padrão será o deslocamento do fuso horário local ou Zero se o DateTimeStyles.AdjustToUniversal valor ou DateTimeStyles.AssumeUniversal for especificado em styles
. Se <Offset> estiver presente, ele poderá representar um deslocamento negativo ou positivo do UTC (Tempo Universal Coordenado). Em ambos os casos, <Offset> deve incluir um símbolo de sinal ou o método retorna false
.
A input
cadeia de caracteres é analisada usando as informações de formatação específicas da cultura em um DateTimeFormatInfo objeto fornecido pelo formatProvider
parâmetro . O parâmetro formatProvider
pode ser qualquer um dos seguintes:
Um CultureInfo objeto que representa a cultura cuja formatação é usada em
input
. O DateTimeFormatInfo objeto retornado pela CultureInfo.DateTimeFormat propriedade define o formato usado eminput
.Um objeto DateTimeFormatInfo que define o formato dos dados de data e hora.
Além disso, cada elemento pode ser delimitado por espaço em branco à esquerda ou à direita, e os <componentes Data> e <Hora> podem incluir espaço em branco interno (como 6: 00:00). Somente o <componente Deslocamento> não pode incluir espaço em branco interno.
Caso provider
seja null
, o objeto CultureInfo que corresponde à cultura atual é usado.
O sinal positivo ou negativo usado no <Deslocamento> deve ser + ou -. Ele não é definido pelas PositiveSign propriedades ou NegativeSign do NumberFormatInfo objeto retornado pela formatprovider
propriedade do NumberFormat parâmetro.
Há suporte para os seguintes membros da DateTimeStyles enumeração:
Membro DateTimeStyles | Comentários |
---|---|
AdjustToUniversal | Analisa a cadeia de caracteres representada por input e, se necessário, converte-a em UTC. É equivalente a analisar uma cadeia de caracteres e, em seguida, chamar o método do ToUniversalTime() objeto retornado. |
AllowInnerWhite | Embora válido, esse valor é ignorado. O espaço em branco interno é permitido nos <componentes Data> e <Hora> . |
AllowLeadingWhite | Embora válido, esse valor é ignorado. O espaço em branco à esquerda é permitido na frente de cada componente na cadeia de caracteres analisada. |
AllowTrailingWhite | Embora válido, esse valor é ignorado. O espaço em branco à direita é permitido na frente de cada componente na cadeia de caracteres analisada. |
AllowWhiteSpaces | Esse é o comportamento padrão. Ele não pode ser substituído 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 Offset> , o deslocamento do fuso horário local deverá ser fornecido. Esse é 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 Offset> , o deslocamento UTC (00:00) deverá ser fornecido. |
None | Embora seja válido, esse valor é ignorado e não tem efeito. |
RoundtripKind | Como a DateTimeOffset estrutura não inclui uma Kind propriedade , esse valor não tem efeito. |
Somente o DateTimeStyles.NoCurrentDateDefault valor não tem suporte. Um ArgumentException será gerado se esse valor for incluído no styles
parâmetro .
Confira também
Aplica-se a
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset)
- Origem:
- DateTimeOffset.cs
- Origem:
- DateTimeOffset.cs
- Origem:
- DateTimeOffset.cs
Tenta converter a representação de intervalo especificada de uma data e hora em seu DateTimeOffset equivalente e retorna um valor que indica se a conversão foi bem-sucedida.
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
- input
- ReadOnlySpan<Char>
Um intervalo que contém os caracteres que representam a data e a hora a serem convertidas.
- formatProvider
- IFormatProvider
Um objeto que fornece informações de formatação específicas à cultura sobre input
.
- styles
- DateTimeStyles
Um combinação bit a bit de valores de enumeração que indica o formato permitido de input
.
- result
- DateTimeOffset
Quando o método retorna, contém o DateTimeOffset valor 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 null
ou não contiver uma representação de cadeia de caracteres válida de uma data e hora. Este parâmetro é passado não inicializado.
Retornos
true
caso o parâmetro input
seja convertido com êxito; do contrário, false
.
Aplica-se a
TryParse(String, IFormatProvider, DateTimeOffset)
- Origem:
- DateTimeOffset.cs
- Origem:
- DateTimeOffset.cs
- Origem:
- DateTimeOffset.cs
Tenta analisar uma cadeia de caracteres em um valor.
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
- s
- String
A cadeia de caracteres a ser analisada.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas à cultura sobre s
.
- result
- DateTimeOffset
Quando este método retorna, contém o resultado da análise s
com êxito ou um valor indefinido em caso de falha.
Retornos
true
se s
foi analisado com êxito; caso contrário, false
.
Aplica-se a
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeOffset)
- Origem:
- DateTimeOffset.cs
- Origem:
- DateTimeOffset.cs
- Origem:
- DateTimeOffset.cs
Tenta analisar um intervalo de caracteres em um valor.
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
- s
- ReadOnlySpan<Char>
O intervalo de caracteres a serem analisados.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas à cultura sobre s
.
- result
- DateTimeOffset
Quando esse método retorna, contém o resultado da análise s
bem-sucedida de ou um valor indefinido em caso de falha.
Retornos
true
se s
foi analisado com êxito; caso contrário, false
.
Aplica-se a
TryParse(ReadOnlySpan<Char>, DateTimeOffset)
- Origem:
- DateTimeOffset.cs
- Origem:
- DateTimeOffset.cs
- Origem:
- DateTimeOffset.cs
Tenta converter a representação de intervalo especificada de uma data e hora em seu DateTimeOffset equivalente e retorna um valor que indica se a conversão foi bem-sucedida.
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
- input
- ReadOnlySpan<Char>
Um intervalo que contém os caracteres que representam a data e a hora a serem convertidas.
- result
- DateTimeOffset
Quando o método retorna, 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 null
ou não contiver uma representação de cadeia de caracteres válida de uma data e hora. Este parâmetro é passado não inicializado.
Retornos
true
caso o parâmetro input
seja convertido com êxito; do contrário, false
.
Aplica-se a
TryParse(String, DateTimeOffset)
- Origem:
- DateTimeOffset.cs
- Origem:
- DateTimeOffset.cs
- Origem:
- DateTimeOffset.cs
Tenta converter a representação de cadeia de caracteres especificada de uma data e hora em seu DateTimeOffset equivalente e retorna um valor que indica se a conversão foi bem-sucedida.
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
- input
- String
Uma cadeia de caracteres que contém uma data e hora a ser convertida.
- result
- DateTimeOffset
Quando o método retorna, 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 null
ou não contiver uma representação de cadeia de caracteres válida de uma data e hora. Este parâmetro é passado não inicializado.
Retornos
true
caso o parâmetro input
seja convertido com êxito; do contrário, false
.
Exemplos
O exemplo a seguir chama o TryParse(String, DateTimeOffset) método para analisar várias cadeias de caracteres 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.
Comentários
Essa sobrecarga do TryParse(String, DateTimeOffset) método é como o DateTimeOffset.Parse(String) método , exceto que ele não gera uma exceção se a conversão falhar. Ele analisa uma cadeia de caracteres com três elementos que podem aparecer em qualquer ordem e são delimitados por espaço em branco. Esses três elementos são mostrados na tabela a seguir.
Elemento | Exemplo |
---|---|
<Data> | "2/10/2007" |
<Hora> | "1:02:03 PM" |
<Deslocamento> | "-7:30" |
Embora cada um desses elementos seja opcional, <Offset> não pode aparecer sozinho. Ele deve ser fornecido junto com <Data> ou <Hora>. Se <Date> estiver ausente, seu valor padrão será o dia atual. Se <Data> estiver presente, mas seu componente de ano consistir em apenas dois dígitos, ele será convertido em um ano no calendário atual da cultura atual com base no valor da Calendar.TwoDigitYearMax propriedade. Se <Time> estiver ausente, seu valor padrão será 12:00:00 AM. Se <Offset> estiver ausente, seu valor padrão será o deslocamento do fuso horário local. Se <Offset> estiver presente, ele poderá representar um deslocamento negativo ou positivo do UTC (Tempo Universal Coordenado). Em ambos os casos, <Offset> deve incluir um símbolo de sinal ou o método retorna false
.
A input
cadeia de caracteres é analisada usando as informações de formatação em um DateTimeFormatInfo objeto inicializado para a cultura atual. Para analisar uma cadeia de caracteres que contém a formatação designada que não corresponde necessariamente à da cultura atual, use o TryParseExact método e forneça um especificador de formato.
Confira também
- Parse
- Amostra: Utilitário de Formatação do WinForms do .NET Core (C#)
- Amostra: Utilitário de Formatação do WinForms do .NET Core (Visual Basic)