DateTime.ParseExact Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en son équivalent DateTime. Le format de la représentation sous forme de chaîne doit correspondre exactement à un format spécifié, ou une exception est levée.
Surcharges
ParseExact(String, String, IFormatProvider) |
Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en son équivalent DateTime à l'aide des informations de format propres à la culture et au format spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement au format spécifié. |
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) |
Convertit la représentation sous forme d’étendue spécifiée d’une date et d’une heure en son équivalent DateTime à l’aide des informations et du style de format propres à la culture spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement au format spécifié, ou une exception est levée. |
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles) |
Convertit la représentation sous forme d’étendue spécifiée d’une date et d’une heure en son équivalent DateTime à l’aide du tableau de formats ainsi que des informations et du style de format propres à la culture spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement à au moins l'un des formats spécifiés, ou une exception est levée. |
ParseExact(String, String, IFormatProvider, DateTimeStyles) |
Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en DateTime équivalent à l'aide des informations et du style de format propres à la culture spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement au format spécifié, ou une exception est levée. |
ParseExact(String, String[], IFormatProvider, DateTimeStyles) |
Convertit la représentation sous forme de chaîne spécifiée d'une date et heure en son équivalent DateTime à l'aide du tableau de formats, des informations et du style de format propres à la culture spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement à au moins l'un des formats spécifiés, ou une exception est levée. |
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 Windows systèmes afin de garantir leur préparation au changement d’ère, consultez préparer votre application pour la modification de l’ère japonaise. Pour les fonctionnalités de .NET qui prennent en charge les calendriers avec plusieurs ères et pour les meilleures pratiques lorsque vous travaillez avec des calendriers qui prennent en charge plusieurs ères, consultez utilisation des ères.
ParseExact(String, String, IFormatProvider)
Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en son équivalent DateTime à l'aide des informations de format propres à la culture et au format spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement au format spécifié.
public:
static DateTime ParseExact(System::String ^ s, System::String ^ format, IFormatProvider ^ provider);
public static DateTime ParseExact (string s, string format, IFormatProvider provider);
public static DateTime ParseExact (string s, string format, IFormatProvider? provider);
static member ParseExact : string * string * IFormatProvider -> DateTime
Public Shared Function ParseExact (s As String, format As String, provider As IFormatProvider) As DateTime
Paramètres
- s
- String
Chaîne contenant une date et une heure à convertir.
- format
- String
Spécificateur de format définissant le format requis de s
. Pour plus d'informations, consultez la section Remarques.
- provider
- IFormatProvider
Objet qui fournit des informations de format spécifiques à la culture sur s
.
Retours
Objet qui équivaut à la date et à l'heure figurant dans s
, comme spécifié par format
et provider
.
Exceptions
s
ou format
est null
.
s
ou format
est une chaîne vide.
- ou -
s
ne contient pas une date et une heure qui correspondent au modèle spécifié dans format
.
- ou -
Le composant heure et l’indicateur AM/PM dans s
ne correspondent pas.
Exemples
L’exemple suivant illustre la ParseExact méthode.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
string dateString, format;
DateTime result;
CultureInfo provider = CultureInfo.InvariantCulture;
// Parse date-only value with invariant culture.
dateString = "06/15/2008";
format = "d";
try {
result = DateTime.ParseExact(dateString, format, provider);
Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
}
catch (FormatException) {
Console.WriteLine("{0} is not in the correct format.", dateString);
}
// Parse date-only value without leading zero in month using "d" format.
// Should throw a FormatException because standard short date pattern of
// invariant culture requires two-digit month.
dateString = "6/15/2008";
try {
result = DateTime.ParseExact(dateString, format, provider);
Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
}
catch (FormatException) {
Console.WriteLine("{0} is not in the correct format.", dateString);
}
// Parse date and time with custom specifier.
dateString = "Sun 15 Jun 2008 8:30 AM -06:00";
format = "ddd dd MMM yyyy h:mm tt zzz";
try {
result = DateTime.ParseExact(dateString, format, provider);
Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
}
catch (FormatException) {
Console.WriteLine("{0} is not in the correct format.", dateString);
}
// Parse date and time with offset but without offset's minutes.
// Should throw a FormatException because "zzz" specifier requires leading
// zero in hours.
dateString = "Sun 15 Jun 2008 8:30 AM -06";
try {
result = DateTime.ParseExact(dateString, format, provider);
Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
}
catch (FormatException) {
Console.WriteLine("{0} is not in the correct format.", dateString);
}
dateString = "15/06/2008 08:30";
format = "g";
provider = new CultureInfo("fr-FR");
try {
result = DateTime.ParseExact(dateString, format, provider);
Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
}
catch (FormatException) {
Console.WriteLine("{0} is not in the correct format.", dateString);
}
// Parse a date that includes seconds and milliseconds
// by using the French (France) and invariant cultures.
dateString = "18/08/2015 06:30:15.006542";
format = "dd/MM/yyyy HH:mm:ss.ffffff";
try {
result = DateTime.ParseExact(dateString, format, provider);
Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
}
catch (FormatException) {
Console.WriteLine("{0} is not in the correct format.", dateString);
}
}
}
// The example displays the following output:
// 06/15/2008 converts to 6/15/2008 12:00:00 AM.
// 6/15/2008 is not in the correct format.
// Sun 15 Jun 2008 8:30 AM -06:00 converts to 6/15/2008 7:30:00 AM.
// Sun 15 Jun 2008 8:30 AM -06 is not in the correct format.
// 15/06/2008 08:30 converts to 6/15/2008 8:30:00 AM.
// 18/08/2015 06:30:15.006542 converts to 8/18/2015 6:30:15 AM.
Imports System.Globalization
Module Example
Public Sub Main()
Dim dateString, format As String
Dim result As Date
Dim provider As CultureInfo = CultureInfo.InvariantCulture
' Parse date-only value with invariant culture.
dateString = "06/15/2008"
format = "d"
Try
result = Date.ParseExact(dateString, format, provider)
Console.WriteLine("{0} converts to {1}.", dateString, result.ToString())
Catch e As FormatException
Console.WriteLine("{0} is not in the correct format.", dateString)
End Try
' Parse date-only value without leading zero in month using "d" format.
' Should throw a FormatException because standard short date pattern of
' invariant culture requires two-digit month.
dateString = "6/15/2008"
Try
result = Date.ParseExact(dateString, format, provider)
Console.WriteLine("{0} converts to {1}.", dateString, result.ToString())
Catch e As FormatException
Console.WriteLine("{0} is not in the correct format.", dateString)
End Try
' Parse date and time with custom specifier.
dateString = "Sun 15 Jun 2008 8:30 AM -06:00"
format = "ddd dd MMM yyyy h:mm tt zzz"
Try
result = Date.ParseExact(dateString, format, provider)
Console.WriteLine("{0} converts to {1}.", dateString, result.ToString())
Catch e As FormatException
Console.WriteLine("{0} is not in the correct format.", dateString)
End Try
' Parse date and time with offset but without offset's minutes.
' Should throw a FormatException because "zzz" specifier requires leading
' zero in hours.
dateString = "Sun 15 Jun 2008 8:30 AM -06"
Try
result = Date.ParseExact(dateString, format, provider)
Console.WriteLine("{0} converts to {1}.", dateString, result.ToString())
Catch e As FormatException
Console.WriteLine("{0} is not in the correct format.", dateString)
End Try
' Parse a date string using the French (France) culture.
dateString = "15/06/2008 08:30"
format = "g"
provider = New CultureInfo("fr-FR")
Try
result = Date.ParseExact(dateString, format, provider)
Console.WriteLine("{0} converts to {1}.", dateString, result.ToString())
Catch e As FormatException
Console.WriteLine("{0} is not in the correct format.", dateString)
End Try
' Parse a date that includes seconds and milliseconds
' by using the French (France) and invariant cultures.
dateString = "18/08/2015 06:30:15.006542"
format = "dd/MM/yyyy HH:mm:ss.ffffff"
Try
result = Date.ParseExact(dateString, format, provider)
Console.WriteLine("{0} converts to {1}.", dateString, result.ToString())
Catch e As FormatException
Console.WriteLine("{0} is not in the correct format.", dateString)
End Try
End Sub
End Module
' The example displays the following output:
' 06/15/2008 converts to 6/15/2008 12:00:00 AM.
' 6/15/2008 is not in the correct format.
' Sun 15 Jun 2008 8:30 AM -06:00 converts to 6/15/2008 7:30:00 AM.
' Sun 15 Jun 2008 8:30 AM -06 is not in the correct format.
' 15/06/2008 08:30 converts to 6/15/2008 8:30:00 AM.
' 18/08/2015 06:30:15.006542 converts to 8/18/2015 6:30:15 AM.
Remarques
La DateTime.ParseExact(String, String, IFormatProvider) méthode analyse la représentation sous forme de chaîne d’une date, qui doit être au format défini par le format
paramètre. Elle requiert également que les <Date> <Time> éléments et de la représentation sous forme de chaîne d’une date et d’une heure s’affichent dans l’ordre spécifié par format
, et qui n' s
ont pas d’espace blanc autre que celui autorisé par format
. Si format
définit une date sans élément d’heure et que l’opération d’analyse aboutit, la valeur résultante DateTime a une heure de minuit (00:00:00). Si format
définit une heure sans élément de date et que l’opération d’analyse aboutit, la valeur résultante DateTime a une date de DateTime.Now.Date
.
Si s
ne représente pas une heure dans un fuseau horaire particulier et que l’opération d’analyse s’effectue correctement, la Kind propriété de la valeur retournée DateTime est DateTimeKind.Unspecified . Si s
représente l’heure dans un fuseau horaire particulier et format
autorise la présence d’informations de fuseau horaire (par exemple, si format
est égal aux spécificateurs de format standard « o », « r » ou « u », ou s’il contient les spécificateurs de format personnalisés « z », « ZZ » ou « zzz »), la Kind propriété de la valeur retournée DateTime est DateTimeKind.Local .
Le format
paramètre est une chaîne qui contient soit un spécificateur de format standard unique, soit un ou plusieurs spécificateurs de format personnalisés qui définissent le format requis de s
. Pour plus d’informations sur les codes de mise en forme valides, consultez chaînes de format de date et d’heure standard ou chaînes de format de date et d’heure personnalisées.
Notes
Si format
est un modèle de format personnalisé qui n’inclut pas de séparateurs de date ou d’heure (tels que « yyyyMMddHHmm »), utilisez la culture dite indifférente pour le provider
paramètre et la forme la plus étendue de chaque spécificateur de format personnalisé. Par exemple, si vous souhaitez spécifier des heures dans le modèle de format, spécifiez la forme plus large, « HH », au lieu de la forme plus restreinte, « H ».
Les symboles et les chaînes de date et d’heure particuliers (tels que les noms des jours de la semaine dans une langue particulière) utilisés dans s
sont définis par le provider
paramètre, tout comme le format précis de s
si format
est une chaîne de spécificateur de format standard. Le provider
paramètre peut être l’un des éléments suivants :
CultureInfoObjet qui représente la culture utilisée pour interpréter
s
. L' DateTimeFormatInfo objet retourné par sa DateTimeFormat propriété définit les symboles et la mise en forme danss
.DateTimeFormatInfoObjet qui définit le format des données de date et d’heure.
Implémentation personnalisée IFormatProvider dont GetFormat la méthode retourne l' CultureInfo objet ou l' DateTimeFormatInfo objet qui fournit les informations de mise en forme.
Si provider
a null
la valeur, l' CultureInfo objet qui correspond à la culture actuelle est utilisé.
Notes pour les appelants
dans le .NET Framework 4, la ParseExact méthode lève une exception FormatException si la chaîne à analyser contient un composant heure et un indicateur AM/PM qui ne sont pas en accord. dans le .NET Framework 3,5 et les versions antérieures, l’indicateur AM/PM est ignoré.
Voir aussi
- TryParseExact
- CultureInfo
- DateTimeFormatInfo
- Analyse des chaînes de date et d'heure dans .NET Framework
- Chaînes de format de date et d'heure standard
- Chaînes de format de date et d'heure personnalisées
S’applique à
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)
Convertit la représentation sous forme d’étendue spécifiée d’une date et d’une heure en son équivalent DateTime à l’aide des informations et du style de format propres à la culture spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement au format spécifié, ou une exception est levée.
public static DateTime ParseExact (ReadOnlySpan<char> s, ReadOnlySpan<char> format, IFormatProvider? provider, System.Globalization.DateTimeStyles style = System.Globalization.DateTimeStyles.None);
public static DateTime ParseExact (ReadOnlySpan<char> s, ReadOnlySpan<char> format, IFormatProvider provider, System.Globalization.DateTimeStyles style = System.Globalization.DateTimeStyles.None);
static member ParseExact : ReadOnlySpan<char> * ReadOnlySpan<char> * IFormatProvider * System.Globalization.DateTimeStyles -> DateTime
Public Shared Function ParseExact (s As ReadOnlySpan(Of Char), format As ReadOnlySpan(Of Char), provider As IFormatProvider, Optional style As DateTimeStyles = System.Globalization.DateTimeStyles.None) As DateTime
Paramètres
- s
- ReadOnlySpan<Char>
Étendue contenant les caractères qui représentent une date et une heure à convertir.
- format
- ReadOnlySpan<Char>
Étendue contenant les caractères qui représentent un spécificateur de format qui définit le format requis de s
.
- provider
- IFormatProvider
Objet qui fournit des informations de mise en forme propres à la culture sur s
.
- style
- DateTimeStyles
Combinaison d'opérations de bits des valeurs d'énumération qui fournit des informations supplémentaires sur s
, sur des éléments de style qui peuvent être présents dans s
ou sur la conversion de s
en valeur DateTime. Une valeur typique à spécifier est None.
Retours
Objet qui équivaut à la date et à l'heure figurant dans s
, comme spécifié par format
, provider
et style
.
S’applique à
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles)
Convertit la représentation sous forme d’étendue spécifiée d’une date et d’une heure en son équivalent DateTime à l’aide du tableau de formats ainsi que des informations et du style de format propres à la culture spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement à au moins l'un des formats spécifiés, ou une exception est levée.
public static DateTime ParseExact (ReadOnlySpan<char> s, string[] formats, IFormatProvider? provider, System.Globalization.DateTimeStyles style = System.Globalization.DateTimeStyles.None);
public static DateTime ParseExact (ReadOnlySpan<char> s, string[] formats, IFormatProvider provider, System.Globalization.DateTimeStyles style = System.Globalization.DateTimeStyles.None);
static member ParseExact : ReadOnlySpan<char> * string[] * IFormatProvider * System.Globalization.DateTimeStyles -> DateTime
Public Shared Function ParseExact (s As ReadOnlySpan(Of Char), formats As String(), provider As IFormatProvider, Optional style As DateTimeStyles = System.Globalization.DateTimeStyles.None) As DateTime
Paramètres
- s
- ReadOnlySpan<Char>
Étendue contenant les caractères qui représentent une date et une heure à convertir.
- formats
- String[]
Tableau de formats possibles pour s
.
- provider
- IFormatProvider
Objet qui fournit des informations de format spécifiques à la culture sur s
.
- style
- DateTimeStyles
Combinaison d'opérations de bits de valeurs d'énumération qui indique le format autorisé du paramètre s
. Une valeur typique à spécifier est None.
Retours
Objet qui équivaut à la date et à l'heure figurant dans s
, comme spécifié par formats
, provider
et style
.
S’applique à
ParseExact(String, String, IFormatProvider, DateTimeStyles)
Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en DateTime équivalent à l'aide des informations et du style de format propres à la culture spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement au format spécifié, ou une exception est levée.
public:
static DateTime ParseExact(System::String ^ s, System::String ^ format, IFormatProvider ^ provider, System::Globalization::DateTimeStyles style);
public static DateTime ParseExact (string s, string format, IFormatProvider provider, System.Globalization.DateTimeStyles style);
public static DateTime ParseExact (string s, string format, IFormatProvider? provider, System.Globalization.DateTimeStyles style);
static member ParseExact : string * string * IFormatProvider * System.Globalization.DateTimeStyles -> DateTime
Public Shared Function ParseExact (s As String, format As String, provider As IFormatProvider, style As DateTimeStyles) As DateTime
Paramètres
- s
- String
Chaîne contenant une date et une heure à convertir.
- format
- String
Spécificateur de format définissant le format requis de s
. Pour plus d'informations, consultez la section Remarques.
- provider
- IFormatProvider
Objet qui fournit des informations de mise en forme propres à la culture sur s
.
- style
- DateTimeStyles
Combinaison d'opérations de bits des valeurs d'énumération qui fournit des informations supplémentaires sur s
, sur des éléments de style qui peuvent être présents dans s
ou sur la conversion de s
en valeur DateTime. Une valeur typique à spécifier est None.
Retours
Objet qui équivaut à la date et à l'heure figurant dans s
, comme spécifié par format
, provider
et style
.
Exceptions
s
ou format
est null
.
s
ou format
est une chaîne vide.
- ou -
s
ne contient pas une date et une heure qui correspondent au modèle spécifié dans format
.
- ou -
Le composant heure et l’indicateur AM/PM dans s
ne correspondent pas.
style
contient une combinaison non valide de valeurs DateTimeStyles. Par exemple, AssumeLocal et AssumeUniversal.
Exemples
L’exemple suivant illustre la ParseExact(String, String, IFormatProvider) méthode. Notez que la chaîne « 5/01/2009 8:30 AM » ne peut pas être analysée correctement lorsque le styles
paramètre est égal DateTimeStyles.None à car les espaces de début ne sont pas autorisés par format
. En outre, la chaîne « 5/01/2009 09:00 » ne peut pas être analysée correctement avec un format
de « mm/jj/yyyyhh : mm », car la chaîne de date ne précède pas le numéro de mois avec un zéro non significatif, comme le format
requiert.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
CultureInfo enUS = new CultureInfo("en-US");
string dateString;
DateTime dateValue;
// Parse date with no style flags.
dateString = " 5/01/2009 8:30 AM";
try {
dateValue = DateTime.ParseExact(dateString, "g", enUS, DateTimeStyles.None);
Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
dateValue.Kind);
}
catch (FormatException) {
Console.WriteLine("'{0}' is not in an acceptable format.", dateString);
}
// Allow a leading space in the date string.
try {
dateValue = DateTime.ParseExact(dateString, "g", enUS, DateTimeStyles.AllowLeadingWhite);
Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
dateValue.Kind);
}
catch (FormatException) {
Console.WriteLine("'{0}' is not in an acceptable format.", dateString);
}
// Use custom formats with M and MM.
dateString = "5/01/2009 09:00";
try {
dateValue = DateTime.ParseExact(dateString, "M/dd/yyyy hh:mm", enUS, DateTimeStyles.None);
Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
dateValue.Kind);
}
catch (FormatException) {
Console.WriteLine("'{0}' is not in an acceptable format.", dateString);
}
// Allow a leading space in the date string.
try {
dateValue = DateTime.ParseExact(dateString, "MM/dd/yyyy hh:mm", enUS, DateTimeStyles.None);
Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
dateValue.Kind);
}
catch (FormatException) {
Console.WriteLine("'{0}' is not in an acceptable format.", dateString);
}
// Parse a string with time zone information.
dateString = "05/01/2009 01:30:42 PM -05:00";
try {
dateValue = DateTime.ParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS, DateTimeStyles.None);
Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
dateValue.Kind);
}
catch (FormatException) {
Console.WriteLine("'{0}' is not in an acceptable format.", dateString);
}
// Allow a leading space in the date string.
try {
dateValue = DateTime.ParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS,
DateTimeStyles.AdjustToUniversal);
Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
dateValue.Kind);
}
catch (FormatException) {
Console.WriteLine("'{0}' is not in an acceptable format.", dateString);
}
// Parse a string representing UTC.
dateString = "2008-06-11T16:11:20.0904778Z";
try {
dateValue = DateTime.ParseExact(dateString, "o", CultureInfo.InvariantCulture,
DateTimeStyles.None);
Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
dateValue.Kind);
}
catch (FormatException) {
Console.WriteLine("'{0}' is not in an acceptable format.", dateString);
}
try {
dateValue = DateTime.ParseExact(dateString, "o", CultureInfo.InvariantCulture,
DateTimeStyles.RoundtripKind);
Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
dateValue.Kind);
}
catch (FormatException) {
Console.WriteLine("'{0}' is not in an acceptable format.", dateString);
}
}
}
// The example displays the following output:
// ' 5/01/2009 8:30 AM' is not in an acceptable format.
// Converted ' 5/01/2009 8:30 AM' to 5/1/2009 8:30:00 AM (Unspecified).
// Converted '5/01/2009 09:00' to 5/1/2009 9:00:00 AM (Unspecified).
// '5/01/2009 09:00' is not in an acceptable format.
// Converted '05/01/2009 01:30:42 PM -05:00' to 5/1/2009 11:30:42 AM (Local).
// Converted '05/01/2009 01:30:42 PM -05:00' to 5/1/2009 6:30:42 PM (Utc).
// Converted '2008-06-11T16:11:20.0904778Z' to 6/11/2008 9:11:20 AM (Local).
// Converted '2008-06-11T16:11:20.0904778Z' to 6/11/2008 4:11:20 PM (Utc).
Imports System.Globalization
Module Example
Public Sub Main()
Dim enUS As New CultureInfo("en-US")
Dim dateString As String
Dim dateValue As Date
' Parse date with no style flags.
dateString = " 5/01/2009 8:30 AM"
Try
dateValue = Date.ParseExact(dateString, "g", enUS, DateTimeStyles.None)
Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
dateValue.Kind)
Catch e As FormatException
Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
End Try
' Allow a leading space in the date string.
Try
dateValue = Date.ParseExact(dateString, "g", enUS, DateTimeStyles.AllowLeadingWhite)
Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
dateValue.Kind)
Catch e As FormatException
Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
End Try
' Use custom formats with M and MM.
dateString = "5/01/2009 09:00"
Try
dateValue = Date.ParseExact(dateString, "M/dd/yyyy hh:mm", enUS, DateTimeStyles.None)
Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
dateValue.Kind)
Catch e As FormatException
Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
End Try
' Allow a leading space in the date string.
Try
dateValue = Date.ParseExact(dateString, "MM/dd/yyyy hh:mm", enUS, DateTimeStyles.None)
Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
dateValue.Kind)
Catch e As FormatException
Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
End Try
' Parse a string with time zone information.
dateString = "05/01/2009 01:30:42 PM -05:00"
Try
dateValue = Date.ParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS, DateTimeStyles.None)
Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
dateValue.Kind)
Catch e As FormatException
Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
End Try
' Allow a leading space in the date string.
Try
dateValue = Date.ParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS, _
DateTimeStyles.AdjustToUniversal)
Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
dateValue.Kind)
Catch e As FormatException
Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
End Try
' Parse a string representing UTC.
dateString = "2008-06-11T16:11:20.0904778Z"
Try
dateValue = Date.ParseExact(dateString, "o", CultureInfo.InvariantCulture, _
DateTimeStyles.None)
Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
dateValue.Kind)
Catch e As FormatException
Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
End Try
Try
dateValue = Date.ParseExact(dateString, "o", CultureInfo.InvariantCulture, _
DateTimeStyles.RoundtripKind)
Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
dateValue.Kind)
Catch e As FormatException
Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
End Try
End Sub
End Module
' The example displays the following output:
' ' 5/01/2009 8:30 AM' is not in an acceptable format.
' Converted ' 5/01/2009 8:30 AM' to 5/1/2009 8:30:00 AM (Unspecified).
' Converted '5/01/2009 09:00' to 5/1/2009 9:00:00 AM (Unspecified).
' '5/01/2009 09:00' is not in an acceptable format.
' Converted '05/01/2009 01:30:42 PM -05:00' to 5/1/2009 11:30:42 AM (Local).
' Converted '05/01/2009 01:30:42 PM -05:00' to 5/1/2009 6:30:42 PM (Utc).
' Converted '2008-06-11T16:11:20.0904778Z' to 6/11/2008 9:11:20 AM (Local).
' Converted '2008-06-11T16:11:20.0904778Z' to 6/11/2008 4:11:20 PM (Utc).
Remarques
La DateTime.ParseExact(String, String, IFormatProvider, DateTimeStyles) méthode analyse la représentation sous forme de chaîne d’une date, qui doit être dans un format défini par le format
paramètre. Elle requiert également que les éléments de date et d’heure de s
apparaissent dans l’ordre spécifié par format
. Si s
ne correspond pas au modèle du format
paramètre, avec les variations définies par le style
paramètre, la méthode lève une FormatException . En revanche, la DateTime.Parse(String, IFormatProvider, DateTimeStyles) méthode analyse la représentation sous forme de chaîne d’une date dans l’un des formats reconnus par l’objet du fournisseur de format DateTimeFormatInfo . La DateTime.Parse(String, IFormatProvider, DateTimeStyles) méthode permet également aux éléments de date et d’heure dans s
d’apparaître dans n’importe quel ordre.
Si le s
paramètre contient uniquement une heure et aucune date, la date actuelle est utilisée, sauf si le style
paramètre inclut l' DateTimeStyles.NoCurrentDateDefault indicateur, auquel cas la date par défaut ( DateTime.Date.MinValue
) est utilisée. Si le s
paramètre contient uniquement une date et aucune heure, minuit (00:00:00) est utilisé. Le style
paramètre détermine également si le s
paramètre peut contenir des espaces blancs de début, internes ou de fin.
Si s
ne contient pas d’informations de fuseau horaire, la Kind propriété de l' DateTime objet retourné est DateTimeKind.Unspecified . Ce comportement peut être modifié à l’aide de l' DateTimeStyles.AssumeLocal indicateur, qui retourne une DateTime valeur dont la Kind propriété a DateTimeKind.Local la valeur, ou à l’aide des DateTimeStyles.AssumeUniversal DateTimeStyles.AdjustToUniversal indicateurs et, qui retourne une DateTime valeur dont la Kind propriété a la valeur DateTimeKind.Utc . Si s
contient des informations de fuseau horaire, l’heure est convertie en heure locale, si nécessaire, et la Kind propriété de l' DateTime objet retourné a la valeur DateTimeKind.Local . Ce comportement peut être modifié à l’aide de l' DateTimeStyles.RoundtripKind indicateur pour ne pas convertir le temps universel coordonné (UTC, Universal Time Coordinated) en heure locale et pour affecter à la propriété la valeur Kind DateTimeKind.Utc .
Le format
paramètre définit le modèle requis du s
paramètre. Il peut se composer d’un ou de plusieurs spécificateurs de format personnalisés du tableau de chaînes de format de date et d’heure personnalisé , ou d’un spécificateur de format standard unique, qui identifie un modèle prédéfini, à partir du tableau de chaînes de format de date et d’heure standard .
Si vous n’utilisez pas de séparateurs de date ou d’heure dans un modèle de format personnalisé, utilisez la culture dite indifférente pour le provider
paramètre et la forme la plus étendue de chaque spécificateur de format personnalisé. Par exemple, si vous souhaitez spécifier des heures dans le modèle, spécifiez la forme plus large, « HH », au lieu de la forme plus étroite, « H ».
Notes
Plutôt que de demander à ce qu’il soit s
conforme à un format unique pour que l’opération d’analyse aboutisse, vous pouvez appeler la DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles) méthode et spécifier plusieurs formats autorisés. Cela rend l’opération d’analyse plus susceptible d’être effectuée.
Le styles
paramètre comprend un ou plusieurs membres de l' DateTimeStyles énumération qui déterminent si et où l’espace blanc non défini par format
peut apparaître dans s
et qui contrôlent le comportement précis de l’opération d’analyse. Le tableau suivant décrit la façon dont chaque membre de l' DateTimeStyles énumération affecte le fonctionnement de la ParseExact(String, String, IFormatProvider, DateTimeStyles) méthode.
Membre DateTimeStyles | Description |
---|---|
AdjustToUniversal | Analyse s et, si nécessaire, le convertit en heure UTC. Si s inclut un décalage de fuseau horaire, ou si s ne contient pas d’informations de fuseau horaire mais styles inclut l' DateTimeStyles.AssumeLocal indicateur, la méthode analyse la chaîne, appelle ToUniversalTime pour convertir la valeur retournée DateTime en heure UTC et affecte à la propriété la valeur Kind DateTimeKind.Utc . Si s indique qu’il représente l’heure UTC, ou si s ne contient pas d’informations sur les fuseaux horaires mais styles comprend l' DateTimeStyles.AssumeUniversal indicateur, la méthode analyse la chaîne, n’effectue aucune conversion de fuseau horaire sur la valeur retournée DateTime et affecte à la propriété la valeur Kind DateTimeKind.Utc . Dans tous les autres cas, l’indicateur n’a aucun effet. |
AllowInnerWhite | Spécifie que l’espace blanc non défini par format peut apparaître entre un élément de date ou d’heure spécifique. |
AllowLeadingWhite | Spécifie que l’espace blanc non défini par format peut apparaître au début de s . |
AllowTrailingWhite | Spécifie que l’espace blanc non défini par format peut apparaître à la fin de s . |
AllowWhiteSpaces | Spécifie que s peut contenir des espaces blancs de début, internes et de fin non définis par format . |
AssumeLocal | Spécifie que s' s il manque des informations de fuseau horaire, il est supposé représenter une heure locale. À moins que l' DateTimeStyles.AdjustToUniversal indicateur ne soit présent, la Kind propriété de la valeur retournée DateTime est définie sur DateTimeKind.Local . |
AssumeUniversal | Spécifie que s' s il manque des informations de fuseau horaire, il est supposé représenter l’heure UTC. À moins que l' DateTimeStyles.AdjustToUniversal indicateur ne soit présent, la méthode convertit la valeur retournée de l’heure DateTime UTC en heure locale et affecte à sa propriété la valeur Kind DateTimeKind.Local . |
NoCurrentDateDefault | Si s contient une heure sans informations de date, la date de la valeur de retour est définie sur DateTime.MinValue.Date . |
None | Le s paramètre est analysé à l’aide des valeurs par défaut. Aucun espace blanc autre que celui présent dans format n’est autorisé. Si le s n’a pas de composant date, la date de la valeur retournée DateTime est définie sur 1/1/0001. Si s ne contient pas d’informations de fuseau horaire, la Kind propriété de l' DateTime objet retourné a la valeur DateTimeKind.Unspecified . Si des informations de fuseau horaire sont présentes dans s , l’heure est convertie en heure locale et la Kind propriété de l' DateTime objet retourné a la valeur DateTimeKind.Local . |
RoundtripKind | Pour les chaînes qui contiennent des informations de fuseau horaire, tente d’empêcher la conversion en une DateTime valeur date/heure avec sa Kind propriété définie sur DateTimeKind.Local . Cet indicateur empêche principalement la conversion des heures UTC en heures locales. |
Les symboles et les chaînes de date et d’heure particuliers (tels que les noms des jours de la semaine dans une langue particulière) utilisés dans s
sont définis par le provider
paramètre, tout comme le format précis de s
si format
est une chaîne de spécificateur de format standard. Le provider
paramètre peut être l’un des éléments suivants :
CultureInfoObjet qui représente la culture utilisée pour interpréter
s
. L' DateTimeFormatInfo objet retourné par sa DateTimeFormat propriété définit les symboles et la mise en forme danss
.DateTimeFormatInfoObjet qui définit le format des données de date et d’heure.
Implémentation personnalisée IFormatProvider dont GetFormat la méthode retourne l' CultureInfo objet ou l' DateTimeFormatInfo objet qui fournit les informations de mise en forme.
Si provider
a null
la valeur, l' CultureInfo objet qui correspond à la culture actuelle est utilisé.
Notes pour les appelants
dans le .NET Framework 4, la ParseExact méthode lève une exception FormatException si la chaîne à analyser contient un composant heure et un indicateur AM/PM qui ne sont pas en accord. dans le .NET Framework 3,5 et les versions antérieures, l’indicateur AM/PM est ignoré.
Voir aussi
- TryParseExact
- CultureInfo
- DateTimeFormatInfo
- Analyse des chaînes de date et d'heure dans .NET Framework
- Chaînes de format de date et d'heure standard
- Chaînes de format de date et d'heure personnalisées
S’applique à
ParseExact(String, String[], IFormatProvider, DateTimeStyles)
Convertit la représentation sous forme de chaîne spécifiée d'une date et heure en son équivalent DateTime à l'aide du tableau de formats, des informations et du style de format propres à la culture spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement à au moins l'un des formats spécifiés, ou une exception est levée.
public:
static DateTime ParseExact(System::String ^ s, cli::array <System::String ^> ^ formats, IFormatProvider ^ provider, System::Globalization::DateTimeStyles style);
public static DateTime ParseExact (string s, string[] formats, IFormatProvider provider, System.Globalization.DateTimeStyles style);
public static DateTime ParseExact (string s, string[] formats, IFormatProvider? provider, System.Globalization.DateTimeStyles style);
static member ParseExact : string * string[] * IFormatProvider * System.Globalization.DateTimeStyles -> DateTime
Public Shared Function ParseExact (s As String, formats As String(), provider As IFormatProvider, style As DateTimeStyles) As DateTime
Paramètres
- s
- String
Chaîne contenant une date et une heure à convertir.
- formats
- String[]
Tableau de formats possibles pour s
. Pour plus d'informations, consultez la section Remarques.
- provider
- IFormatProvider
Objet qui fournit des informations de format spécifiques à la culture sur s
.
- style
- DateTimeStyles
Combinaison d'opérations de bits de valeurs d'énumération qui indique le format autorisé du paramètre s
. Une valeur typique à spécifier est None.
Retours
Objet qui équivaut à la date et à l'heure figurant dans s
, comme spécifié par formats
, provider
et style
.
Exceptions
s
ou formats
est null
.
s
est une chaîne vide.
- ou -
un élément de formats
est une chaîne vide.
- ou -
s
ne contient pas de date et heure qui correspondent à un élément de formats
.
- ou -
Le composant heure et l’indicateur AM/PM dans s
ne correspondent pas.
style
contient une combinaison non valide de valeurs DateTimeStyles. Par exemple, AssumeLocal et AssumeUniversal.
Exemples
L’exemple suivant utilise la DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles) méthode pour garantir qu’une chaîne dans un certain nombre de formats possibles peut être analysée avec succès.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
string[] formats= {"M/d/yyyy h:mm:ss tt", "M/d/yyyy h:mm tt",
"MM/dd/yyyy hh:mm:ss", "M/d/yyyy h:mm:ss",
"M/d/yyyy hh:mm tt", "M/d/yyyy hh tt",
"M/d/yyyy h:mm", "M/d/yyyy h:mm",
"MM/dd/yyyy hh:mm", "M/dd/yyyy hh:mm",
"MM/d/yyyy HH:mm:ss.ffffff" };
string[] dateStrings = {"5/1/2009 6:32 PM", "05/01/2009 6:32:05 PM",
"5/1/2009 6:32:00", "05/01/2009 06:32",
"05/01/2009 06:32:00 PM", "05/01/2009 06:32:00",
"08/28/2015 16:17:39.125", "08/28/2015 16:17:39.125000" };
DateTime dateValue;
foreach (string dateString in dateStrings)
{
try {
dateValue = DateTime.ParseExact(dateString, formats,
new CultureInfo("en-US"),
DateTimeStyles.None);
Console.WriteLine("Converted '{0}' to {1}.", dateString, dateValue);
}
catch (FormatException) {
Console.WriteLine("Unable to convert '{0}' to a date.", dateString);
}
}
}
}
// The example displays the following output:
// Converted '5/1/2009 6:32 PM' to 5/1/2009 6:32:00 PM.
// Converted '05/01/2009 6:32:05 PM' to 5/1/2009 6:32:05 PM.
// Converted '5/1/2009 6:32:00' to 5/1/2009 6:32:00 AM.
// Converted '05/01/2009 06:32' to 5/1/2009 6:32:00 AM.
// Converted '05/01/2009 06:32:00 PM' to 5/1/2009 6:32:00 PM.
// Converted '05/01/2009 06:32:00' to 5/1/2009 6:32:00 AM.
// Unable to convert '08/28/2015 16:17:39.125' to a date.
// Converted '08/28/2015 16:17:39.125000' to 8/28/2015 4:17:39 PM.
Imports System.Globalization
Module Example
Public Sub Main()
Dim formats() As String = {"M/d/yyyy h:mm:ss tt", "M/d/yyyy h:mm tt", _
"MM/dd/yyyy hh:mm:ss", "M/d/yyyy h:mm:ss", _
"M/d/yyyy hh:mm tt", "M/d/yyyy hh tt", _
"M/d/yyyy h:mm", "M/d/yyyy h:mm", _
"MM/dd/yyyy hh:mm", "M/dd/yyyy hh:mm",
"MM/d/yyyy HH:mm:ss.ffffff" }
Dim dateStrings() As String = {"5/1/2009 6:32 PM", "05/01/2009 6:32:05 PM", _
"5/1/2009 6:32:00", "05/01/2009 06:32", _
"05/01/2009 06:32:00 PM", "05/01/2009 06:32:00",
"08/28/2015 16:17:39.125", "08/28/2015 16:17:39.125000" }
Dim dateValue As DateTime
For Each dateString As String In dateStrings
Try
dateValue = DateTime.ParseExact(dateString, formats, _
New CultureInfo("en-US"), _
DateTimeStyles.None)
Console.WriteLine("Converted '{0}' to {1}.", dateString, dateValue)
Catch e As FormatException
Console.WriteLine("Unable to convert '{0}' to a date.", dateString)
End Try
Next
End Sub
End Module
' The example displays the following output:
' Converted '5/1/2009 6:32 PM' to 5/1/2009 6:32:00 PM.
' Converted '05/01/2009 6:32:05 PM' to 5/1/2009 6:32:05 PM.
' Converted '5/1/2009 6:32:00' to 5/1/2009 6:32:00 AM.
' Converted '05/01/2009 06:32' to 5/1/2009 6:32:00 AM.
' Converted '05/01/2009 06:32:00 PM' to 5/1/2009 6:32:00 PM.
' Converted '05/01/2009 06:32:00' to 5/1/2009 6:32:00 AM.
' Unable to convert '08/28/2015 16:17:39.125' to a date.
' Converted '08/28/2015 16:17:39.125000' to 8/28/2015 4:17:39 PM.
Remarques
La DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles) méthode analyse la représentation sous forme de chaîne d’une date qui correspond à l’un des modèles affectés au formats
paramètre. Si la chaîne s
ne correspond à aucun de ces modèles avec l’une des variations définies par le styles
paramètre, la méthode lève une FormatException . Outre la comparaison s
à plusieurs modèles de mise en forme, plutôt qu’à un seul modèle de mise en forme, cette surcharge se comporte de la même façon que la DateTime.ParseExact(String, String, IFormatProvider, DateTimeStyles) méthode.
Le s
paramètre contient la date et l’heure à analyser. Si le s
paramètre contient uniquement une heure et aucune date, la date actuelle est utilisée, sauf si le style
paramètre inclut l' DateTimeStyles.NoCurrentDateDefault indicateur, auquel cas la date par défaut ( DateTime.Date.MinValue
) est utilisée. Si le s
paramètre contient uniquement une date et aucune heure, minuit (00:00:00) est utilisé. Le style
paramètre détermine également si le s
paramètre peut contenir des espaces blancs de début, internes ou de fin autres que ceux autorisés par l’une des chaînes de format dans formats
.
Si s
ne contient pas d’informations de fuseau horaire, la Kind propriété de l' DateTime objet retourné est DateTimeKind.Unspecified . Ce comportement peut être modifié à l’aide de l' DateTimeStyles.AssumeLocal indicateur, qui retourne une DateTime valeur dont la Kind propriété a DateTimeKind.Local la valeur, ou à l’aide des DateTimeStyles.AssumeUniversal DateTimeStyles.AdjustToUniversal indicateurs et, qui retourne une DateTime valeur dont la Kind propriété a la valeur DateTimeKind.Utc . Si s
contient des informations de fuseau horaire, l’heure est convertie en heure locale, si nécessaire, et la Kind propriété de l' DateTime objet retourné a la valeur DateTimeKind.Local . Ce comportement peut être modifié à l’aide de l' DateTimeStyles.RoundtripKind indicateur pour ne pas convertir le temps universel coordonné (UTC, Universal Time Coordinated) en heure locale et affecter à la propriété la valeur Kind DateTimeKind.Utc .
Le formats
paramètre contient un tableau de modèles, dont l’un s
doit correspondre exactement si l’opération d’analyse doit être effectuée correctement. Les modèles du formats
paramètre se composent d’un ou de plusieurs spécificateurs de format personnalisés du tableau de chaînes de format de date et d’heure personnalisé , ou d’un spécificateur de format standard unique, qui identifie un modèle prédéfini, à partir du tableau de chaînes de format de date et d’heure standard .
Si vous n’utilisez pas de séparateurs de date ou d’heure dans un modèle de format personnalisé, utilisez la culture dite indifférente pour le provider
paramètre et la forme la plus étendue de chaque spécificateur de format personnalisé. Par exemple, si vous souhaitez spécifier des heures dans le modèle, spécifiez la forme plus large, « HH », au lieu de la forme plus étroite, « H ».
Le styles
paramètre comprend un ou plusieurs membres de l' DateTimeStyles énumération qui déterminent si et où l’espace blanc non défini par format
peut apparaître dans s
et qui contrôlent le comportement précis de l’opération d’analyse. Le tableau suivant décrit la façon dont chaque membre de l' DateTimeStyles énumération affecte le fonctionnement de la ParseExact(String, String, IFormatProvider, DateTimeStyles) méthode.
Membre DateTimeStyles | Description |
---|---|
AdjustToUniversal | Analyse s et, si nécessaire, le convertit en heure UTC. Si s inclut un décalage de fuseau horaire, ou si s ne contient pas d’informations de fuseau horaire mais styles inclut l' DateTimeStyles.AssumeLocal indicateur, la méthode analyse la chaîne, appelle ToUniversalTime pour convertir la valeur retournée DateTime en heure UTC et affecte à la propriété la valeur Kind DateTimeKind.Utc . Si s indique qu’il représente l’heure UTC, ou si s ne contient pas d’informations sur les fuseaux horaires mais styles comprend l' DateTimeStyles.AssumeUniversal indicateur, la méthode analyse la chaîne, n’effectue aucune conversion de fuseau horaire sur la valeur retournée DateTime et affecte à la propriété la valeur Kind DateTimeKind.Utc . Dans tous les autres cas, l’indicateur n’a aucun effet. |
AllowInnerWhite | Spécifie que l’espace blanc non défini par format peut apparaître entre un élément de date ou d’heure spécifique. |
AllowLeadingWhite | Spécifie que l’espace blanc non défini par format peut apparaître au début de s . |
AllowTrailingWhite | Spécifie que l’espace blanc non défini par format peut apparaître à la fin de s . |
AllowWhiteSpaces | Spécifie que s peut contenir des espaces blancs de début, internes et de fin non définis par format . |
AssumeLocal | Spécifie que s' s il manque des informations de fuseau horaire, il est supposé représenter une heure locale. À moins que l' DateTimeStyles.AdjustToUniversal indicateur ne soit présent, la Kind propriété de la valeur retournée DateTime est définie sur DateTimeKind.Local . |
AssumeUniversal | Spécifie que s' s il manque des informations de fuseau horaire, il est supposé représenter l’heure UTC. À moins que l' DateTimeStyles.AdjustToUniversal indicateur ne soit présent, la méthode convertit la valeur retournée de l’heure DateTime UTC en heure locale et affecte à sa propriété la valeur Kind DateTimeKind.Local . |
NoCurrentDateDefault | Si s contient une heure sans informations de date, la date de la valeur de retour est définie sur DateTime.MinValue.Date . |
None | Le s paramètre est analysé à l’aide des valeurs par défaut. Aucun espace blanc autre que celui présent dans format n’est autorisé. Si le s n’a pas de composant date, la date de la valeur retournée DateTime est définie sur 1/1/0001. Si s ne contient pas d’informations de fuseau horaire, la Kind propriété de l' DateTime objet retourné a la valeur DateTimeKind.Unspecified . Si des informations de fuseau horaire sont présentes dans s , l’heure est convertie en heure locale et la Kind propriété de l' DateTime objet retourné a la valeur DateTimeKind.Local . |
RoundtripKind | Pour les chaînes qui contiennent des informations de fuseau horaire, tente d’empêcher la conversion en une date et une heure dont la propriété a la Kind valeur DateTimeKind.Local . Cet indicateur empêche principalement la conversion des heures UTC en heures locales. |
Les symboles et les chaînes de date et d’heure particuliers (tels que les noms des jours de la semaine dans une langue particulière) utilisés dans s
sont définis par le provider
paramètre, tout comme le format précis de s
si format
est une chaîne de spécificateur de format standard. Le provider
paramètre peut être l’un des éléments suivants :
CultureInfoObjet qui représente la culture utilisée pour interpréter
s
. L' DateTimeFormatInfo objet retourné par sa DateTimeFormat propriété définit les symboles et la mise en forme danss
.DateTimeFormatInfoObjet qui définit le format des données de date et d’heure.
Implémentation personnalisée IFormatProvider dont GetFormat la méthode retourne l' CultureInfo objet ou l' DateTimeFormatInfo objet qui fournit les informations de mise en forme.
Si provider
a null
la valeur, l' CultureInfo objet qui correspond à la culture actuelle est utilisé.
Notes pour les appelants
dans le .NET Framework 4, la ParseExact méthode lève une exception FormatException si la chaîne à analyser contient un composant heure et un indicateur AM/PM qui ne sont pas en accord. dans le .NET Framework 3,5 et les versions antérieures, l’indicateur AM/PM est ignoré.
Voir aussi
- TryParseExact
- CultureInfo
- DateTimeFormatInfo
- Analyse des chaînes de date et d'heure dans .NET Framework
- Chaînes de format de date et d'heure standard
- Chaînes de format de date et d'heure personnalisées