DateTimeOffset.Parse Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en son équivalent DateTimeOffset.

Surcharges

Parse(String)	Convertit la représentation sous forme de chaîne spécifiée d’une date, d’une heure et d’un décalage en DateTimeOffset équivalent.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Analyse une étendue de caractères dans une valeur.
Parse(String, IFormatProvider)	Convertit la représentation sous forme de chaîne spécifiée d’une date et d’une heure en DateTimeOffset équivalent à l’aide des informations de format propres à la culture spécifiées.
Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	Convertit la représentation sous forme de plage spécifiée d’une date et d’une heure en DateTimeOffset équivalent à l’aide des informations de format propres à la culture et du style de mise en forme spécifiés.
Parse(String, IFormatProvider, DateTimeStyles)	Convertit la représentation sous forme de chaîne spécifiée d’une date et d’une heure en DateTimeOffset équivalent à l’aide des informations de format propres à la culture et du style de mise en forme spécifiés.

Remarques

Important

Les ères des calendriers japonais sont basées sur le règne de l’empereur et sont donc amenées à changer. Par exemple, le 1 mai 2019 a marqué le début de l’ère Reiwa dans JapaneseCalendar et JapaneseLunisolarCalendar. Ce changement d’ère affecte toutes les applications qui utilisent ces calendriers. Pour plus d’informations et pour déterminer si vos applications sont affectées, consultez Gestion d’une nouvelle ère dans le calendrier japonais dans .NET. Pour plus d’informations sur le test de vos applications sur des systèmes Windows afin de garantir leur préparation au changement d’ère, consultez Préparer votre application pour le changement d’ère japonaise. Pour connaître les fonctionnalités de .NET qui prennent en charge les calendriers avec plusieurs ères et pour connaître les meilleures pratiques lors de l’utilisation de calendriers qui prennent en charge plusieurs ères, consultez Utilisation d’ères.

Parse(String)

Source:

DateTimeOffset.cs

Convertit la représentation sous forme de chaîne spécifiée d’une date, d’une heure et d’un décalage en DateTimeOffset équivalent.

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

input

String

Chaîne contenant une date et une heure à convertir.

Retours

DateTimeOffset

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

Exceptions

ArgumentException

Le décalage est supérieur à 14 heures ou inférieur à -14 heures.

ArgumentNullException

input a la valeur null.

FormatException

input ne contient pas de représentation sous forme de chaîne valide d’une date et d’une heure.

- ou -

input contient la représentation sous forme de chaîne d’une valeur de décalage sans date ou heure.

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.

Élément	Exemple
<Date>	"2/10/2007"
<Time>	« 13:02:03 »
<Offset>	"-7:30"

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

Parse(ReadOnlySpan<Char>, IFormatProvider)

Source:

DateTimeOffset.cs

Analyse une étendue de caractères dans une valeur.

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

s

ReadOnlySpan<Char>

Étendue des caractères à analyser.

provider

IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture concernant s.

Retours

DateTimeOffset

Résultat de l’analyse .s

Implémente

Parse(ReadOnlySpan<Char>, IFormatProvider)

Parse(String, IFormatProvider)

Source:

DateTimeOffset.cs

Convertit la représentation sous forme de chaîne spécifiée d’une date et d’une heure en DateTimeOffset équivalent à l’aide des informations de format propres à la culture spécifiées.

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

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

input

String

Chaîne contenant une date et une heure à convertir.

formatProvider

IFormatProvider

Objet qui fournit des informations de format propres à la culture concernant input.

Retours

DateTimeOffset

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

Implémente

Parse(String, IFormatProvider)

Exceptions

ArgumentException

Le décalage est supérieur à 14 heures ou inférieur à -14 heures.

ArgumentNullException

input a la valeur null.

FormatException

input ne contient pas de représentation sous forme de chaîne valide d’une date et d’une heure.

- ou -

input contient la représentation sous forme de chaîne d’une valeur de décalage sans date ou heure.

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.

Élément	Exemple
<Date>	"2/10/2007"
<Time>	« 13:02:03 »
<Offset>	"-7:30"

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

Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

Source:

DateTimeOffset.cs

Convertit la représentation sous forme de plage spécifiée d’une date et d’une heure en DateTimeOffset équivalent à l’aide des informations de format propres à la culture et du style de mise en forme spécifiés.

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

input

ReadOnlySpan<Char>

Étendue contenant les caractères qui représentent une date et une heure à convertir.

formatProvider

IFormatProvider

Objet qui fournit des informations de format propres à la culture concernant input.

styles

DateTimeStyles

Combinaison d'opérations de bits de valeurs d'énumération qui indique le format autorisé du paramètre input. Une valeur typique à spécifier est None.

Retours

DateTimeOffset

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

Parse(String, IFormatProvider, DateTimeStyles)

Source:

DateTimeOffset.cs

Convertit la représentation sous forme de chaîne spécifiée d’une date et d’une heure en DateTimeOffset équivalent à l’aide des informations de format propres à la culture et du style de mise en forme spécifiés.

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);

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

input

String

Chaîne contenant une date et une heure à convertir.

formatProvider

IFormatProvider

Objet qui fournit des informations de format propres à la culture concernant input.

styles

DateTimeStyles

Combinaison d'opérations de bits de valeurs d'énumération qui indique le format autorisé du paramètre input. Une valeur typique à spécifier est None.

Retours

DateTimeOffset

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

Exceptions

ArgumentException

Le décalage est supérieur à 14 heures ou inférieur à -14 heures.

- ou -

styles n’est pas une valeur de DateTimeStyles valide.

- ou -

styles contient une valeur DateTimeStyles non prise en charge.

- ou -

styles contient des valeurs DateTimeStyles qui ne peuvent pas être utilisées ensemble.

ArgumentNullException

input a la valeur null.

FormatException

input ne contient pas de représentation sous forme de chaîne valide d’une date et d’une heure.

- ou -

input contient la représentation sous forme de chaîne d’une valeur de décalage sans date ou heure.

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.

Élément	Exemple
<Date>	"2/10/2007"
<Time>	« 13:02:03 »
<Offset>	"-7:30"

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.

Membre DateTimeStyles	Description
AdjustToUniversal	Analyse la chaîne représentée par input et, si nécessaire, la convertit en UTC. Cela revient à analyser une chaîne, puis à appeler la DateTimeOffset.ToUniversalTime méthode de l’objet retourné DateTimeOffset .
AllowInnerWhite	Bien que valide, cette valeur est ignorée. Les espaces blancs internes sont autorisés dans les <éléments Date> et <Heure> .
AllowLeadingWhite	Bien que valide, cette valeur est ignorée. L’espace blanc de début est autorisé devant chaque composant de la chaîne analysée.
AllowTrailingWhite	Bien que valide, cette valeur est ignorée. Les espaces blancs de fin sont autorisés devant chaque composant de la chaîne analysée.
AllowWhiteSpaces	Il s'agit du comportement par défaut. Il ne peut pas être substitué en fournissant une valeur d’énumération plus restrictive DateTimeStyles , telle que DateTimeStyles.None.
AssumeLocal	Indique que, si le input paramètre n’a pas d’élément <Offset> , le décalage du fuseau horaire local doit être fourni. Il s’agit du comportement par défaut de la Parse (méthode).
AssumeUniversal	Indique que, si le input paramètre n’a pas d’élément <Offset> , le décalage UTC (00:00) doit être fourni.
None	Bien que valide, cette valeur est ignorée et n’a aucun effet.
RoundtripKind	Étant donné que la DateTimeOffset structure n’inclut pas de Kind propriété, cette valeur n’a aucun effet.

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