DateTime.TryParse Metodo

Definizione

Converte la rappresentazione di stringa specificata di una data e di un'ora nell'equivalente DateTime e restituisce un valore che indica se la conversione è stata eseguita correttamente.

Overload

TryParse(ReadOnlySpan<Char>, DateTime)

Converte l'intervallo di caratteri specificato di una data e di un'ora nell'equivalente DateTime e restituisce un valore che indica se la conversione è stata eseguita correttamente.

TryParse(String, DateTime)

Converte la rappresentazione di stringa specificata di una data e di un'ora nell'equivalente DateTime e restituisce un valore che indica se la conversione è stata eseguita correttamente.

TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTime)

Prova a analizzare un intervallo di caratteri in un valore.

TryParse(String, IFormatProvider, DateTime)

Prova a analizzare una stringa in un valore.

TryParse(String, IFormatProvider, DateTimeStyles, DateTime)

Converte una determinata rappresentazione di stringa di una data e di un'ora nell'equivalente DateTime usando le informazioni sul formato specifico delle impostazioni cultura e lo stile di formattazione specifici, quindi restituisce un valore che indica se la conversione è stata eseguita correttamente.

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

Converte una rappresentazione in forma di intervallo di una data e di un'ora nell'equivalente DateTime usando le informazioni sul formato specifico delle impostazioni cultura e lo stile di formattazione specifici, quindi restituisce un valore che indica se la conversione è stata eseguita correttamente.

Commenti

Importante

Le ere nel calendario giapponese sono basate sul regno dell'imperatore e pertanto è previsto che cambino. Ad esempio, il 1° maggio 2019 contraddistingue l'inizio dell'era Reiwa in JapaneseCalendar e JapaneseLunisolarCalendar. Questo cambio di era interessa tutte le applicazioni che usano questi calendari. Per altre informazioni e per determinare se le applicazioni sono interessate, vedere Gestione di una nuova era nel calendario giapponese in .NET. Per informazioni sui test delle applicazioni nei sistemi Windows per garantire la loro idoneità per la modifica dell'era, vedere Preparare l'applicazione per la modifica dell'era giapponese. Per le funzionalità di .NET che supportano calendari con più era e per le procedure consigliate quando si usano calendari che supportano più epoche, vedere Uso delle era.

TryParse(ReadOnlySpan<Char>, DateTime)

Origine:
DateTime.cs
Origine:
DateTime.cs
Origine:
DateTime.cs

Converte l'intervallo di caratteri specificato di una data e di un'ora nell'equivalente DateTime e restituisce un valore che indica se la conversione è stata eseguita correttamente.

public static bool TryParse (ReadOnlySpan<char> s, out DateTime result);

Parametri

s
ReadOnlySpan<Char>

Stringa contenente data e ora da convertire.

result
DateTime

Quando questo metodo restituisce, contiene il DateTime valore equivalente alla data e all'ora contenuta in s, se la conversione ha avuto esito positivo o DateTime.MinValue se la conversione non è riuscita. La conversione ha esito negativo se il parametro s è null, è una stringa vuota ("") o non contiene una rappresentazione di stringa di una data e di un'ora valida. Questo parametro viene passato non inizializzato.

Restituisce

true se il parametro s è stato convertito correttamente; in caso contrario, false.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

TryParse(String, DateTime)

Origine:
DateTime.cs
Origine:
DateTime.cs
Origine:
DateTime.cs

Converte la rappresentazione di stringa specificata di una data e di un'ora nell'equivalente DateTime e restituisce un valore che indica se la conversione è stata eseguita correttamente.

public static bool TryParse (string s, out DateTime result);
public static bool TryParse (string? s, out DateTime result);

Parametri

s
String

Stringa contenente data e ora da convertire.

result
DateTime

Quando questo metodo restituisce, contiene il DateTime valore equivalente alla data e all'ora contenuta in s, se la conversione ha avuto esito positivo o DateTime.MinValue se la conversione non è riuscita. La conversione ha esito negativo se il parametro s è null, è una stringa vuota ("") o non contiene una rappresentazione di stringa di una data e di un'ora valida. Questo parametro viene passato non inizializzato.

Restituisce

true se il parametro s è stato convertito correttamente; in caso contrario, false.

Esempio

L'esempio seguente passa una serie di stringhe di data e ora al DateTime.TryParse(String, DateTime) metodo.

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

Commenti

Il DateTime.TryParse(String, DateTime) metodo è simile al DateTime.Parse(String) metodo, ad eccezione del fatto che il TryParse(String, DateTime) metodo non genera un'eccezione se la conversione ha esito negativo.

La stringa s viene analizzata usando le informazioni di formattazione nell'oggetto corrente DateTimeFormatInfo , che viene fornito in modo implicito dalle impostazioni cultura correnti.

Questo metodo tenta di ignorare i dati non riconosciuti, se possibile e compila le informazioni sul mese, il giorno e l'anno mancanti con la data corrente. Se s contiene solo una data e nessuna ora, questo metodo presuppone che l'ora sia 12:00 mezzanotte. Se s include un componente di data con un anno a due cifre, viene convertito in un anno nel calendario corrente delle impostazioni cultura corrente in base al valore della Calendar.TwoDigitYearMax proprietà. Qualsiasi carattere di spazio vuoto iniziale, interno o finale in s viene ignorato. La data e l'ora possono essere racchiuse tra parentesi con una coppia di caratteri NUMERO iniziale e finale ('#', U+0023) e possono essere finali con uno o più caratteri NULL (U+0000).

Poiché il DateTime.TryParse(String, DateTime) metodo tenta di analizzare la rappresentazione stringa di una data e dell'ora usando le regole di formattazione delle impostazioni cultura correnti, il tentativo di analizzare una determinata stringa tra impostazioni cultura diverse può avere esito negativo o restituire risultati diversi. Se un formato di data e ora specifico verrà analizzato tra impostazioni locali diverse, usare il DateTime.TryParse(String, IFormatProvider, DateTimeStyles, DateTime) metodo o uno degli overload del metodo e fornire un identificatore di TryParseExact formato.

Se s è la rappresentazione di stringa di un giorno salti in un anno bisestile nel calendario corrente, il metodo analizza s correttamente. Se s è la rappresentazione di stringa di un giorno salti in un anno non bisestile nel calendario corrente delle impostazioni cultura correnti, l'operazione di analisi ha esito negativo e il metodo restituisce false.

Se s non contiene informazioni sul fuso orario, result contiene un DateTime valore la cui Kind proprietà è DateTimeKind.Unspecified quando il metodo restituisce. Se la stringa da analizzare contiene informazioni sul fuso orario, result contiene un DateTime valore la cui Kind proprietà è DateTimeKind.Local quando il metodo restituisce.

Note per i chiamanti

La formattazione è influenzata dalle proprietà dell'oggetto corrente DateTimeFormatInfo , che per impostazione predefinita vengono derivate dall'elemento Opzioni internazionali e linguistiche nel Pannello di controllo. Il TryParse metodo può non riuscire in modo imprevisto e restituire False se le proprietà correnti DateSeparator e TimeSeparator sono impostate sullo stesso valore.

Vedi anche

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTime)

Origine:
DateTime.cs
Origine:
DateTime.cs
Origine:
DateTime.cs

Prova a analizzare un intervallo di caratteri in un valore.

public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out DateTime result);

Parametri

s
ReadOnlySpan<Char>

Intervallo di caratteri da analizzare.

provider
IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura relative a s.

result
DateTime

Quando questo metodo restituisce, contiene il risultato dell'analisi sdi o un valore non definito in caso di errore.

Restituisce

true se è stato analizzato correttamente; in caso s contrario, false.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 7, 8, 9

TryParse(String, IFormatProvider, DateTime)

Origine:
DateTime.cs
Origine:
DateTime.cs
Origine:
DateTime.cs

Prova a analizzare una stringa in un valore.

public static bool TryParse (string? s, IFormatProvider? provider, out DateTime result);

Parametri

s
String

Stringa da analizzare.

provider
IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura relative a s.

result
DateTime

Quando questo metodo restituisce, contiene il risultato dell'analisi s corretta o di un valore non definito in caso di errore.

Restituisce

true se è stato analizzato correttamente; in caso s contrario, false.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 7, 8, 9

TryParse(String, IFormatProvider, DateTimeStyles, DateTime)

Origine:
DateTime.cs
Origine:
DateTime.cs
Origine:
DateTime.cs

Converte una determinata rappresentazione di stringa di una data e di un'ora nell'equivalente DateTime usando le informazioni sul formato specifico delle impostazioni cultura e lo stile di formattazione specifici, quindi restituisce un valore che indica se la conversione è stata eseguita correttamente.

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

Parametri

s
String

Stringa contenente data e ora da convertire.

provider
IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura relativamente a s.

styles
DateTimeStyles

Combinazione bit per bit dei valori di enumerazione che definisce il modo di interpretare la data analizzata in relazione al fuso orario o alla data corrente. Un valore tipico da specificare è None.

result
DateTime

Quando questo metodo restituisce, contiene il DateTime valore equivalente alla data e all'ora contenuta in s, se la conversione ha avuto esito positivo o DateTime.MinValue se la conversione non è riuscita. La conversione ha esito negativo se il parametro s è null, è una stringa vuota ("") o non contiene una rappresentazione di stringa di una data e di un'ora valida. Questo parametro viene passato non inizializzato.

Restituisce

true se il parametro s è stato convertito correttamente; in caso contrario, false.

Eccezioni

styles non è un valore valido di DateTimeStyles.

-oppure-

styles contiene una combinazione non valida di valori di DateTimeStyles, ad esempio sia AssumeLocal che AssumeUniversal.

provider rappresenta impostazioni cultura non associate ad alcun paese e non può essere usato in un'operazione di analisi.

Esempio

Nell'esempio seguente viene illustrato il DateTime.TryParse(String, IFormatProvider, DateTimeStyles, DateTime) metodo .

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.

Commenti

Per altre informazioni su questa API, vedere Osservazioni api supplementari per DateTime.TryParse.

Note per i chiamanti

La formattazione è influenzata dalle proprietà dell'oggetto corrente DateTimeFormatInfo , fornito dal provider parametro . Il TryParse metodo può non riuscire in modo imprevisto e restituire False se le proprietà correnti DateSeparator e TimeSeparator sono impostate sullo stesso valore.

Vedi anche

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Origine:
DateTime.cs
Origine:
DateTime.cs
Origine:
DateTime.cs

Converte una rappresentazione in forma di intervallo di una data e di un'ora nell'equivalente DateTime usando le informazioni sul formato specifico delle impostazioni cultura e lo stile di formattazione specifici, quindi restituisce un valore che indica se la conversione è stata eseguita correttamente.

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

Parametri

s
ReadOnlySpan<Char>

Intervallo contenente i caratteri che rappresentano la data e l'ora da convertire.

provider
IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura relativamente a s.

styles
DateTimeStyles

Combinazione bit per bit dei valori di enumerazione che definisce il modo di interpretare la data analizzata in relazione al fuso orario o alla data corrente. Un valore tipico da specificare è None.

result
DateTime

Quando questo metodo restituisce, contiene il DateTime valore equivalente alla data e all'ora contenuta in s, se la conversione ha avuto esito positivo o DateTime.MinValue se la conversione non è riuscita. La conversione ha esito negativo se il parametro s è null, è una stringa vuota ("") o non contiene una rappresentazione di stringa di una data e di un'ora valida. Questo parametro viene passato non inizializzato.

Restituisce

true se il parametro s è stato convertito correttamente; in caso contrario, false.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1