DateTimeOffset.Parse Método

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

public:
 static DateTimeOffset Parse(System::String ^ input);

public static DateTimeOffset Parse (string input);

static member Parse : string -> DateTimeOffset

Public Shared Function Parse (input As String) As DateTimeOffset

Parâmetros

Retornos

Um objeto equivalente à data e hora contida no input.

Exceções

Exemplos

O exemplo a seguir chama o Parse(String) método para analisar várias cadeias de caracteres de data e hora. O exemplo inclui a saída de 22 de março de 2007 em um sistema cuja cultura é en-us.

string dateString;
DateTimeOffset offsetDate;

// String with date only
dateString = "05/01/2008";
offsetDate = DateTimeOffset.Parse(dateString);
Console.WriteLine(offsetDate.ToString());

// String with time only
dateString = "11:36 PM";
offsetDate = DateTimeOffset.Parse(dateString);
Console.WriteLine(offsetDate.ToString());

// String with date and offset
dateString = "05/01/2008 +1:00";
offsetDate = DateTimeOffset.Parse(dateString);
Console.WriteLine(offsetDate.ToString());

// String with day abbreviation
dateString = "Thu May 01, 2008";
offsetDate = DateTimeOffset.Parse(dateString);
Console.WriteLine(offsetDate.ToString());

// String with date only
let dateString = "05/01/2008"
let offsetDate = DateTimeOffset.Parse dateString
printfn $"{offsetDate}"

// String with time only
let dateString = "11:36 PM"
let offsetDate = DateTimeOffset.Parse dateString
printfn $"{offsetDate}"

// String with date and offset
let dateString = "05/01/2008 +1:00"
let offsetDate = DateTimeOffset.Parse dateString
printfn $"{offsetDate}"

// String with day abbreviation
let dateString = "Thu May 01, 2008"
let offsetDate = DateTimeOffset.Parse(dateString)
printfn $"{offsetDate}"

Dim dateString As String
Dim offsetDate As DateTimeOffset

' String with date only
dateString = "05/01/2008"
offsetDate = DateTimeOffset.Parse(dateString)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 12:00:00 AM -07:00  

' String with time only
dateString = "11:36 PM"
offsetDate = DateTimeOffset.Parse(dateString)
Console.WriteLine(offsetDate.ToString())   ' Displays 3/26/2007 11:36:00 PM -07:00

' String with date and offset 
dateString = "05/01/2008 +7:00"
offsetDate = DateTimeOffset.Parse(dateString)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 12:00:00 AM +07:00

' String with day abbreviation
dateString = "Thu May 01, 2008"
offsetDate = DateTimeOffset.Parse(dateString)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 12:00:00 AM -07:00

Comentários

Parse(String) 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 conforme mostrado na tabela a seguir.

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 <Time> estiver ausente, seu valor padrão será 12:00:00 AM. Se <Date> 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 <Offset> estiver ausente, seu valor padrão será o deslocamento do fuso horário local. <O deslocamento> pode representar um deslocamento negativo ou positivo do UTC (Tempo Universal Coordenado). Em ambos os casos, <Offset> deve incluir um símbolo de sinal.

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 à formatação da cultura atual, use o ParseExact método e forneça um especificador de formato.

Confira também

• TryParse
• ParseExact

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

public:
 static DateTimeOffset Parse(ReadOnlySpan<char> s, IFormatProvider ^ provider) = ISpanParsable<DateTimeOffset>::Parse;

public static DateTimeOffset Parse (ReadOnlySpan<char> s, IFormatProvider? provider);

static member Parse : ReadOnlySpan<char> * IFormatProvider -> DateTimeOffset

Public Shared Function Parse (s As ReadOnlySpan(Of Char), provider As IFormatProvider) As DateTimeOffset

Parâmetros

Retornos

O resultado da análise s.

Implementações

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

public:
 static DateTimeOffset Parse(System::String ^ input, IFormatProvider ^ formatProvider);

public:
 static DateTimeOffset Parse(System::String ^ input, IFormatProvider ^ formatProvider) = IParsable<DateTimeOffset>::Parse;

public static DateTimeOffset Parse (string input, IFormatProvider formatProvider);

public static DateTimeOffset Parse (string input, IFormatProvider? formatProvider);

static member Parse : string * IFormatProvider -> DateTimeOffset

Public Shared Function Parse (input As String, formatProvider As IFormatProvider) As DateTimeOffset

Parâmetros

Retornos

Um objeto equivalente à data e hora contida em input, conforme especificado por formatProvider.

Implementações

Exceções

Exemplos

O exemplo a seguir analisa as cadeias de caracteres de data e hora formatadas para a cultura fr-fr e as exibe usando a cultura en-us padrão do sistema local.

DateTimeFormatInfo fmt = new CultureInfo("fr-fr").DateTimeFormat;
string dateString;
DateTimeOffset offsetDate;

dateString = "03-12-07";
offsetDate = DateTimeOffset.Parse(dateString, fmt);
Console.WriteLine("{0} returns {1}",
                  dateString,
                  offsetDate.ToString());

dateString = "15/09/07 08:45:00 +1:00";
offsetDate = DateTimeOffset.Parse(dateString, fmt);
Console.WriteLine("{0} returns {1}",
                  dateString,
                  offsetDate.ToString());

dateString = "mar. 1 janvier 2008 1:00:00 +1:00";
offsetDate = DateTimeOffset.Parse(dateString, fmt);
Console.WriteLine("{0} returns {1}",
                  dateString,
                  offsetDate.ToString());
// The example displays the following output to the console:
//    03-12-07 returns 12/3/2007 12:00:00 AM -08:00
//    15/09/07 08:45:00 +1:00 returns 9/15/2007 8:45:00 AM +01:00
//    mar. 1 janvier 2008 1:00:00 +1:00 returns 1/1/2008 1:00:00 AM +01:00

let fmt = CultureInfo("fr-fr").DateTimeFormat
let dateString = "03-12-07"
let offsetDate = DateTimeOffset.Parse(dateString, fmt)
printfn $"{dateString} returns {offsetDate}"

let dateString = "15/09/07 08:45:00 +1:00"
let offsetDate = DateTimeOffset.Parse(dateString, fmt)
printfn $"{dateString} returns {offsetDate}"

let dateString = "mar. 1 janvier 2008 1:00:00 +1:00"
let offsetDate = DateTimeOffset.Parse(dateString, fmt)
printfn $"{dateString} returns {offsetDate}"

// The example displays the following output to the console:
//    03-12-07 returns 12/3/2007 12:00:00 AM -08:00
//    15/09/07 08:45:00 +1:00 returns 9/15/2007 8:45:00 AM +01:00
//    mar. 1 janvier 2008 1:00:00 +1:00 returns 1/1/2008 1:00:00 AM +01:00

Dim fmt As DateTimeFormatInfo = New CultureInfo("fr-fr").DateTimeFormat
Dim dateString As String
Dim offsetDate As DateTimeOffset

dateString = "03-12-07"
offsetDate = DateTimeOffset.Parse(dateString, fmt)
Console.WriteLine("{0} returns {1}", _
                  dateString, _
                  offsetDate.ToString())

dateString = "15/09/07 08:45:00 +1:00"
offsetDate = DateTimeOffset.Parse(dateString, fmt)
Console.WriteLine("{0} returns {1}", _
                  dateString, _
                  offsetDate.ToString())

dateString = "mar. 1 janvier 2008 1:00:00 +1:00" 
offsetDate = DateTimeOffset.Parse(dateString, fmt)
Console.WriteLine("{0} returns {1}", _
                  dateString, _
                  offsetDate.ToString())
' The example displays the following output to the console:
'    03-12-07 returns 12/3/2007 12:00:00 AM -08:00
'    15/09/07 08:45:00 +1:00 returns 9/15/2007 8:45:00 AM +01:00
'    mar. 1 janvier 2008 1:00:00 +1:00 returns 1/1/2008 1:00:00 AM +01:00

Comentários

Esse 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.

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. <O deslocamento> pode representar um deslocamento negativo ou positivo do UTC (Tempo Universal Coordenado). Em ambos os casos, <Offset> deve incluir um símbolo de sinal.

O formato desses três elementos é definido pelo formatProvider parâmetro , que pode ser um dos seguintes:

• Um CultureInfo objeto que representa a cultura cuja formatação é usada no input parâmetro . O DateTimeFormatInfo objeto retornado pela CultureInfo.DateTimeFormat propriedade define a formatação usada em input.

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

Caso formatprovider 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 do formatProvider parâmetro .

Confira também

• TryParse
• ParseExact

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

public static DateTimeOffset Parse (ReadOnlySpan<char> input, IFormatProvider? formatProvider = default, System.Globalization.DateTimeStyles styles = System.Globalization.DateTimeStyles.None);

public static DateTimeOffset Parse (ReadOnlySpan<char> input, IFormatProvider formatProvider = default, System.Globalization.DateTimeStyles styles = System.Globalization.DateTimeStyles.None);

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

Public Shared Function Parse (input As ReadOnlySpan(Of Char), Optional formatProvider As IFormatProvider = Nothing, Optional styles As DateTimeStyles = System.Globalization.DateTimeStyles.None) As DateTimeOffset

Parâmetros

Retornos

Um objeto equivalente à data e hora contida no input, conforme especificado por formatProvider e styles.

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

Origem:

DateTimeOffset.cs

public:
 static DateTimeOffset Parse(System::String ^ input, IFormatProvider ^ formatProvider, System::Globalization::DateTimeStyles styles);

public static DateTimeOffset Parse (string input, IFormatProvider formatProvider, System.Globalization.DateTimeStyles styles);

public static DateTimeOffset Parse (string input, IFormatProvider? formatProvider, System.Globalization.DateTimeStyles styles);

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

Public Shared Function Parse (input As String, formatProvider As IFormatProvider, styles As DateTimeStyles) As DateTimeOffset

Parâmetros

Retornos

Um objeto equivalente à data e hora contida no input, conforme especificado por formatProvider e styles.

Exceções

Exemplos

O exemplo a seguir ilustra o efeito de passar os DateTimeStyles.AssumeLocalvalores , DateTimeStyles.AssumeUniversale DateTimeStyles.AdjustToUniversal para o styles parâmetro do Parse(String, IFormatProvider, DateTimeStyles) método .

string dateString;
DateTimeOffset offsetDate;

dateString = "05/01/2008 6:00:00";
// Assume time is local
offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AssumeLocal);
Console.WriteLine(offsetDate.ToString());   // Displays 5/1/2008 6:00:00 AM -07:00

// Assume time is UTC
offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AssumeUniversal);
Console.WriteLine(offsetDate.ToString());   // Displays 5/1/2008 6:00:00 AM +00:00

// Parse and convert to UTC
dateString = "05/01/2008 6:00:00AM +5:00";
offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AdjustToUniversal);
Console.WriteLine(offsetDate.ToString());   // Displays 5/1/2008 1:00:00 AM +00:00

let dateString = "05/01/2008 6:00:00"
// Assume time is local
let offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AssumeLocal)
printfn $"{offsetDate}"   // Displays 5/1/2008 6:00:00 AM -07:00

// Assume time is UTC
let offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AssumeUniversal)
printfn $"{offsetDate}"   // Displays 5/1/2008 6:00:00 AM +00:00

// Parse and convert to UTC
let dateString = "05/01/2008 6:00:00AM +5:00"
let offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AdjustToUniversal)
printfn $"{offsetDate}"   // Displays 5/1/2008 1:00:00 AM +00:00

Dim dateString As String
Dim offsetDate As DateTimeOffset

dateString = "05/01/2008 6:00:00"
' Assume time is local 
offsetDate = DateTimeOffset.Parse(dateString, Nothing, DateTimeStyles.AssumeLocal)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 6:00:00 AM -07:00

' Assume time is UTC
offsetDate = DateTimeOffset.Parse(dateString, Nothing, DateTimeStyles.AssumeUniversal)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 6:00:00 AM +00:00

' Parse and convert to UTC 
dateString = "05/01/2008 6:00:00AM +5:00"
offsetDate = DateTimeOffset.Parse(dateString, Nothing, DateTimeStyles.AdjustToUniversal)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 1:00:00 AM +00:00

Comentários

Esse 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.

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 TimeSpan.Zero se o DateTimeStyles.AdjustToUniversal valor ou DateTimeStyles.AssumeUniversal for especificado no styles parâmetro . 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.

O formato desses três elementos é definido pelo formatProvider parâmetro , que pode ser um dos seguintes:

• Um CultureInfo objeto que representa a cultura cuja formatação é usada no input parâmetro . O DateTimeFormatInfo objeto retornado pela CultureInfo.DateTimeFormat propriedade define a formatação usada em input.

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

Cada elemento também pode ser delimitado por espaço em branco à esquerda ou à direita, e os <elementos Date> e <Time> 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 formatprovider 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 pelo formatProvider parâmetro .

A tabela a seguir mostra os membros da System.Globalization.DateTimeStyles enumeração com suporte.

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

• TryParse
• ParseExact