Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo DateTime.ToString ()

 

Data di pubblicazione: ottobre 2016

Converte il valore dell'oggetto DateTime corrente nella rappresentazione di stringa equivalente, usando le convenzioni di formattazione delle impostazioni cultura.

Spazio dei nomi:   System
Assembly:  mscorlib (in mscorlib.dll)

public override string ToString()

Valore restituito

Type: System.String

Rappresentazione di stringa del valore dell'oggetto DateTime corrente.

Exception Condition
ArgumentOutOfRangeException

La data e l'ora non sono comprese nell'intervallo di date supportato dal calendario usato dalle impostazioni cultura correnti.

Il valore dell'oggetto corrente DateTime oggetto viene formattato con il data generale e l'identificatore di formato di ora ("G"). Per formattare tramite una specifica data e l'identificatore di formato di ora, chiamare il ToString(String) metodo. Per formattare usando il data generale e l'identificatore di formato di ora ("G") per una lingua specifica, chiamare il ToString(IFormatProvider) metodo. Per formattare una data specifica e identificatore di formato di ora e le convenzioni delle impostazioni cultura specifiche, chiamare il ToString(String, IFormatProvider) metodo.

Questo metodo Usa informazioni di formattazione derivate dalle impostazioni cultura correnti. In particolare, consente di combinare le stringhe di formato personalizzato restituite dal ShortDatePattern e LongTimePattern le proprietà del DateTimeFormatInfo oggetto restituito dal Thread.CurrentThread.CurrentCulture.DateTimeFormat proprietà. Per altre informazioni, vedere CultureInfo.CurrentCulture. Altri overload di ToString (metodo) consentono di specificare le impostazioni cultura da utilizzare e per definire il modello di output di cui formattazione il DateTime valore.

Note per i chiamanti:

Il ToString() restituisce la rappresentazione di stringa di data e ora di calendario utilizzato dalle impostazioni cultura correnti. Se il valore dell'oggetto corrente DateTime istanza è precedente a Calendar.MinSupportedDateTime o successivo a Calendar.MaxSupportedDateTime, il metodo genera un ArgumentOutOfRangeException. Nell'esempio seguente viene illustrato questo concetto. Tenta di formattare una data che è compreso nell'intervallo del HijriCalendar classe quando le impostazioni cultura correnti sono quelle arabe (Siria).

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      DateTime date1 = new DateTime(550, 1, 1);
      CultureInfo dft;
      CultureInfo arSY = new CultureInfo("ar-SY");
      arSY.DateTimeFormat.Calendar = new HijriCalendar();

      // Change current culture to ar-SY.
      dft = Thread.CurrentThread.CurrentCulture;
      Thread.CurrentThread.CurrentCulture = arSY;

      // Display the date using the current culture's calendar.            
      try {
         Console.WriteLine(date1.ToString());
      }
      catch (ArgumentOutOfRangeException) {
         Console.WriteLine("{0} is earlier than {1} or later than {2}", 
                           date1.ToString("d", CultureInfo.InvariantCulture), 
                           arSY.DateTimeFormat.Calendar.MinSupportedDateTime.ToString("d", CultureInfo.InvariantCulture),  
                           arSY.DateTimeFormat.Calendar.MaxSupportedDateTime.ToString("d", CultureInfo.InvariantCulture)); 
      }

      // Restore the default culture.
      Thread.CurrentThread.CurrentCulture = dft;
   }
}
// The example displays the following output:
//    01/01/0550 is earlier than 07/18/0622 or later than 12/31/9999

Nell'esempio seguente viene illustrato come rappresentazione di stringa di un DateTime valore restituito dal ToString() metodo dipende dalle impostazioni cultura correnti del thread. Vengono modificate le impostazioni cultura del thread corrente da en-US a fr-FR al ja-JP. e in ogni caso chiama il ToString() per restituire la rappresentazione di stringa di un valore di data e ora utilizzando le impostazioni cultura.

using System;
using System.Globalization;
using System.Threading;

public class DateToStringExample
{
   public static void Main()
   {
      CultureInfo currentCulture = Thread.CurrentThread.CurrentCulture;
      DateTime exampleDate = new DateTime(2008, 5, 1, 18, 32, 6);

      // Display the date using the current (en-US) culture.
      Console.WriteLine(exampleDate.ToString());

      // Change the current culture to fr-FR and display the date.
      Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("fr-FR");
      Console.WriteLine(exampleDate.ToString());

      // Change the current culture to ja-JP and display the date.
      Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("ja-JP");
      Console.WriteLine(exampleDate.ToString());

      // Restore the original culture
      Thread.CurrentThread.CurrentCulture = currentCulture;
   }
}
// The example displays the following output to the console:
//       5/1/2008 6:32:06 PM
//       01/05/2008 18:32:06
//       2008/05/01 18:32:06

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 1.1
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: