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 (String)

 

Data di pubblicazione: ottobre 2016

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

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

public string ToString(
	string format
)

Parametri

format
Type: System.String

Stringa di formato di data e ora standard o personalizzato (vedere la sezione Note).

Valore restituito

Type: System.String

Rappresentazione di stringa del valore dell'oggetto DateTime corrente, come specificato da format.

Exception Condition
FormatException

La lunghezza di format è 1 e non è uno dei caratteri identificatori di formato definiti per DateTimeFormatInfo.

-oppure-

format non contiene un modello di formato personalizzato valido.

ArgumentOutOfRangeException

La data e l'ora sono esterni all'intervallo di date supportato dal calendario utilizzato dalle impostazioni di cultura correnti.

Il ToString(String) metodo restituisce la rappresentazione di stringa di un valore di data e ora in un formato specifico che utilizza le convenzioni di formattazione delle impostazioni cultura correnti; per ulteriori informazioni, vedere CultureInfo.CurrentCulture.

Il format parametro deve contenere un carattere identificatore di formato singolo (vedere Stringhe di formato di data e ora standard) o un modello di formato personalizzato (vedere Stringhe di formato di data e ora personalizzato) che definisce il formato della stringa restituita. Se format è null o una stringa vuota, l'identificatore di formato generale "G", viene utilizzata.

Alcuni utilizzi di questo metodo includono:

  • Ottiene una stringa che visualizza la data e l'ora in formato data breve le impostazioni cultura correnti e ora. A tale scopo, utilizzare l'identificatore di formato "G".

  • Ottiene una stringa che contiene solo il mese e anno. A tale scopo, utilizzare la stringa di formato "MM/aaaa". La stringa di formato Usa separatore della data di impostazioni cultura correnti.

  • Ottiene una stringa che contiene la data e l'ora in un formato specifico. Ad esempio, il "MM/GG/yyyyHH:mm" stringa di formato visualizza la stringa di data e ora in un formato fisso ad esempio "19 2013 / / 03 / / 18:06". Utilizza la stringa di formato "/" come separatore di data fissa indipendentemente dalle impostazioni cultura.

  • Recupero di una data in formato ridotto che può essere utilizzato per la serializzazione di una stringa di Data. Ad esempio, la stringa di formato "aaaammgg" Visualizza un anno a quattro cifre seguito da un mese a due cifre e giorno a due cifre con nessun separatore della data.

L'esempio seguente Usa queste tre stringhe di formato per visualizzare un valore di data e ora usando le convenzioni delle impostazioni cultura en-US e fr-FR.

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

public class Example
{
   public static void Main()
   {
      String[] formats = { "G", "MM/yyyy", @"MM\/dd\/yyyy HH:mm",
                           "yyyyMMdd" };
      String[] cultureNames = { "en-US", "fr-FR" };
      DateTime date = new DateTime(2015, 8, 18, 13, 31, 17);
      foreach (var cultureName in cultureNames) {
         var culture = new CultureInfo(cultureName);
         CultureInfo.CurrentCulture = culture;
         Console.WriteLine(culture.NativeName);
         foreach (var format in formats)
            Console.WriteLine("   {0}: {1}", format,
                              date.ToString(format));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       English (United States)
//          G: 8/18/2015 1:31:17 PM
//          MM/yyyy: 08/2015
//          MM\/dd\/yyyy HH:mm: 08/18/2015 13:31
//          yyyyMMdd: 20150818
//
//       français (France)
//          G: 18/08/2015 13:31:17
//          MM/yyyy: 08/2015
//          MM\/dd\/yyyy HH:mm: 08/18/2015 13:31
//          yyyyMMdd: 20150818

Note per i chiamanti:

Il ToString(String) 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 HebrewCalendar classe quando le impostazioni cultura correnti sono ebraico (Israele).

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

public class Example
{
   public static void Main()
   {
      DateTime date1 = new DateTime(1550, 7, 21);
      CultureInfo dft;
      CultureInfo heIL = new CultureInfo("he-IL");
      heIL.DateTimeFormat.Calendar = new HebrewCalendar();

      // Change current culture to he-IL.
      dft = Thread.CurrentThread.CurrentCulture;
      Thread.CurrentThread.CurrentCulture = heIL;

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

      // Restore the default culture.
      Thread.CurrentThread.CurrentCulture = dft;
   }
}
// The example displays the following output:
//    07/21/1550 is earlier than 01/01/1583 or later than 09/29/2239

Nell'esempio seguente viene utilizzata ciascuna delle stringhe di formato di ora e data standard e selezione di date personalizzato e stringhe di formato di ora per visualizzare la rappresentazione di stringa di un DateTime valore. Impostazioni cultura del thread corrente per l'esempio sono en-US.

using System;

public class DateToStringExample
{
   public static void Main()
   {
      DateTime dateValue = new DateTime(2008, 6, 15, 21, 15, 07);
      // Create an array of standard format strings.
      string[] standardFmts = {"d", "D", "f", "F", "g", "G", "m", "o", 
                               "R", "s", "t", "T", "u", "U", "y"};
      // Output date and time using each standard format string.
      foreach (string standardFmt in standardFmts)
         Console.WriteLine("{0}: {1}", standardFmt, 
                           dateValue.ToString(standardFmt));
      Console.WriteLine();

      // Create an array of some custom format strings.
      string[] customFmts = {"h:mm:ss.ff t", "d MMM yyyy", "HH:mm:ss.f", 
                             "dd MMM HH:mm:ss", @"\Mon\t\h\: M", "HH:mm:ss.ffffzzz" };
      // Output date and time using each custom format string.
      foreach (string customFmt in customFmts)
         Console.WriteLine("'{0}': {1}", customFmt,
                           dateValue.ToString(customFmt));
   }
}
// This example displays the following output to the console:
//       d: 6/15/2008
//       D: Sunday, June 15, 2008
//       f: Sunday, June 15, 2008 9:15 PM
//       F: Sunday, June 15, 2008 9:15:07 PM
//       g: 6/15/2008 9:15 PM
//       G: 6/15/2008 9:15:07 PM
//       m: June 15
//       o: 2008-06-15T21:15:07.0000000
//       R: Sun, 15 Jun 2008 21:15:07 GMT
//       s: 2008-06-15T21:15:07
//       t: 9:15 PM
//       T: 9:15:07 PM
//       u: 2008-06-15 21:15:07Z
//       U: Monday, June 16, 2008 4:15:07 AM
//       y: June, 2008
//       
//       'h:mm:ss.ff t': 9:15:07.00 P
//       'd MMM yyyy': 15 Jun 2008
//       'HH:mm:ss.f': 21:15:07.0
//       'dd MMM HH:mm:ss': 15 Jun 21:15:07
//       '\Mon\t\h\: M': Month: 6
//       'HH:mm:ss.ffffzzz': 21:15:07.0000-07:00

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: