DateTimeOffset.Parse Méthode

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

Paramètres

Retours

Objet qui équivaut à la date et à l’heure contenues dans input.

Exceptions

Exemples

L’exemple suivant appelle la Parse(String) méthode pour analyser plusieurs chaînes de date et d’heure. L’exemple inclut la sortie du 22 mars 2007 sur un système dont la culture est 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

Remarques

Parse(String) analyse une chaîne avec trois éléments qui peuvent apparaître dans n’importe quel ordre et sont délimités par des espaces blancs. Ces trois éléments sont comme indiqué dans le tableau suivant.

Bien que chacun de ces éléments soit facultatif, <offset> ne peut pas apparaître seul. Il doit être fourni avec <date> ou <heure>. Si <Date> est manquante, sa valeur par défaut est le jour actuel. Si <Time> est manquant, sa valeur par défaut est 00:00:00 AM. Si <Date> est présent, mais que son composant année ne se compose que de deux chiffres, il est converti en une année dans le calendrier actuel de la culture actuelle en fonction de la valeur de la Calendar.TwoDigitYearMax propriété. Si <offset> est manquant, sa valeur par défaut est le décalage du fuseau horaire local. <Le décalage> peut représenter un décalage négatif ou positif du temps universel coordonné (UTC). Dans les deux cas, <offset> doit inclure un symbole de signe.

La input chaîne est analysée à l’aide des informations de mise en forme d’un DateTimeFormatInfo objet initialisé pour la culture actuelle. Pour analyser une chaîne qui contient une mise en forme désignée qui ne correspond pas nécessairement à la mise en forme de la culture actuelle, utilisez la ParseExact méthode et fournissez un spécificateur de format.

Voir aussi

• 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

Paramètres

Retours

Résultat de l’analyse .s

Implémente

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

Paramètres

Retours

Objet qui équivaut à la date et à l’heure figurant dans input, comme spécifié par formatProvider.

Implémente

Exceptions

Exemples

L’exemple suivant analyse les chaînes de date et d’heure mises en forme pour la culture fr-fr et les affiche à l’aide de la culture en-us par défaut du système 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

Remarques

Cette méthode analyse une chaîne avec trois éléments qui peuvent apparaître dans n’importe quel ordre et sont délimités par des espaces blancs. Ces trois éléments sont présentés dans le tableau suivant.

Bien que chacun de ces éléments soit facultatif, <offset> ne peut pas apparaître seul. Il doit être fourni avec <date> ou <heure>. Si <Date> est manquante, sa valeur par défaut est le jour actuel. Si <Date> est présent, mais que son composant année ne se compose que de deux chiffres, il est converti en année dans le provider calendrier actuel du paramètre en fonction de la valeur de la Calendar.TwoDigitYearMax propriété. Si <Time> est manquant, sa valeur par défaut est 00:00:00 AM. Si <offset> est manquant, sa valeur par défaut est le décalage du fuseau horaire local. <Le décalage> peut représenter un décalage négatif ou positif du temps universel coordonné (UTC). Dans les deux cas, <offset> doit inclure un symbole de signe.

Le format de ces trois éléments est défini par le formatProvider paramètre, qui peut être l’un des éléments suivants :

• Objet CultureInfo qui représente la culture dont la mise en forme est utilisée dans le input paramètre . L’objet DateTimeFormatInfo retourné par la CultureInfo.DateTimeFormat propriété définit la mise en forme utilisée dans input.

• Objet DateTimeFormatInfo qui définit le format des données de date et d’heure.

Si formatprovider est null, l’objet CultureInfo qui correspond à la culture actuelle est utilisé.

Le signe positif ou négatif utilisé dans <Offset> doit être + ou -. Il n’est pas défini par les PositiveSign propriétés ou NegativeSign de l’objet NumberFormatInfo du formatProvider paramètre.

Voir aussi

• 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

Paramètres

Retours

Objet qui équivaut à la date et à l’heure figurant dans input comme spécifié par formatProvider et 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

Paramètres

Retours

Objet qui équivaut à la date et à l’heure figurant dans input comme spécifié par formatProvider et styles.

Exceptions

Exemples

L’exemple suivant illustre l’effet du passage DateTimeStyles.AssumeLocaldes valeurs , DateTimeStyles.AssumeUniversalet DateTimeStyles.AdjustToUniversal au styles paramètre de la Parse(String, IFormatProvider, DateTimeStyles) méthode .

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

Remarques

Cette méthode analyse une chaîne avec trois éléments qui peuvent apparaître dans n’importe quel ordre et sont délimités par des espaces blancs. Ces trois éléments sont présentés dans le tableau suivant.

Bien que chacun de ces éléments soit facultatif, <offset> ne peut pas apparaître seul. Il doit être fourni avec <date> ou <heure>. Si <Date> est manquant, sa valeur par défaut est le jour actuel. Si <Date> est présent mais que son composant année se compose de deux chiffres seulement, il est converti en une année dans le provider calendrier actuel du paramètre en fonction de la valeur de la Calendar.TwoDigitYearMax propriété . Si <Time> est manquant, sa valeur par défaut est 00:00:00 AM. Si <Offset> est manquant, sa valeur par défaut est le décalage du fuseau horaire local, ou TimeSpan.Zero si la DateTimeStyles.AdjustToUniversal valeur ou DateTimeStyles.AssumeUniversal est spécifiée dans le styles paramètre . Si <offset> est présent, il peut représenter un décalage négatif ou positif par rapport au temps universel coordonné (UTC). Dans les deux cas, <Offset> doit inclure un symbole de signe.

Le format de ces trois éléments est défini par le formatProvider paramètre , qui peut être l’un des éléments suivants :

• Objet CultureInfo qui représente la culture dont la mise en forme est utilisée dans le input paramètre . L’objet DateTimeFormatInfo retourné par la CultureInfo.DateTimeFormat propriété définit la mise en forme utilisée dans input.

• Objet DateTimeFormatInfo qui définit le format des données de date et d’heure.

Chaque élément peut également être entouré d’espaces blancs de début ou de fin, et les <éléments Date> et <Heure> peuvent inclure des espaces blancs internes (par exemple, 6: 00:00). Seul le <composant Offset> ne peut pas inclure d’espace blanc interne.

Si formatprovider a la valeur null, l’objet CultureInfo qui correspond à la culture actuelle est utilisé.

Le signe positif ou négatif utilisé dans <Offset> doit être + ou -. Il n’est pas défini par les PositiveSign propriétés ou NegativeSign de l’objet NumberFormatInfo retourné par le formatProvider paramètre .

Le tableau suivant montre les membres de l’énumération System.Globalization.DateTimeStyles pris en charge.

Seule la DateTimeStyles.NoCurrentDateDefault valeur n’est pas prise en charge. Un ArgumentException est levée si cette valeur est incluse dans le styles paramètre .

Voir aussi

• TryParse
• ParseExact