DateTimeOffset.Parse Método

Source:

DateTimeOffset.cs

Source:

DateTimeOffset.cs

Source:

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

Devoluciones

Objeto equivalente a la fecha y hora contenidas en input.

Excepciones

Ejemplos

En el ejemplo siguiente se llama al Parse(String) método para analizar varias cadenas de fecha y hora. En el ejemplo se incluye la salida del 22 de marzo de 2007 en un sistema cuya referencia cultural es 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

Comentarios

Parse(String) analiza una cadena con tres elementos que pueden aparecer en cualquier orden y están delimitados por espacios en blanco. Estos tres elementos se muestran en la tabla siguiente.

Aunque cada uno de estos elementos es opcional, <Offset> no puede aparecer por sí mismo. Debe proporcionarse junto con <fecha> u <hora>. Si <falta Date> , su valor predeterminado es el día actual. Si <falta time> , su valor predeterminado es 12:00:00 AM. Si <Date> está presente, pero su componente de año consta de solo dos dígitos, se convierte a un año en el calendario actual de la referencia cultural actual en función del valor de la Calendar.TwoDigitYearMax propiedad . Si <falta Offset> , su valor predeterminado es el desplazamiento de la zona horaria local. <El desplazamiento> puede representar un desplazamiento negativo o positivo de la hora universal coordinada (UTC). En cualquier caso, <Offset> debe incluir un símbolo de signo.

La input cadena se analiza mediante la información de formato de un DateTimeFormatInfo objeto que se inicializa para la referencia cultural actual. Para analizar una cadena que contiene el formato designado que no se corresponde necesariamente con el formato de la referencia cultural actual, use el ParseExact método y proporcione un especificador de formato.

Consulte también

• TryParse
• ParseExact

Source:

DateTimeOffset.cs

Source:

DateTimeOffset.cs

Source:

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

Devoluciones

Resultado del análisis sde .

Implementaciones

Source:

DateTimeOffset.cs

Source:

DateTimeOffset.cs

Source:

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

Devoluciones

Objeto equivalente a la fecha y hora contenidas en input, tal como especifica formatProvider.

Implementaciones

Excepciones

Ejemplos

En el ejemplo siguiente se analizan las cadenas de fecha y hora con formato para la referencia cultural fr-fr y se muestran mediante la referencia cultural predeterminada del 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

Comentarios

Este método analiza una cadena con tres elementos que pueden aparecer en cualquier orden y están delimitados por espacios en blanco. Estos tres elementos se muestran en la tabla siguiente.

Aunque cada uno de estos elementos es opcional, <Offset> no puede aparecer por sí mismo. Debe proporcionarse junto con <fecha> u <hora>. Si <falta Date> , su valor predeterminado es el día actual. Si <Date> está presente, pero su componente de año consta de solo dos dígitos, se convierte a un año en el provider calendario actual del parámetro en función del valor de la Calendar.TwoDigitYearMax propiedad . Si <falta time> , su valor predeterminado es 12:00:00 AM. Si <falta Offset> , su valor predeterminado es el desplazamiento de la zona horaria local. <El desplazamiento> puede representar un desplazamiento negativo o positivo de la hora universal coordinada (UTC). En cualquier caso, <Offset> debe incluir un símbolo de signo.

El formato de estos tres elementos se define mediante el formatProvider parámetro , que puede ser cualquiera de los siguientes:

• Objeto CultureInfo que representa la referencia cultural cuyo formato se usa en el input parámetro . El DateTimeFormatInfo objeto devuelto por la CultureInfo.DateTimeFormat propiedad define el formato usado en input.

• Objeto DateTimeFormatInfo que define el formato de los datos de fecha y hora.

Si formatprovider es null, se usa el CultureInfo objeto que corresponde a la referencia cultural actual.

El signo positivo o negativo usado en <Offset> debe ser + o -. No se define mediante las PositiveSign propiedades o NegativeSign del NumberFormatInfo objeto del formatProvider parámetro .

Consulte también

• TryParse
• ParseExact

Source:

DateTimeOffset.cs

Source:

DateTimeOffset.cs

Source:

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

Devoluciones

Objeto equivalente a la fecha y hora que se indican en input, tal como especifican formatProvider y styles.

Source:

DateTimeOffset.cs

Source:

DateTimeOffset.cs

Source:

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

Devoluciones

Objeto equivalente a la fecha y hora que se indican en input, tal como especifican formatProvider y styles.

Excepciones

Ejemplos

En el ejemplo siguiente se muestra el efecto de pasar los DateTimeStyles.AssumeLocalvalores , DateTimeStyles.AssumeUniversaly DateTimeStyles.AdjustToUniversal al styles parámetro del 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

Comentarios

Este método analiza una cadena con tres elementos que pueden aparecer en cualquier orden y están delimitados por espacios en blanco. Estos tres elementos se muestran en la tabla siguiente.

Aunque cada uno de estos elementos es opcional, <Offset> no puede aparecer por sí mismo. Debe proporcionarse junto con <la fecha> u <hora>. Si <falta Date> , su valor predeterminado es el día actual. Si <Date> está presente, pero su componente de año consta de solo dos dígitos, se convierte en un año en el provider calendario actual del parámetro en función del valor de la Calendar.TwoDigitYearMax propiedad . Si <falta time> , su valor predeterminado es 12:00:00 AM. Si <falta Offset> , su valor predeterminado es el desplazamiento de la zona horaria local o TimeSpan.Zero si se especifica el DateTimeStyles.AdjustToUniversal valor o DateTimeStyles.AssumeUniversal en el styles parámetro . Si <Offset> está presente, puede representar un desplazamiento negativo o positivo de la hora universal coordinada (UTC). En cualquier caso, <Offset> debe incluir un símbolo de signo.

El formato de estos tres elementos se define mediante el formatProvider parámetro , que puede ser cualquiera de los siguientes:

• Objeto CultureInfo que representa la referencia cultural cuyo formato se usa en el input parámetro . El DateTimeFormatInfo objeto devuelto por la CultureInfo.DateTimeFormat propiedad define el formato utilizado en input.

• Objeto DateTimeFormatInfo que define el formato de los datos de fecha y hora.

Cada elemento también se puede incluir entre espacios en blanco iniciales o finales, y los <elementos Date> y <Time> pueden incluir espacios en blanco internos (como 6: 00:00). Solo el <componente Offset> no puede incluir espacios en blanco internos.

Si formatprovider es null, se usa el CultureInfo objeto que corresponde a la referencia cultural actual.

El signo positivo o negativo usado en <Offset> debe ser + o -. No se define mediante las PositiveSign propiedades o NegativeSign del NumberFormatInfo objeto devuelto por el formatProvider parámetro .

En la tabla siguiente se muestran los miembros de la System.Globalization.DateTimeStyles enumeración que se admiten.

Solo no se admite el DateTimeStyles.NoCurrentDateDefault valor. Se produce una ArgumentException excepción si este valor se incluye en el styles parámetro .

Consulte también

• TryParse
• ParseExact