DateTime.TryParse Méthode

Définition

Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en son équivalent DateTime et retourne une valeur qui indique si la conversion a réussi.

Surcharges

TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)

Convertit la représentation sous forme d’étendue d’une date et d’une heure en son équivalent DateTime à l’aide des informations de format et du style de mise en forme propres à la culture spécifiés, et retourne une valeur qui indique si la conversion a réussi.

TryParse(String, DateTime)

Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en son équivalent DateTime et retourne une valeur qui indique si la conversion a réussi.

TryParse(String, IFormatProvider, DateTimeStyles, DateTime)

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 et du style de mise en forme propres à la culture spécifiés, et retourne une valeur qui indique si la conversion a réussi.

TryParse(ReadOnlySpan<Char>, DateTime)

Convertit l’étendue de caractères spécifiée d’une date et d’une heure en son équivalent DateTime et retourne une valeur qui indique si la conversion a réussi.

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.

TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)

Convertit la représentation sous forme d’étendue d’une date et d’une heure en son équivalent DateTime à l’aide des informations de format et du style de mise en forme propres à la culture spécifiés, et retourne une valeur qui indique si la conversion a réussi.

public:
 static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, System::Globalization::DateTimeStyles styles, [Runtime::InteropServices::Out] DateTime % result);
public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, System.Globalization.DateTimeStyles styles, out DateTime result);
public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider provider, System.Globalization.DateTimeStyles styles, out DateTime result);
static member TryParse : ReadOnlySpan<char> * IFormatProvider * System.Globalization.DateTimeStyles * DateTime -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, styles As DateTimeStyles, ByRef result As DateTime) As Boolean

Paramètres

s
ReadOnlySpan<Char>

Étendue contenant les caractères représentant la date et l’heure à convertir.

provider
IFormatProvider

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

styles
DateTimeStyles

Combinaison d'opérations de bits de valeurs d'énumération qui définit la manière d'interpréter les données analysées par rapport au fuseau horaire actuel ou à la date actuelle. Une valeur typique à spécifier est None.

result
DateTime

Quand cette méthode est retournée, contient la valeur de DateTime équivalente à la date et l'heure contenues dans s si la conversion a réussi, ou MinValue si elle a échoué. La conversion échoue si le paramètre s est null, est une chaîne vide ("") ou ne contient pas de représentation sous forme de chaîne valide d'une date et d'une heure. Ce paramètre est passé sans être initialisé.

Retours

Boolean

true si la conversion du paramètre s a réussi ; sinon, false.

S’applique à

TryParse(String, DateTime)

Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en son équivalent DateTime et retourne une valeur qui indique si la conversion a réussi.

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] DateTime % result);
public static bool TryParse (string s, out DateTime result);
public static bool TryParse (string? s, out DateTime result);
static member TryParse : string * DateTime -> bool
Public Shared Function TryParse (s As String, ByRef result As DateTime) As Boolean

Paramètres

s
String

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

result
DateTime

Quand cette méthode est retournée, contient la valeur de DateTime équivalente à la date et l'heure contenues dans s si la conversion a réussi, ou MinValue si elle a échoué. La conversion échoue si le paramètre s est null, est une chaîne vide ("") ou ne contient pas de représentation sous forme de chaîne valide d'une date et d'une heure. Ce paramètre est passé sans être initialisé.

Retours

Boolean

true si la conversion du paramètre s a réussi ; sinon, false.

Exemples

L’exemple suivant passe un certain nombre de chaînes de date et d’heure à la DateTime.TryParse(String, DateTime) méthode.

using namespace System;
using namespace System::Globalization;

void main()
{
   array<String^>^ dateStrings = { "05/01/2009 14:57:32.8", "2009-05-01 14:57:32.8", 
                                   "2009-05-01T14:57:32.8375298-04:00", 
                                    "5/01/2008 14:57:32.80 -07:00", 
                                    "1 May 2008 2:57:32.8 PM", "16-05-2009 1:00:32 PM", 
                                    "Fri, 15 May 2009 20:10:57 GMT" };
   DateTime dateValue;

   Console::WriteLine("Attempting to parse strings using {0} culture.", 
                     CultureInfo::CurrentCulture->Name);
   for each (String^ dateString in dateStrings)
   {
      if (DateTime::TryParse(dateString, dateValue)) 
         Console::WriteLine("  Converted '{0}' to {1} ({2}).", dateString, 
                           dateValue, dateValue.Kind);
      else
         Console::WriteLine("  Unable to parse '{0}'.", dateString);
   }
}
// The example displays the following output: 
//    Attempting to parse strings using en-US culture. 
//       Converted '05/01/2009 14:57:32.8' to 5/1/2009 2:57:32 PM (Unspecified). 
//       Converted '2009-05-01 14:57:32.8' to 5/1/2009 2:57:32 PM (Unspecified). 
//       Converted '2009-05-01T14:57:32.8375298-04:00' to 5/1/2009 11:57:32 AM (Local). 
//       Converted '5/01/2008 14:57:32.80 -07:00' to 5/1/2008 2:57:32 PM (Local). 
//       Converted '1 May 2008 2:57:32.8 PM' to 5/1/2008 2:57:32 PM (Unspecified). 
//       Unable to parse '16-05-2009 1:00:32 PM'. 
//       Converted 'Fri, 15 May 2009 20:10:57 GMT' to 5/15/2009 1:10:57 PM (Local).
using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] dateStrings = {"05/01/2009 14:57:32.8", "2009-05-01 14:57:32.8",
                              "2009-05-01T14:57:32.8375298-04:00", "5/01/2008",
                              "5/01/2008 14:57:32.80 -07:00",
                              "1 May 2008 2:57:32.8 PM", "16-05-2009 1:00:32 PM",
                              "Fri, 15 May 2009 20:10:57 GMT" };
      DateTime dateValue;

      Console.WriteLine("Attempting to parse strings using {0} culture.",
                        CultureInfo.CurrentCulture.Name);
      foreach (string dateString in dateStrings)
      {
         if (DateTime.TryParse(dateString, out dateValue))
            Console.WriteLine("  Converted '{0}' to {1} ({2}).", dateString,
                              dateValue, dateValue.Kind);
         else
            Console.WriteLine("  Unable to parse '{0}'.", dateString);
      }
   }
}
// The example displays output like the following:
//    Attempting to parse strings using en-US culture.
//      Converted '05/01/2009 14:57:32.8' to 5/1/2009 2:57:32 PM (Unspecified).
//      Converted '2009-05-01 14:57:32.8' to 5/1/2009 2:57:32 PM (Unspecified).
//      Converted '2009-05-01T14:57:32.8375298-04:00' to 5/1/2009 11:57:32 AM (Local).
//
//      Converted '5/01/2008' to 5/1/2008 12:00:00 AM (Unspecified).
//      Converted '5/01/2008 14:57:32.80 -07:00' to 5/1/2008 2:57:32 PM (Local).
//      Converted '1 May 2008 2:57:32.8 PM' to 5/1/2008 2:57:32 PM (Unspecified).
//      Unable to parse '16-05-2009 1:00:32 PM'.
//      Converted 'Fri, 15 May 2009 20:10:57 GMT' to 5/15/2009 1:10:57 PM (Local).
Imports System.Globalization

Public Module Example
   Public Sub Main()
      Dim dateStrings() As String = {"05/01/2009 14:57:32.8", "2009-05-01 14:57:32.8",
                                     "2009-05-01T14:57:32.8375298-04:00", "5/01/2008",
                                     "5/01/2008 14:57:32.80 -07:00",
                                     "1 May 2008 2:57:32.8 PM", "16-05-2009 1:00:32 PM",
                                     "Fri, 15 May 2009 20:10:57 GMT"}
      Dim dateValue As Date
      
      Console.WriteLine("Attempting to parse strings using {0} culture.", _
                        CultureInfo.CurrentCulture.Name)
      For Each dateString As String In dateStrings
         If Date.TryParse(dateString, dateValue) Then
            Console.WriteLine("  Converted '{0}' to {1} ({2}).", dateString, _
                              dateValue, dateValue.Kind)
         Else
            Console.WriteLine("  Unable to parse '{0}'.", dateString)
         End If
      Next
   End Sub
End Module
' The example displays output like the following:
'    Attempting to parse strings using en-US culture.
'      Converted '05/01/2009 14:57:32.8' to 5/1/2009 2:57:32 PM (Unspecified).
'      Converted '2009-05-01 14:57:32.8' to 5/1/2009 2:57:32 PM (Unspecified).
'      Converted '2009-05-01T14:57:32.8375298-04:00' to 5/1/2009 11:57:32 AM (Local).
'
'      Converted '5/01/2008' to 5/1/2008 12:00:00 AM (Unspecified).
'      Converted '5/01/2008 14:57:32.80 -07:00' to 5/1/2008 2:57:32 PM (Local).
'      Converted '1 May 2008 2:57:32.8 PM' to 5/1/2008 2:57:32 PM (Unspecified).
'      Unable to parse '16-05-2009 1:00:32 PM'.
'      Converted 'Fri, 15 May 2009 20:10:57 GMT' to 5/15/2009 1:10:57 PM (Local).

Remarques

La DateTime.TryParse(String, DateTime) méthode est semblable à la DateTime.Parse(String) méthode, sauf que la TryParse(String, DateTime) méthode ne lève pas d’exception en cas d’échec de la conversion.

La chaîne s est analysée à l’aide des informations de mise en forme dans l' DateTimeFormatInfo objet actuel, qui est fourni implicitement par la culture actuelle du thread.

Cette méthode tente d’ignorer les données non reconnues, si possible, et remplit les informations sur le mois, le jour et l’année manquantes avec la date actuelle. Si s contient uniquement une date et aucune heure, cette méthode suppose que l’heure est 12:00 minuit. Si s comprend un composant de date avec une année à 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é. Tout caractère d’espace blanc de début, interne ou de fin s est ignoré. La date et l’heure peuvent être placées entre des signes dièse (« # », U + 0023) et un ou plusieurs caractères NULL (U + 0000) peuvent être placés entre parenthèses.

Étant donné que la DateTime.TryParse(String, DateTime) méthode tente d’analyser la représentation sous forme de chaîne d’une date et d’une heure à l’aide des règles de mise en forme de la culture actuelle, la tentative d’analyse d’une chaîne particulière entre différentes cultures peut échouer ou retourner des résultats différents. Si un format de date et d’heure spécifique est analysé à travers des paramètres régionaux différents, utilisez la DateTime.TryParse(String, IFormatProvider, DateTimeStyles, DateTime) méthode ou l’une des surcharges de la TryParseExact méthode et fournissez un spécificateur de format.

Si s est la représentation sous forme de chaîne d’un jour d’une année bissextile dans le calendrier actuel, la méthode s’analyse s correctement. Si s est la représentation sous forme de chaîne d’un jour d’une année bissextile d’une année non bissextile dans le calendrier actuel de la culture actuelle, l’opération d’analyse échoue et la méthode retourne false .

Si s ne contient pas d’informations de fuseau horaire, result contient une DateTime valeur dont Kind la propriété est DateTimeKind.Unspecified lorsque la méthode est retournée. Si la chaîne à analyser contient des informations de fuseau horaire, result contient une DateTime valeur dont Kind la propriété DateTimeKind.Local est lorsque la méthode est retournée.

Notes pour les appelants

La mise en forme est influencée par les propriétés de l' DateTimeFormatInfo objet actuel, qui sont dérivées par défaut de l’élément Options régionales et linguistiques du panneau de configuration. La TryParse méthode peut échouer de manière inattendue et retourner False si les DateSeparator propriétés actuelles et TimeSeparator sont définies sur la même valeur.

Voir aussi

S’applique à

TryParse(String, IFormatProvider, DateTimeStyles, DateTime)

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 et du style de mise en forme propres à la culture spécifiés, et retourne une valeur qui indique si la conversion a réussi.

public:
 static bool TryParse(System::String ^ s, IFormatProvider ^ provider, System::Globalization::DateTimeStyles styles, [Runtime::InteropServices::Out] DateTime % result);
public static bool TryParse (string s, IFormatProvider provider, System.Globalization.DateTimeStyles styles, out DateTime result);
public static bool TryParse (string? s, IFormatProvider? provider, System.Globalization.DateTimeStyles styles, out DateTime result);
static member TryParse : string * IFormatProvider * System.Globalization.DateTimeStyles * DateTime -> bool
Public Shared Function TryParse (s As String, provider As IFormatProvider, styles As DateTimeStyles, ByRef result As DateTime) As Boolean

Paramètres

s
String

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

provider
IFormatProvider

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

styles
DateTimeStyles

Combinaison d'opérations de bits de valeurs d'énumération qui définit la manière d'interpréter les données analysées par rapport au fuseau horaire actuel ou à la date actuelle. Une valeur typique à spécifier est None.

result
DateTime

Quand cette méthode est retournée, contient la valeur de DateTime équivalente à la date et l'heure contenues dans s si la conversion a réussi, ou MinValue si elle a échoué. La conversion échoue si le paramètre s est null, est une chaîne vide ("") ou ne contient pas de représentation sous forme de chaîne valide d'une date et d'une heure. Ce paramètre est passé sans être initialisé.

Retours

Boolean

true si la conversion du paramètre s a réussi ; sinon, false.

Exceptions

styles n’est pas une valeur de DateTimeStyles valide.

provider est une culture neutre et ne peut pas être utilisé dans une opération d’analyse.

Exemples

L’exemple suivant illustre la DateTime.TryParse(String, IFormatProvider, DateTimeStyles, DateTime) méthode.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string dateString;
      CultureInfo culture;
      DateTimeStyles styles;
      DateTime dateResult;

      // Parse a date and time with no styles.
      dateString = "03/01/2009 10:00 AM";
      culture = CultureInfo.CreateSpecificCulture("en-US");
      styles = DateTimeStyles.None;
      if (DateTime.TryParse(dateString, culture, styles, out dateResult))
         Console.WriteLine("{0} converted to {1} {2}.",
                           dateString, dateResult, dateResult.Kind);
      else
         Console.WriteLine("Unable to convert {0} to a date and time.",
                           dateString);

      // Parse the same date and time with the AssumeLocal style.
      styles = DateTimeStyles.AssumeLocal;
      if (DateTime.TryParse(dateString, culture, styles, out dateResult))
         Console.WriteLine("{0} converted to {1} {2}.",
                           dateString, dateResult, dateResult.Kind);
      else
         Console.WriteLine("Unable to convert {0} to a date and time.", dateString);

      // Parse a date and time that is assumed to be local.
      // This time is five hours behind UTC. The local system's time zone is
      // eight hours behind UTC.
      dateString = "2009/03/01T10:00:00-5:00";
      styles = DateTimeStyles.AssumeLocal;
      if (DateTime.TryParse(dateString, culture, styles, out dateResult))
         Console.WriteLine("{0} converted to {1} {2}.",
                           dateString, dateResult, dateResult.Kind);
      else
         Console.WriteLine("Unable to convert {0} to a date and time.", dateString);

      // Attempt to convert a string in improper ISO 8601 format.
      dateString = "03/01/2009T10:00:00-5:00";
      if (DateTime.TryParse(dateString, culture, styles, out dateResult))
         Console.WriteLine("{0} converted to {1} {2}.",
                           dateString, dateResult, dateResult.Kind);
      else
         Console.WriteLine("Unable to convert {0} to a date and time.", dateString);

      // Assume a date and time string formatted for the fr-FR culture is the local
      // time and convert it to UTC.
      dateString = "2008-03-01 10:00";
      culture = CultureInfo.CreateSpecificCulture("fr-FR");
      styles = DateTimeStyles.AdjustToUniversal | DateTimeStyles.AssumeLocal;
      if (DateTime.TryParse(dateString, culture, styles, out dateResult))
         Console.WriteLine("{0} converted to {1} {2}.",
                           dateString, dateResult, dateResult.Kind);
      else
         Console.WriteLine("Unable to convert {0} to a date and time.", dateString);
   }
}
// The example displays the following output to the console:
//       03/01/2009 10:00 AM converted to 3/1/2009 10:00:00 AM Unspecified.
//       03/01/2009 10:00 AM converted to 3/1/2009 10:00:00 AM Local.
//       2009/03/01T10:00:00-5:00 converted to 3/1/2009 7:00:00 AM Local.
//       Unable to convert 03/01/2009T10:00:00-5:00 to a date and time.
//       2008-03-01 10:00 converted to 3/1/2008 6:00:00 PM Utc.
Imports System.Globalization

Public Module Example
   Public Sub Main()
      Dim dateString As String
      Dim culture As CultureInfo
      Dim styles As DateTimeStyles 
      Dim dateResult As DateTime
      
      ' Parse a date and time with no styles.
      dateString = "03/01/2009 10:00 AM"
      culture = CultureInfo.CreateSpecificCulture("en-US")
      styles = DateTimeStyles.None
      If DateTime.TryParse(dateString, culture, styles, dateResult) Then
         Console.WriteLine("{0} converted to {1} {2}.", _
                           dateString, dateResult, dateResult.Kind)
      Else
         Console.WriteLine("Unable to convert {0} to a date and time.", dateString)
      End If      
      
      ' Parse the same date and time with the AssumeLocal style.
      styles = DateTimeStyles.AssumeLocal
      If DateTime.TryParse(dateString, culture, styles, dateResult)
         Console.WriteLine("{0} converted to {1} {2}.", _
                           dateString, dateResult, dateResult.Kind)
      Else
         Console.WriteLine("Unable to convert {0} to a date and time.", dateString)
      End If      
      
      ' Parse a date and time that is assumed to be local.
      ' This time is five hours behind UTC. The local system's time zone is 
      ' eight hours behind UTC.
      dateString = "2009/03/01T10:00:00-5:00"
      styles = DateTimeStyles.AssumeLocal
      If DateTime.TryParse(dateString, culture, styles, dateResult)
         Console.WriteLine("{0} converted to {1} {2}.", _
                           dateString, dateResult, dateResult.Kind)
      Else
         Console.WriteLine("Unable to convert {0} to a date and time.", dateString)
      End If      
      
      ' Attempt to convert a string in improper ISO 8601 format.
      dateString = "03/01/2009T10:00:00-5:00"
      If DateTime.TryParse(dateString, culture, styles, dateResult)
         Console.WriteLine("{0} converted to {1} {2}.", _
                           dateString, dateResult, dateResult.Kind)
      Else
         Console.WriteLine("Unable to convert {0} to a date and time.", dateString)
      End If      

      ' Assume a date and time string formatted for the fr-FR culture is the local 
      ' time and convert it to UTC.
      dateString = "2008-03-01 10:00"
      culture = CultureInfo.CreateSpecificCulture("fr-FR")
      styles = DateTimeStyles.AdjustToUniversal Or DateTimeStyles.AssumeLocal
      If DateTime.TryParse(dateString, culture, styles, dateResult)
         Console.WriteLine("{0} converted to {1} {2}.", _
                           dateString, dateResult, dateResult.Kind)
      Else
         Console.WriteLine("Unable to convert {0} to a date and time.", dateString)
      End If      
   End Sub
End Module
' The example displays the following output to the console:
'       03/01/2009 10:00 AM converted to 3/1/2009 10:00:00 AM Unspecified.
'       03/01/2009 10:00 AM converted to 3/1/2009 10:00:00 AM Local.
'       2009/03/01T10:00:00-5:00 converted to 3/1/2009 7:00:00 AM Local.
'       Unable to convert 03/01/2009T10:00:00-5:00 to a date and time.
'       2008-03-01 10:00 converted to 3/1/2008 6:00:00 PM Utc.

Remarques

La DateTime.TryParse(String, IFormatProvider, DateTimeStyles, DateTime) méthode analyse une chaîne qui peut contenir des informations de date, d’heure et de fuseau horaire. Elle est semblable à la DateTime.Parse(String, IFormatProvider, DateTimeStyles) méthode, sauf que la DateTime.TryParse(String, DateTime) méthode ne lève pas d’exception en cas d’échec de la conversion.

Cette méthode tente d’ignorer les données non reconnues et de les analyser s entièrement. Si s contient une heure mais aucune date, la méthode substitue par défaut la date actuelle ou, si styles inclut l' NoCurrentDateDefault indicateur, elle remplace DateTime.Date.MinValue . Si s contient une date, mais pas de temps, 12:00 minuit est utilisé comme heure par défaut. Si une date est présente mais que son composant « année » se compose uniquement de deux chiffres, elle est convertie en année dans le provider calendrier actuel du paramètre en fonction de la valeur de la Calendar.TwoDigitYearMax propriété. Tous les caractères d’espace blanc de début, interne ou de fin s sont ignorés. La date et l’heure peuvent être placées entre des signes dièse (« # », U + 0023) et un ou plusieurs caractères NULL (U + 0000) peuvent être placés entre parenthèses.

Les formats valides spécifiques pour les éléments de date et d’heure, ainsi que les noms et symboles utilisés dans les dates et les heures, sont définis par le provider paramètre, qui peut être l’un des éléments suivants :

Si provider est null, la culture actuelle est utilisée.

Si s est la représentation sous forme de chaîne d’un jour d’une année bissextile dans le calendrier actuel, la méthode s’analyse s correctement. Si s est la représentation sous forme de chaîne d’un jour d’une année bissextile d’une année non bissextile dans le calendrier actuel de provider , l’opération d’analyse échoue et la méthode retourne false .

Le styles paramètre définit l’interprétation précise de la chaîne analysée et la manière dont l’opération d’analyse doit la gérer. Il peut s’agir d’un ou plusieurs membres de l' DateTimeStyles énumération, comme décrit dans le tableau suivant.

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 Bien que valide, cette valeur est ignorée. L’espace blanc interne est autorisé dans les éléments de date et d’heure de s .
AllowLeadingWhite Bien que valide, cette valeur est ignorée. L’espace blanc de début est autorisé dans les éléments de date et d’heure de s .
AllowTrailingWhite Bien que valide, cette valeur est ignorée. L’espace blanc de fin est autorisé dans les éléments de date et d’heure de s .
AllowWhiteSpaces Spécifie que s peut contenir des espaces blancs de début, internes et de fin. Il s'agit du comportement par défaut. Elle ne peut pas être substituée en fournissant une DateTimeStyles valeur d’énumération plus restrictive telle que DateTimeStyles.None .
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 .
None Bien que valide, cette valeur est ignorée.
RoundtripKind Pour les chaînes qui contiennent des informations de fuseau horaire, tente d’empêcher la conversion d’une chaîne de date et d’heure en une valeur dont la propriété a la valeur DateTime Kind DateTimeKind.Local . En général, une telle chaîne est créée en appelant la DateTime.ToString(String) méthode à l’aide des spécificateurs de format standard « o », « r » ou « u ».

Si s ne contient pas d’informations de fuseau horaire, la DateTime.TryParse(String, IFormatProvider, DateTimeStyles, DateTime) méthode retourne une DateTime valeur dont la propriété a la valeur, Kind DateTimeKind.Unspecified sauf si un styles indicateur indique une autre valeur. Si s comprend des informations de fuseau horaire ou de décalage de fuseau horaire, la DateTime.TryParse(String, IFormatProvider, DateTimeStyles, DateTime) méthode effectue toute conversion d’heure nécessaire et retourne l’un des éléments suivants :

Ce comportement peut être remplacé à l’aide de l' DateTimeStyles.RoundtripKind indicateur.

Analyse des cultures personnalisées

Si vous analysez une chaîne de date et d’heure générée pour une culture personnalisée, utilisez la TryParseExact méthode à la place de la TryParse méthode pour améliorer la probabilité que l’opération d’analyse aboutisse. Une chaîne de date et d’heure de culture personnalisée peut être compliquée et difficile à analyser. La TryParse méthode tente d’analyser une chaîne avec plusieurs modèles d’analyse implicite, qui peuvent tous échouer. En revanche, la TryParseExact méthode vous oblige à désigner explicitement un ou plusieurs modèles d’analyse exacts qui sont susceptibles d’être correctement exécutés.

Pour plus d’informations sur les cultures personnalisées, consultez la System.Globalization.CultureAndRegionInfoBuilder classe.

Notes pour les appelants

La mise en forme dépend des propriétés de l' DateTimeFormatInfo objet actuel, qui est fourni par le provider paramètre. La TryParse méthode peut échouer de manière inattendue et retourner False si les DateSeparator propriétés actuelles et TimeSeparator sont définies sur la même valeur.

Voir aussi

S’applique à

TryParse(ReadOnlySpan<Char>, DateTime)

Convertit l’étendue de caractères spécifiée d’une date et d’une heure en son équivalent DateTime et retourne une valeur qui indique si la conversion a réussi.

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] DateTime % result);
public static bool TryParse (ReadOnlySpan<char> s, out DateTime result);
static member TryParse : ReadOnlySpan<char> * DateTime -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As DateTime) As Boolean

Paramètres

s
ReadOnlySpan<Char>

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

result
DateTime

Quand cette méthode est retournée, contient la valeur de DateTime équivalente à la date et l'heure contenues dans s si la conversion a réussi, ou MinValue si elle a échoué. La conversion échoue si le paramètre s est null, est une chaîne vide ("") ou ne contient pas de représentation sous forme de chaîne valide d'une date et d'une heure. Ce paramètre est passé sans être initialisé.

Retours

Boolean

true si la conversion du paramètre s a réussi ; sinon, false.

S’applique à