Stringhe di formato di data e ora standardStandard Date and Time Format Strings

Una stringa di formato data e ora standard usa un singolo identificatore di formato per definire la rappresentazione di testo di un valore di data e ora.A standard date and time format string uses a single format specifier to define the text representation of a date and time value. Qualsiasi stringa di formato data e ora contenente più di un carattere, inclusi gli spazi, viene interpretata come una stringa di formato data e ora personalizzata. Per altre informazioni, vedere Stringhe di formato di data e ora personalizzato.Any date and time format string that contains more than one character, including white space, is interpreted as a custom date and time format string; for more information, see Custom Date and Time Format Strings. Una stringa di formato standard o personalizzata può essere usata in due modi:A standard or custom format string can be used in two ways:

  • Per definire la stringa risultante da un'operazione di formattazione.To define the string that results from a formatting operation.

  • Per definire la rappresentazione di testo di un valore di data e ora che può essere convertito in un valore DateTime o DateTimeOffset da un'operazione di analisi.To define the text representation of a date and time value that can be converted to a DateTime or DateTimeOffset value by a parsing operation.

Suggerimento

È possibile scaricare l'utilità di formattazione, un'applicazione .NET Core Windows Forms che consente di applicare stringhe di formato a valori numerici o di data e ora e di visualizzare la stringa di risultato.You can download the Formatting Utility, a .NET Core Windows Forms application that lets you apply format strings to either numeric or date and time values and displays the result string. Il codice sorgente è disponibile per C# e Visual Basic.Source code is available for C# and Visual Basic.

Le stringhe di formato data e ora standard possono essere usate con i valori DateTime e DateTimeOffset.Standard date and time format strings can be used with both DateTime and DateTimeOffset values.

Nota

Alcuni degli esempi in C# in questo articolo vengono eseguiti nello strumento di esecuzione e playground per codice inline Try.NET.Some of the C# examples in this article run in the Try.NET inline code runner and playground. Selezionare il pulsante Esegui per eseguire un esempio in una finestra interattiva.Select the Run button to run an example in an interactive window. Dopo aver eseguito il codice, è possibile modificarlo ed eseguire il codice modificato selezionando di nuovo Esegui.Once you execute the code, you can modify it and run the modified code by selecting Run again. Il codice modificato viene eseguito nella finestra interattiva o, se la compilazione non riesce, la finestra interattiva visualizza tutti i messaggi di errore del compilatore C#.The modified code either runs in the interactive window or, if compilation fails, the interactive window displays all C# compiler error messages.

Il fuso orario locale dello strumento di esecuzione e playground per codice inline Try.NET è Coordinated Universal Time o ora UTC.The local time zone of the Try.NET inline code runner and playground is Coordinated Universal Time, or UTC. Ciò può influire sul comportamento e l'output degli esempi che illustrano i tipi DateTime, DateTimeOffset e TimeZoneInfo e i relativi membri.This may affect the behavior and the output of examples that illustrate the DateTime, DateTimeOffset, and TimeZoneInfo types and their members.

Nella tabella seguente vengono descritti gli identificatori di formato di data e ora standard.The following table describes the standard date and time format specifiers. Se non specificato diversamente, un identificatore di formato di data e ora standard specifico genera una rappresentazione di stringa identica, indipendentemente dal fatto che venga usato con un valore DateTime o con un valore DateTimeOffset.Unless otherwise noted, a particular standard date and time format specifier produces an identical string representation regardless of whether it is used with a DateTime or a DateTimeOffset value. Per altre informazioni sull'uso di stringhe di formato di data e ora standard, vedere la sezione Note.See the Notes section for additional information about using standard date and time format strings.

Identificatore di formatoFormat specifier DescriptionDescription EsempiExamples
"d""d" Schema di data breve.Short date pattern.

Altre informazioni: Identificatore di formato di data breve ("d").More information:The Short Date ("d") Format Specifier.
2009-06-15T13:45:30 -> 6/15/2009 (en-US)2009-06-15T13:45:30 -> 6/15/2009 (en-US)

2009-06-15T13:45:30 -> 15/06/2009 (fr-FR)2009-06-15T13:45:30 -> 15/06/2009 (fr-FR)

2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D""D" Schema di data estesa.Long date pattern.

Altre informazioni: Identificatore di formato di data estesa ("D").More information:The Long Date ("D") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US)2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US)

2009-06-15T13:45:30 -> 15 июня 2009 г.2009-06-15T13:45:30 -> 15 июня 2009 г. (ru-RU)(ru-RU)

2009-06-15T13:45:30 -> Montag, 15.2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)Juni 2009 (de-DE)
"f""f" Schema di data/ora completa (ora breve).Full date/time pattern (short time).

Altre informazioni: Identificatore di formato di ora breve e data completa ("f").More information: The Full Date Short Time ("f") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45 PM (en-US)2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45 PM (en-US)

2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE)2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F""F" Schema di data/ora completa (ora estesa).Full date/time pattern (long time).

Altre informazioni: Identificatore di formato di ora estesa e data completa ("F").More information: The Full Date Long Time ("F") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (en-US)2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (en-US)

2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE)2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g""g" Schema di data/ora generale (ora breve).General date/time pattern (short time).

Altre informazioni: Identificatore di formato di ora breve e data generale ("g").More information: The General Date Short Time ("g") Format Specifier.
2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en-US)2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en-US)

2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES)2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES)

2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G""G" Schema di data/ora generale (ora estesa).General date/time pattern (long time).

Altre informazioni: Identificatore di formato di ora estesa e data generale ("G").More information: The General Date Long Time ("G") Format Specifier.
2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US)2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US)

2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES)2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES)

2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m""M", "m" Schema di mese/giorno.Month/day pattern.

Altre informazioni: Identificatore di formato di mese ("M", "m").More information: The Month ("M", "m") Format Specifier.
2009-06-15T13:45:30 -> June 15 (en-US)2009-06-15T13:45:30 -> June 15 (en-US)

2009-06-15T13:45:30 -> 15.2009-06-15T13:45:30 -> 15. juni (da-DK)juni (da-DK)

2009-06-15T13:45:30 -> 15 Juni (id-ID)2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o""O", "o" Schema di data/ora di round trip.Round-trip date/time pattern.

Altre informazioni: Identificatore di formato di round trip ("O", "o").More information: The Round-trip ("O", "o") Format Specifier.
Valori DateTime:DateTime values:

2009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.0000000-07:002009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.0000000-07:00

2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z

2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.00000002009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000

Valori DateTimeOffset:DateTimeOffset values:

2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:002009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00
"R", "r""R", "r" Schema RFC1123.RFC1123 pattern.

Altre informazioni: Identificatore di formato RFC1123 ("R", "r").More information: The RFC1123 ("R", "r") Format Specifier.
2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT
"s""s" Schema di data/ora ordinabile.Sortable date/time pattern.

Altre informazioni: Identificatore di formato ordinabile ("s").More information: The Sortable ("s") Format Specifier.
2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:302009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30

2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:302009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30
"t""t" Schema di ora breve.Short time pattern.

Altre informazioni: Identificatore di formato di ora breve ("t").More information: The Short Time ("t") Format Specifier.
2009-06-15T13:45:30 -> 1:45 PM (en-US)2009-06-15T13:45:30 -> 1:45 PM (en-US)

2009-06-15T13:45:30 -> 13:45 (hr-HR)2009-06-15T13:45:30 -> 13:45 (hr-HR)

2009-06-15T13:45:30 -> 01:45 م (ar-EG)2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T""T" Schema di ora estesa.Long time pattern.

Altre informazioni: Identificatore di formato di ora estesa ("T").More information: The Long Time ("T") Format Specifier.
2009-06-15T13:45:30 -> 1:45:30 PM (en-US)2009-06-15T13:45:30 -> 1:45:30 PM (en-US)

2009-06-15T13:45:30 -> 13:45:30 (hr-HR)2009-06-15T13:45:30 -> 13:45:30 (hr-HR)

2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u""u" Schema di data/ora ordinabile universale.Universal sortable date/time pattern.

Altre informazioni: Identificatore di formato ordinabile universale ("u").More information: The Universal Sortable ("u") Format Specifier.
Con un valore DateTime: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30ZWith a DateTime value: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z

Con un valore DateTimeOffset: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30ZWith a DateTimeOffset value: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U""U" Schema di data/ora completa universale.Universal full date/time pattern.

Altre informazioni: Identificatore di formato completo universale ("U").More information: The Universal Full ("U") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 8:45:30 PM (en-US)2009-06-15T13:45:30 -> Monday, June 15, 2009 8:45:30 PM (en-US)

2009-06-15T13:45:30 -> den 15 juni 2009 20:45:30 (sv-SE)2009-06-15T13:45:30 -> den 15 juni 2009 20:45:30 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)
"Y", "y""Y", "y" Schema di mese e anno.Year month pattern.

Altre informazioni: Identificatore di formato di mese e anno ("Y").More information: The Year Month ("Y") Format Specifier.
2009-06-15T13:45:30 -> June, 2009 (en-US)2009-06-15T13:45:30 -> June, 2009 (en-US)

2009-06-15T13:45:30 -> juni 2009 (da-DK)2009-06-15T13:45:30 -> juni 2009 (da-DK)

2009-06-15T13:45:30 -> Juni 2009 (id-ID)2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Qualsiasi altro carattere singoloAny other single character Identificatore sconosciuto.Unknown specifier. Genera un evento FormatException in fase di esecuzione.Throws a run-time FormatException.

Funzionamento delle stringhe di formato standardHow Standard Format Strings Work

In un'operazione di formattazione, una stringa di formato standard è semplicemente un alias per una stringa di formato personalizzata.In a formatting operation, a standard format string is simply an alias for a custom format string. Il vantaggio dell'uso di un alias per fare riferimento a una stringa di formato personalizzata consiste nel fatto che, sebbene l'alias sia invariante, la stringa di formato personalizzata può variare.The advantage of using an alias to refer to a custom format string is that, although the alias remains invariant, the custom format string itself can vary. Questo aspetto è importante perché le rappresentazioni di stringa di valori di data e ora variano in genere in base alle impostazioni cultura.This is important because the string representations of date and time values typically vary by culture. La stringa di formato standard "d" indica, ad esempio, che un valore di data e ora deve essere visualizzato usando uno schema di data breve.For example, the "d" standard format string indicates that a date and time value is to be displayed using a short date pattern. Per le impostazioni cultura invarianti questo schema è "MM/dd/yyyy".For the invariant culture, this pattern is "MM/dd/yyyy". Per le impostazioni cultura fr-FR questo schema è "dd/MM/yyyy".For the fr-FR culture, it is "dd/MM/yyyy". Per le impostazioni cultura ja-JP questo schema è "yyyy/MM/dd".For the ja-JP culture, it is "yyyy/MM/dd".

Se in un'operazione di formattazione viene eseguito il mapping di una stringa di formato standard alla stringa di formato personalizzata di impostazioni cultura particolari, nell'applicazione possono essere definite le impostazioni cultura specifiche le cui stringhe di formato personalizzate vengono usate in una di queste modalità:If a standard format string in a formatting operation maps to a particular culture's custom format string, your application can define the specific culture whose custom format strings are used in one of these ways:

  • È possibile usare le impostazioni cultura predefinite, o correnti.You can use the default (or current) culture. Nell'esempio seguente viene visualizzata una data usando il formato di data breve delle impostazioni cultura correnti.The following example displays a date using the current culture's short date format. In questo caso le impostazioni cultura correnti sono en-US.In this case, the current culture is en-US.

    // Display using current (en-us) culture's short date format
    DateTime thisDate = new DateTime(2008, 3, 15);
    Console.WriteLine(thisDate.ToString("d"));           // Displays 3/15/2008
    
    ' Display using current (en-us) culture's short date format
    Dim thisDate As Date = #03/15/2008#
    Console.WriteLine(thisDate.ToString("d"))     ' Displays 3/15/2008
    
  • È possibile passare un oggetto CultureInfo che rappresenta le impostazioni cultura di cui deve essere usata la formattazione a un metodo con un parametro IFormatProvider.You can pass a CultureInfo object representing the culture whose formatting is to be used to a method that has an IFormatProvider parameter. Nell'esempio seguente viene visualizzata una data usando il formato di data breve delle impostazioni cultura pt-BR.The following example displays a date using the short date format of the pt-BR culture.

    // Display using pt-BR culture's short date format
    DateTime thisDate = new DateTime(2008, 3, 15);
    CultureInfo culture = new CultureInfo("pt-BR");      
    Console.WriteLine(thisDate.ToString("d", culture));  // Displays 15/3/2008
    
    ' Display using pt-BR culture's short date format
    Dim thisDate As Date = #03/15/2008#
    Dim culture As New CultureInfo("pt-BR")      
    Console.WriteLine(thisDate.ToString("d", culture))   ' Displays 15/3/2008
    
  • È possibile passare un oggetto DateTimeFormatInfo che fornisce informazioni di formattazione a un metodo con un parametro IFormatProvider.You can pass a DateTimeFormatInfo object that provides formatting information to a method that has an IFormatProvider parameter. Nell'esempio seguente viene visualizzata una data usndo il formato di data breve da un oggetto DateTimeFormatInfo per le impostazioni cultura hr-HR.The following example displays a date using the short date format from a DateTimeFormatInfo object for the hr-HR culture.

    // Display using date format information from hr-HR culture
    DateTime thisDate = new DateTime(2008, 3, 15);
    DateTimeFormatInfo fmt = (new CultureInfo("hr-HR")).DateTimeFormat;
    Console.WriteLine(thisDate.ToString("d", fmt));      // Displays 15.3.2008
    
    ' Display using date format information from hr-HR culture
    Dim thisDate As Date = #03/15/2008#
    Dim fmt As DateTimeFormatInfo = (New CultureInfo("hr-HR")).DateTimeFormat
    Console.WriteLine(thisDate.ToString("d", fmt))   ' Displays 15.3.2008
    

Nota

Per informazioni sulla personalizzazione delle stringhe o dei modelli usati nella formattazione di data e ora, vedere l'argomento relativo alla classe NumberFormatInfo.For information about customizing the patterns or strings used in formatting date and time values, see the NumberFormatInfo class topic.

In alcuni casi la stringa di formato standard serve come una pratica abbreviazione per una stringa di formato personalizzata più lunga, che è invariante.In some cases, the standard format string serves as a convenient abbreviation for a longer custom format string that is invariant. In questa categoria rientrano quattro stringhe di formato standard: "O" (o "o"), "R" (o "r"), "s" e "u".Four standard format strings fall into this category: "O" (or "o"), "R" (or "r"), "s", and "u". Queste stringhe corrispondono a stringhe di formato personalizzate definite dalle impostazioni cultura invarianti.These strings correspond to custom format strings defined by the invariant culture. Producono rappresentazioni di stringa di valori di data e ora che dovranno essere identiche nelle diverse impostazioni cultura.They produce string representations of date and time values that are intended to be identical across cultures. Nella tabella seguente vengono fornite informazioni su queste quattro stringhe di formato di data e ora standard.The following table provides information on these four standard date and time format strings.

Stringa di formato standardStandard format string Definita dalla proprietà DateTimeFormatInfo.InvariantInfoDefined by DateTimeFormatInfo.InvariantInfo property Stringa di formato personalizzataCustom format string
"O" o "o""O" or "o" nessunoNone yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzyyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzz
"R" o "r""R" or "r" RFC1123Pattern ddd, dd MMM yyyy HH':'mm':'ss 'GMT'ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s""s" SortableDateTimePattern yyyy'-'MM'-'dd'T'HH':'mm':'ssyyyy'-'MM'-'dd'T'HH':'mm':'ss
"u""u" UniversalSortableDateTimePattern yyyy'-'MM'-'dd HH':'mm':'ss'Z'yyyy'-'MM'-'dd HH':'mm':'ss'Z'

Le stringhe di formato standard possono anche essere usate nelle operazioni di analisi con i metodi DateTime.ParseExact o DateTimeOffset.ParseExact, che richiedono che una stringa di input sia esattamente conforme a un modello specifico affinché l'operazione di analisi abbia esito positivo.Standard format strings can also be used in parsing operations with the DateTime.ParseExact or DateTimeOffset.ParseExact methods, which require an input string to exactly conform to a particular pattern for the parse operation to succeed. Poiché viene eseguito il mapping di molte stringhe di formato standard a più stringhe di formato personalizzate, un valore di data e ora può essere rappresentato in diversi formati ma l'operazione di analisi verrà tuttavia eseguita correttamente.Many standard format strings map to multiple custom format strings, so a date and time value can be represented in a variety of formats and the parse operation will still succeed. È possibile determinare la stringa o le stringhe di formato personalizzate che corrispondono a una stringa di formato standard chiamando il metodo DateTimeFormatInfo.GetAllDateTimePatterns(Char).You can determine the custom format string or strings that correspond to a standard format string by calling the DateTimeFormatInfo.GetAllDateTimePatterns(Char) method. Nell'esempio seguente vengono visualizzate le stringhe di formato personalizzate che eseguono il mapping alla stringa di formato standard "d" (modello di data breve).The following example displays the custom format strings that map to the "d" (short date pattern) standard format string.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("'d' standard format string:");
      foreach (var customString in DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns('d'))
          Console.WriteLine("   {0}", customString);
   }
}
// The example displays the following output:
//       'd' standard format string:
//          M/d/yyyy
//          M/d/yy
//          MM/dd/yy
//          MM/dd/yyyy
//          yy/MM/dd
//          yyyy-MM-dd
//          dd-MMM-yy
Imports System.Globalization

Module Example
   Public Sub Main()
      Console.WriteLine("'d' standard format string:")
      For Each customString In DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns("d"c)
          Console.WriteLine("   {0}", customString)
      Next                                  
   End Sub
End Module
' The example displays the following output:
'    'd' standard format string:
'       M/d/yyyy
'       M/d/yy
'       MM/dd/yy
'       MM/dd/yyyy
'       yy/MM/dd
'       yyyy-MM-dd
'       dd-MMM-yy

Nelle sezioni seguenti vengono descritti gli identificatori di formato standard per i valori DateTime e DateTimeOffset.The following sections describe the standard format specifiers for DateTime and DateTimeOffset values.

Identificatore di formato di data breve ("d")The Short Date ("d") Format Specifier

L'identificatore di formato standard "d" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.ShortDatePattern di impostazioni cultura specifiche.The "d" standard format specifier represents a custom date and time format string that is defined by a specific culture's DateTimeFormatInfo.ShortDatePattern property. La stringa di formato personalizzata restituita dalla proprietà ShortDatePattern della lingua inglese è, ad esempio, "MM/dd/yyyy".For example, the custom format string that is returned by the ShortDatePattern property of the invariant culture is "MM/dd/yyyy".

Nella tabella seguente sono elencate le proprietà dell'oggetto DateTimeFormatInfo che consentono di controllare la formattazione della stringa restituita.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

ProprietàProperty DESCRIZIONEDescription
ShortDatePattern Definisce il formato complessivo della stringa di risultato.Defines the overall format of the result string.
DateSeparator Definisce la stringa che separa i componenti relativi ad anno, mese e giorno di una data.Defines the string that separates the year, month, and day components of a date.

Nell'esempio seguente viene usato l'identificatore di formato "d" per visualizzare un valore di data e ora.The following example uses the "d" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008,4, 10);
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008
Console.WriteLine(date1.ToString("d", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays 4/10/2008                       
Console.WriteLine(date1.ToString("d", 
                  CultureInfo.CreateSpecificCulture("en-NZ")));
// Displays 10/04/2008                       
Console.WriteLine(date1.ToString("d", 
                  CultureInfo.CreateSpecificCulture("de-DE")));
// Displays 10.04.2008                       
Dim date1 As Date = #4/10/2008#
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays 4/10/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-NZ")))
' Displays 10/04/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("de-DE")))
' Displays 10.04.2008                       

Torna alla tabellaBack to table

Identificatore di formato di data estesa ("D")The Long Date ("D") Format Specifier

L'identificatore di formato standard "D" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.LongDatePattern corrente.The "D" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.LongDatePattern property. La stringa di formato personalizzata per le impostazioni cultura invarianti ad esempio è "dddd, dd MMMM yyyy".For example, the custom format string for the invariant culture is "dddd, dd MMMM yyyy".

Nella tabella seguente sono elencate le proprietà dell'oggetto DateTimeFormatInfo che consentono di controllare la formattazione della stringa restituita.The following table lists the properties of the DateTimeFormatInfo object that control the formatting of the returned string.

ProprietàProperty DESCRIZIONEDescription
LongDatePattern Definisce il formato complessivo della stringa di risultato.Defines the overall format of the result string.
DayNames Definisce i nomi dei giorni localizzati che possono essere visualizzati nella stringa di risultato.Defines the localized day names that can appear in the result string.
MonthNames Definisce i nomi dei mesi localizzati che possono essere visualizzati nella stringa di risultato.Defines the localized month names that can appear in the result string.

Nell'esempio seguente viene usato l'identificatore di formato "D" per visualizzare un valore di data e ora.The following example uses the "D" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10);
Console.WriteLine(date1.ToString("D", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008                        
Console.WriteLine(date1.ToString("D", 
                  CultureInfo.CreateSpecificCulture("pt-BR")));
// Displays quinta-feira, 10 de abril de 2008                        
Console.WriteLine(date1.ToString("D", 
                  CultureInfo.CreateSpecificCulture("es-MX")));
// Displays jueves, 10 de abril de 2008                        
Dim date1 As Date = #4/10/2008#
Console.WriteLine(date1.ToString("D", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008                        
Console.WriteLine(date1.ToString("D", _
                  CultureInfo.CreateSpecificCulture("pt-BR")))
' Displays quinta-feira, 10 de abril de 2008                        
Console.WriteLine(date1.ToString("D", _
                  CultureInfo.CreateSpecificCulture("es-MX")))
' Displays jueves, 10 de abril de 2008                        

Torna alla tabellaBack to table

Identificatore di formato di ora breve e data completa ("f")The Full Date Short Time ("f") Format Specifier

L'identificatore di formato standard "f" rappresenta una combinazione degli schemi di data estesa ("D") e ora breve ("t"), separati da uno spazio.The "f" standard format specifier represents a combination of the long date ("D") and short time ("t") patterns, separated by a space.

La stringa di risultato è influenzata dalle informazioni sulla formattazione di un oggetto DateTimeFormatInfo specifico.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. Nella tabella seguente sono elencate le proprietà dell'oggetto DateTimeFormatInfo che consentono di controllare la formattazione della stringa restituita.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. L'identificatore di formato personalizzato restituito dalle proprietà DateTimeFormatInfo.LongDatePattern e DateTimeFormatInfo.ShortTimePattern di alcune impostazioni cultura potrebbe non prevedere l'uso di tutte le proprietà.The custom format specifier returned by the DateTimeFormatInfo.LongDatePattern and DateTimeFormatInfo.ShortTimePattern properties of some cultures may not make use of all properties.

ProprietàProperty DESCRIZIONEDescription
LongDatePattern Definisce il formato del componente relativo alla data della stringa di risultato.Defines the format of the date component of the result string.
ShortTimePattern Definisce il formato del componente relativo all'ora della stringa di risultato.Defines the format of the time component of the result string.
DayNames Definisce i nomi dei giorni localizzati che possono essere visualizzati nella stringa di risultato.Defines the localized day names that can appear in the result string.
MonthNames Definisce i nomi dei mesi localizzati che possono essere visualizzati nella stringa di risultato.Defines the localized month names that can appear in the result string.
TimeSeparator Definisce la stringa che separa i componenti relativi a ora, minuti e secondi di un orario.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definisce la stringa che indica le ore da mezzanotte a prima di mezzogiorno in un orario in formato 12 ore.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definisce la stringa che indica le ore da mezzogiorno a prima di mezzanotte in un orario in formato 12 ore.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Nell'esempio seguente viene usato l'identificatore di formato "f" per visualizzare un valore di data e ora.The following example uses the "f" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("f", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 6:30 AM                        
Console.WriteLine(date1.ToString("f", 
                  CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays jeudi 10 avril 2008 06:30                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("f", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 6:30 AM                        
Console.WriteLine(date1.ToString("f", _
                  CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays jeudi 10 avril 2008 06:30                       

Torna alla tabellaBack to table

Identificatore di formato di ora estesa e data completa ("F")The Full Date Long Time ("F") Format Specifier

L'identificatore di formato standard "F" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.FullDateTimePattern corrente.The "F" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.FullDateTimePattern property. La stringa di formato personalizzata per le impostazioni cultura invarianti ad esempio è "dddd, dd MMMM yyyy HH:mm:ss".For example, the custom format string for the invariant culture is "dddd, dd MMMM yyyy HH:mm:ss".

Nella tabella seguente sono elencate le proprietà dell'oggetto DateTimeFormatInfo che consentono di controllare la formattazione della stringa restituita.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. L'identificatore di formato personalizzato restituito dalla proprietà FullDateTimePattern di alcune impostazioni cultura potrebbe non prevedere l'uso di tutte le proprietà.The custom format specifier that is returned by the FullDateTimePattern property of some cultures may not make use of all properties.

ProprietàProperty DESCRIZIONEDescription
FullDateTimePattern Definisce il formato complessivo della stringa di risultato.Defines the overall format of the result string.
DayNames Definisce i nomi dei giorni localizzati che possono essere visualizzati nella stringa di risultato.Defines the localized day names that can appear in the result string.
MonthNames Definisce i nomi dei mesi localizzati che possono essere visualizzati nella stringa di risultato.Defines the localized month names that can appear in the result string.
TimeSeparator Definisce la stringa che separa i componenti relativi a ora, minuti e secondi di un orario.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definisce la stringa che indica le ore da mezzanotte a prima di mezzogiorno in un orario in formato 12 ore.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definisce la stringa che indica le ore da mezzogiorno a prima di mezzanotte in un orario in formato 12 ore.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Nell'esempio seguente viene usato l'identificatore di formato "F" per visualizzare un valore di data e ora.The following example uses the "F" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("F", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("F", 
                  CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays jeudi 10 avril 2008 06:30:00                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("F", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("F", _
                  CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays jeudi 10 avril 2008 06:30:00                       

Torna alla tabellaBack to table

Identificatore di formato di ora breve e data generale ("g")The General Date Short Time ("g") Format Specifier

L'identificatore di formato standard "g" rappresenta una combinazione degli schemi di data breve ("d") e ora breve ("t"), separati da uno spazio.The "g" standard format specifier represents a combination of the short date ("d") and short time ("t") patterns, separated by a space.

La stringa di risultato è influenzata dalle informazioni sulla formattazione di un oggetto DateTimeFormatInfo specifico.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. Nella tabella seguente sono elencate le proprietà dell'oggetto DateTimeFormatInfo che consentono di controllare la formattazione della stringa restituita.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. L'identificatore di formato personalizzato restituito dalle proprietà DateTimeFormatInfo.ShortDatePattern e DateTimeFormatInfo.ShortTimePattern di alcune impostazioni cultura potrebbe non prevedere l'uso di tutte le proprietà.The custom format specifier that is returned by the DateTimeFormatInfo.ShortDatePattern and DateTimeFormatInfo.ShortTimePattern properties of some cultures may not make use of all properties.

ProprietàProperty DESCRIZIONEDescription
ShortDatePattern Definisce il formato del componente relativo alla data della stringa di risultato.Defines the format of the date component of the result string.
ShortTimePattern Definisce il formato del componente relativo all'ora della stringa di risultato.Defines the format of the time component of the result string.
DateSeparator Definisce la stringa che separa i componenti relativi ad anno, mese e giorno di una data.Defines the string that separates the year, month, and day components of a date.
TimeSeparator Definisce la stringa che separa i componenti relativi a ora, minuti e secondi di un orario.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definisce la stringa che indica le ore da mezzanotte a prima di mezzogiorno in un orario in formato 12 ore.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definisce la stringa che indica le ore da mezzogiorno a prima di mezzanotte in un orario in formato 12 ore.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Nell'esempio seguente viene usato l'identificatore di formato "g" per visualizzare un valore di data e ora.The following example uses the "g" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("g", 
                  DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008 06:30                      
Console.WriteLine(date1.ToString("g", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 4/10/2008 6:30 AM                       
Console.WriteLine(date1.ToString("g", 
                  CultureInfo.CreateSpecificCulture("fr-BE")));
// Displays 10/04/2008 6:30                        
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("g", _
                  DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008 06:30                      
Console.WriteLine(date1.ToString("g", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 4/10/2008 6:30 AM                       
Console.WriteLine(date1.ToString("g", _
                  CultureInfo.CreateSpecificCulture("fr-BE")))
' Displays 10/04/2008 6:30                        

Torna alla tabellaBack to table

Identificatore di formato di ora estesa e data generale ("G")The General Date Long Time ("G") Format Specifier

L'identificatore di formato standard "G" rappresenta una combinazione degli schemi di data breve ("d") e ora estesa ("T"), separati da uno spazio.The "G" standard format specifier represents a combination of the short date ("d") and long time ("T") patterns, separated by a space.

La stringa di risultato è influenzata dalle informazioni sulla formattazione di un oggetto DateTimeFormatInfo specifico.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. Nella tabella seguente sono elencate le proprietà dell'oggetto DateTimeFormatInfo che consentono di controllare la formattazione della stringa restituita.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. L'identificatore di formato personalizzato restituito dalle proprietà DateTimeFormatInfo.ShortDatePattern e DateTimeFormatInfo.LongTimePattern di alcune impostazioni cultura potrebbe non prevedere l'uso di tutte le proprietà.The custom format specifier that is returned by the DateTimeFormatInfo.ShortDatePattern and DateTimeFormatInfo.LongTimePattern properties of some cultures may not make use of all properties.

ProprietàProperty DESCRIZIONEDescription
ShortDatePattern Definisce il formato del componente relativo alla data della stringa di risultato.Defines the format of the date component of the result string.
LongTimePattern Definisce il formato del componente relativo all'ora della stringa di risultato.Defines the format of the time component of the result string.
DateSeparator Definisce la stringa che separa i componenti relativi ad anno, mese e giorno di una data.Defines the string that separates the year, month, and day components of a date.
TimeSeparator Definisce la stringa che separa i componenti relativi a ora, minuti e secondi di un orario.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definisce la stringa che indica le ore da mezzanotte a prima di mezzogiorno in un orario in formato 12 ore.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definisce la stringa che indica le ore da mezzogiorno a prima di mezzanotte in un orario in formato 12 ore.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Nell'esempio seguente viene usato l'identificatore di formato "G" per visualizzare un valore di data e ora.The following example uses the "G" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("G", 
                  DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008 06:30:00
Console.WriteLine(date1.ToString("G", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 4/10/2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("G", 
                  CultureInfo.CreateSpecificCulture("nl-BE")));
// Displays 10/04/2008 6:30:00                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("G", _
                  DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008 06:30:00
Console.WriteLine(date1.ToString("G", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 4/10/2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("G", _
                  CultureInfo.CreateSpecificCulture("nl-BE")))
' Displays 10/04/2008 6:30:00                       

Torna alla tabellaBack to table

Identificatore di formato di mese ("M", "m")The Month ("M", "m") Format Specifier

L'identificatore di formato standard "M" o "m" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.MonthDayPattern corrente.The "M" or "m" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.MonthDayPattern property. La stringa di formato personalizzata per le impostazioni cultura invarianti ad esempio è "MMMM dd".For example, the custom format string for the invariant culture is "MMMM dd".

Nella tabella seguente sono elencate le proprietà dell'oggetto DateTimeFormatInfo che consentono di controllare la formattazione della stringa restituita.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

ProprietàProperty DESCRIZIONEDescription
MonthDayPattern Definisce il formato complessivo della stringa di risultato.Defines the overall format of the result string.
MonthNames Definisce i nomi dei mesi localizzati che possono essere visualizzati nella stringa di risultato.Defines the localized month names that can appear in the result string.

Nell'esempio seguente viene usato l'identificatore di formato "m" per visualizzare un valore di data e ora.The following example uses the "m" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("m", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays April 10                        
Console.WriteLine(date1.ToString("m", 
                  CultureInfo.CreateSpecificCulture("ms-MY")));
// Displays 10 April                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("m", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays April 10                        
Console.WriteLine(date1.ToString("m", _
                  CultureInfo.CreateSpecificCulture("ms-MY")))
' Displays 10 April                       

Torna alla tabellaBack to table

Identificatore di formato di round trip ("O", "o")The Round-trip ("O", "o") Format Specifier

L'identificatore di formato standard "O" o "o" rappresenta una stringa di formato di data e ora personalizzata con uno schema che mantiene le informazioni sul fuso orario e crea una stringa di risultato conforme allo standard ISO 8601.The "O" or "o" standard format specifier represents a custom date and time format string using a pattern that preserves time zone information and emits a result string that complies with ISO 8601. Per i valori DateTime, questo identificatore di formato è progettato per mantenere valori di data e ora insieme alla proprietà DateTime.Kind nel testo.For DateTime values, this format specifier is designed to preserve date and time values along with the DateTime.Kind property in text. È possibile analizzare di nuovo la stringa formattata usando il metodo DateTime.Parse(String, IFormatProvider, DateTimeStyles) o DateTime.ParseExact se il parametro styles è impostato su DateTimeStyles.RoundtripKind.The formatted string can be parsed back by using the DateTime.Parse(String, IFormatProvider, DateTimeStyles) or DateTime.ParseExact method if the styles parameter is set to DateTimeStyles.RoundtripKind.

L'identificatore di formato standard "O" o "o" corrisponde alla stringa di formato personalizzata "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" per valori DateTime e alla stringa di formato personalizzata "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzz" per valori DateTimeOffset.The "O" or "o" standard format specifier corresponds to the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" custom format string for DateTime values and to the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzz" custom format string for DateTimeOffset values. In questa stringa le coppie di virgolette singole che delimitano singoli caratteri, ad esempio trattini, due punti e la lettera "T", indicano che il singolo carattere è un valore letterale che non può essere modificato.In this string, the pairs of single quotation marks that delimit individual characters, such as the hyphens, the colons, and the letter "T", indicate that the individual character is a literal that cannot be changed. Gli apostrofi non vengono visualizzati nella stringa di output.The apostrophes do not appear in the output string.

L'identificatore di formato standard "O" o "o" (e la stringa di formato personalizzata "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK") sfrutta i tre modi in cui lo standard ISO 8601 rappresenta le informazioni sul fuso orario per preservare la proprietà Kind dei valori DateTime:The "O" or "o" standard format specifier (and the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" custom format string) takes advantage of the three ways that ISO 8601 represents time zone information to preserve the Kind property of DateTime values:

  • Il componente relativo al fuso orario dei valori di data e ora DateTimeKind.Local è un offset rispetto all'ora UTC (ad esempio +01:00, -07:00).The time zone component of DateTimeKind.Local date and time values is an offset from UTC (for example, +01:00, -07:00). Anche tutti i valori DateTimeOffset sono rappresentati in questo formato.All DateTimeOffset values are also represented in this format.

  • Il componente relativo al fuso orario dei valori di data e ora DateTimeKind.Utc usa "Z" (che sta per zero offset) per rappresentare l'ora UTC.The time zone component of DateTimeKind.Utc date and time values uses "Z" (which stands for zero offset) to represent UTC.

  • I valori di data e ora DateTimeKind.Unspecified non dispongono di informazioni sul fuso orario.DateTimeKind.Unspecified date and time values have no time zone information.

Poiché l'identificatore di formato standard "O" o "o" è conforme a uno standard internazionale, l'operazione di formattazione o analisi che usa l'identificatore impiega sempre le impostazioni cultura invarianti e il calendario gregoriano.Because the "O" or "o" standard format specifier conforms to an international standard, the formatting or parsing operation that uses the specifier always uses the invariant culture and the Gregorian calendar.

Le stringhe passati ai metodi Parse, TryParse, ParseExact e TryParseExact di DateTime e DateTimeOffset possono essere analizzate usando l'identificatore di formato "O" o "o" se sono in uno di questi formati.Strings that are passed to the Parse, TryParse, ParseExact, and TryParseExact methods of DateTime and DateTimeOffset can be parsed by using the "O" or "o" format specifier if they are in one of these formats. Nel caso degli oggetti DateTime, l'overload di analisi chiamato deve anche includere un parametro styles con un valore DateTimeStyles.RoundtripKind.In the case of DateTime objects, the parsing overload that you call should also include a styles parameter with a value of DateTimeStyles.RoundtripKind. Tenere presente che se si chiama un metodo di analisi con la stringa di formato personalizzata che corrisponde all'identificatore di formato "O" o "o", non si otterranno gli stessi risultati di "O" o "o".Note that if you call a parsing method with the custom format string that corresponds to the "O" or "o" format specifier, you won't get the same results as "O" or "o". Il motivo è che i metodi di analisi che usano una stringa di formato personalizzata non possono analizzare la rappresentazione in formato stringa di valori di data e ora in cui manca un componente di fuso orario o che usano "Z" per indicare l'ora UTC.This is because parsing methods that use a custom format string can't parse the string representation of date and time values that lack a time zone component or use "Z" to indicate UTC.

Nell'esempio seguente viene usato l'identificatore di formato "o" per visualizzare una serie di valori DateTime e un valore DateTimeOffset in un sistema nel fuso orario Pacifico (Stati Uniti).The following example uses the "o" format specifier to display a series of DateTime values and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

using System;

public class Example
{
   public static void Main()
   {
       DateTime dat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                   DateTimeKind.Unspecified);
       Console.WriteLine("{0} ({1}) --> {0:O}", dat, dat.Kind); 
   
       DateTime uDat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                    DateTimeKind.Utc);
       Console.WriteLine("{0} ({1}) --> {0:O}", uDat, uDat.Kind);
       
       DateTime lDat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                    DateTimeKind.Local);
       Console.WriteLine("{0} ({1}) --> {0:O}\n", lDat, lDat.Kind);
       
       DateTimeOffset dto = new DateTimeOffset(lDat);
       Console.WriteLine("{0} --> {0:O}", dto);
   }
}
// The example displays the following output:
//    6/15/2009 1:45:30 PM (Unspecified) --> 2009-06-15T13:45:30.0000000
//    6/15/2009 1:45:30 PM (Utc) --> 2009-06-15T13:45:30.0000000Z
//    6/15/2009 1:45:30 PM (Local) --> 2009-06-15T13:45:30.0000000-07:00
//    
//    6/15/2009 1:45:30 PM -07:00 --> 2009-06-15T13:45:30.0000000-07:00
Module Example
   Public Sub Main()
       Dim dat As New Date(2009, 6, 15, 13, 45, 30, 
                           DateTimeKind.Unspecified)
       Console.WriteLine("{0} ({1}) --> {0:O}", dat, dat.Kind) 
   
       Dim uDat As New Date(2009, 6, 15, 13, 45, 30, DateTimeKind.Utc)
       Console.WriteLine("{0} ({1}) --> {0:O}", uDat, uDat.Kind)
       
       Dim lDat As New Date(2009, 6, 15, 13, 45, 30, DateTimeKind.Local)
       Console.WriteLine("{0} ({1}) --> {0:O}", lDat, lDat.Kind)
       Console.WriteLine()
       
       Dim dto As New DateTimeOffset(lDat)
       Console.WriteLine("{0} --> {0:O}", dto)
   End Sub
End Module
' The example displays the following output:
'    6/15/2009 1:45:30 PM (Unspecified) --> 2009-06-15T13:45:30.0000000
'    6/15/2009 1:45:30 PM (Utc) --> 2009-06-15T13:45:30.0000000Z
'    6/15/2009 1:45:30 PM (Local) --> 2009-06-15T13:45:30.0000000-07:00
'    
'    6/15/2009 1:45:30 PM -07:00 --> 2009-06-15T13:45:30.0000000-07:00

Nell'esempio seguente viene usato l'identificatore di formato "o" per creare una stringa formattata, quindi viene ripristinato il valore di data e ora originale chiamando un metodo Parse di data e ora.The following example uses the "o" format specifier to create a formatted string, and then restores the original date and time value by calling a date and time Parse method.

// Round-trip DateTime values.
DateTime originalDate, newDate;
string dateString;
// Round-trip a local time.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 10, 6, 30, 0), DateTimeKind.Local);
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  newDate, newDate.Kind);
// Round-trip a UTC time.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 12, 9, 30, 0), DateTimeKind.Utc);                  
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  newDate, newDate.Kind);
// Round-trip time in an unspecified time zone.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 13, 12, 30, 0), DateTimeKind.Unspecified);                  
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  newDate, newDate.Kind);

// Round-trip a DateTimeOffset value.
DateTimeOffset originalDTO = new DateTimeOffset(2008, 4, 12, 9, 30, 0, new TimeSpan(-8, 0, 0));
dateString = originalDTO.ToString("o");
DateTimeOffset newDTO = DateTimeOffset.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} to {1}.", originalDTO, newDTO);
// The example displays the following output:
//    Round-tripped 4/10/2008 6:30:00 AM Local to 4/10/2008 6:30:00 AM Local.
//    Round-tripped 4/12/2008 9:30:00 AM Utc to 4/12/2008 9:30:00 AM Utc.
//    Round-tripped 4/13/2008 12:30:00 PM Unspecified to 4/13/2008 12:30:00 PM Unspecified.
//    Round-tripped 4/12/2008 9:30:00 AM -08:00 to 4/12/2008 9:30:00 AM -08:00.
' Round-trip DateTime values.
Dim originalDate, newDate As Date
Dim dateString As String
' Round-trip a local time.
originalDate = Date.SpecifyKind(#4/10/2008 6:30AM#, DateTimeKind.Local)
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
                  newDate, newDate.Kind)
' Round-trip a UTC time.
originalDate = Date.SpecifyKind(#4/12/2008 9:30AM#, DateTimeKind.Utc)                  
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
                  newDate, newDate.Kind)
' Round-trip time in an unspecified time zone.
originalDate = Date.SpecifyKind(#4/13/2008 12:30PM#, DateTimeKind.Unspecified)                  
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
                  newDate, newDate.Kind)

' Round-trip a DateTimeOffset value.
Dim originalDTO As New DateTimeOffset(#4/12/2008 9:30AM#, New TimeSpan(-8, 0, 0))
dateString = originalDTO.ToString("o")
Dim newDTO As DateTimeOffset = DateTimeOffset.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} to {1}.", originalDTO, newDTO)
' The example displays the following output:
'    Round-tripped 4/10/2008 6:30:00 AM Local to 4/10/2008 6:30:00 AM Local.
'    Round-tripped 4/12/2008 9:30:00 AM Utc to 4/12/2008 9:30:00 AM Utc.
'    Round-tripped 4/13/2008 12:30:00 PM Unspecified to 4/13/2008 12:30:00 PM Unspecified.
'    Round-tripped 4/12/2008 9:30:00 AM -08:00 to 4/12/2008 9:30:00 AM -08:00.

Torna alla tabellaBack to table

Identificatore di formato RFC1123 ("R", "r")The RFC1123 ("R", "r") Format Specifier

L'identificatore di formato standard "R" o "r" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.RFC1123Pattern corrente.The "R" or "r" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.RFC1123Pattern property. Lo schema riflette uno standard definito e la proprietà è di sola lettura.The pattern reflects a defined standard, and the property is read-only. Pertanto sarà sempre lo stesso, indipendentemente dalle impostazioni cultura usate o dal provider di formato fornito.Therefore, it is always the same, regardless of the culture used or the format provider supplied. La stringa di formato personalizzata è "ddd, dd MMM yyyy HH':'mm':'ss 'GMT".The custom format string is "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'". Quando viene usato questo identificatore di formato standard, la formattazione o l'operazione di analisi usa sempre le impostazioni cultura invarianti.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

La stringa di risultato è influenzata dalle proprietà seguenti dell'oggetto DateTimeFormatInfo restituito dalla proprietà DateTimeFormatInfo.InvariantInfo che rappresenta la lingua inglese.The result string is affected by the following properties of the DateTimeFormatInfo object returned by the DateTimeFormatInfo.InvariantInfo property that represents the invariant culture.

ProprietàProperty DESCRIZIONEDescription
RFC1123Pattern Definisce il formato della stringa di risultato.Defines the format of the result string.
AbbreviatedDayNames Definisce i nomi dei giorni abbreviati che possono essere visualizzati nella stringa di risultato.Defines the abbreviated day names that can appear in the result string.
AbbreviatedMonthNames Definisce i nomi dei mesi abbreviati che possono essere visualizzati nella stringa di risultato.Defines the abbreviated month names that can appear in the result string.

Anche se lo standard RFC 1123 esprime un'ora in formato UTC (Coordinated Universal Time), l'operazione di formattazione non comporta la modifica del valore dell'oggetto DateTime che viene formattato.Although the RFC 1123 standard expresses a time as Coordinated Universal Time (UTC), the formatting operation does not modify the value of the DateTime object that is being formatted. È pertanto necessario convertire il valore DateTime in formato UTC chiamando il metodo DateTime.ToUniversalTime prima di eseguire l'operazione di formattazione.Therefore, you must convert the DateTime value to UTC by calling the DateTime.ToUniversalTime method before you perform the formatting operation. Al contrario, i valori DateTimeOffset eseguono questa conversione automaticamente; non è necessario chiamare il metodo DateTimeOffset.ToUniversalTime prima dell'operazione di formattazione.In contrast, DateTimeOffset values perform this conversion automatically; there is no need to call the DateTimeOffset.ToUniversalTime method before the formatting operation.

Nell'esempio seguente viene usato l'identificatore di formato "r" per visualizzare un valore DateTime e un valore DateTimeOffset in un sistema nel fuso orario Pacifico (Stati Uniti).The following example uses the "r" format specifier to display a DateTime and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
DateTimeOffset dateOffset = new DateTimeOffset(date1, 
                            TimeZoneInfo.Local.GetUtcOffset(date1));
Console.WriteLine(date1.ToUniversalTime().ToString("r"));
// Displays Thu, 10 Apr 2008 13:30:00 GMT                       
Console.WriteLine(dateOffset.ToUniversalTime().ToString("r"));
// Displays Thu, 10 Apr 2008 13:30:00 GMT                        
Dim date1 As Date = #4/10/2008 6:30AM#
Dim dateOffset As New DateTimeOffset(date1, TimeZoneInfo.Local.GetUtcOFfset(date1))
Console.WriteLine(date1.ToUniversalTime.ToString("r"))
' Displays Thu, 10 Apr 2008 13:30:00 GMT                       
Console.WriteLine(dateOffset.ToUniversalTime.ToString("r"))
' Displays Thu, 10 Apr 2008 13:30:00 GMT                        

Torna alla tabellaBack to table

Identificatore di formato ordinabile ("s")The Sortable ("s") Format Specifier

L'identificatore di formato standard "s" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.SortableDateTimePattern corrente.The "s" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.SortableDateTimePattern property. Lo schema riflette uno standard definito (ISO 8601) e la proprietà è di sola lettura.The pattern reflects a defined standard (ISO 8601), and the property is read-only. Pertanto sarà sempre lo stesso, indipendentemente dalle impostazioni cultura usate o dal provider di formato fornito.Therefore, it is always the same, regardless of the culture used or the format provider supplied. La stringa di formato personalizzata è "yyyy'-'MM'-'dd'T'HH':'mm':'ss".The custom format string is "yyyy'-'MM'-'dd'T'HH':'mm':'ss".

L'identificatore di formato "s" ha lo scopo di produrre stringhe di risultati organizzate coerentemente in ordine crescente o decrescente, in base ai valori di data e ora.The purpose of the "s" format specifier is to produce result strings that sort consistently in ascending or descending order based on date and time values. Di conseguenza, anche se l'identificatore di formato standard "s" rappresenta un valore di data e ora in un formato coerente, l'operazione di formattazione non modifica il valore dell'oggetto data e ora che viene formattato per riflettere la proprietà DateTime.Kind o il valore DateTimeOffset.Offset corrispondente.As a result, although the "s" standard format specifier represents a date and time value in a consistent format, the formatting operation does not modify the value of the date and time object that is being formatted to reflect its DateTime.Kind property or its DateTimeOffset.Offset value. Ad esempio, le stringhe di risultati generate dalla formattazione dei valori di data e ora 2014-11-15T18:32:17+00:00 e 2014-11-15T18:32:17+08:00 sono identiche.For example, the result strings produced by formatting the date and time values 2014-11-15T18:32:17+00:00 and 2014-11-15T18:32:17+08:00 are identical.

Quando viene usato questo identificatore di formato standard, la formattazione o l'operazione di analisi usa sempre le impostazioni cultura invarianti.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

Nell'esempio seguente viene usato l'identificatore di formato "s" per visualizzare un valore DateTime e un valore DateTimeOffset in un sistema nel fuso orario Pacifico (Stati Uniti).The following example uses the "s" format specifier to display a DateTime and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("s"));
// Displays 2008-04-10T06:30:00                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("s"))
' Displays 2008-04-10T06:30:00                       

Torna alla tabellaBack to table

Identificatore di formato di ora breve ("t")The Short Time ("t") Format Specifier

L'identificatore di formato standard "t" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.ShortTimePattern corrente.The "t" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.ShortTimePattern property. La stringa di formato personalizzata per le impostazioni cultura invarianti ad esempio è "HH:mm".For example, the custom format string for the invariant culture is "HH:mm".

La stringa di risultato è influenzata dalle informazioni sulla formattazione di un oggetto DateTimeFormatInfo specifico.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. Nella tabella seguente sono elencate le proprietà dell'oggetto DateTimeFormatInfo che consentono di controllare la formattazione della stringa restituita.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. L'identificatore di formato personalizzato restituito dalla proprietà DateTimeFormatInfo.ShortTimePattern di alcune impostazioni cultura potrebbe non prevedere l'uso di tutte le proprietà.The custom format specifier that is returned by the DateTimeFormatInfo.ShortTimePattern property of some cultures may not make use of all properties.

ProprietàProperty DESCRIZIONEDescription
ShortTimePattern Definisce il formato del componente relativo all'ora della stringa di risultato.Defines the format of the time component of the result string.
TimeSeparator Definisce la stringa che separa i componenti relativi a ora, minuti e secondi di un orario.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definisce la stringa che indica le ore da mezzanotte a prima di mezzogiorno in un orario in formato 12 ore.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definisce la stringa che indica le ore da mezzogiorno a prima di mezzanotte in un orario in formato 12 ore.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Nell'esempio seguente viene usato l'identificatore di formato "t" per visualizzare un valore di data e ora.The following example uses the "t" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("t", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 6:30 AM                        
Console.WriteLine(date1.ToString("t", 
                  CultureInfo.CreateSpecificCulture("es-ES")));
// Displays 6:30                      
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("t", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 6:30 AM                        
Console.WriteLine(date1.ToString("t", _
                  CultureInfo.CreateSpecificCulture("es-ES")))
' Displays 6:30                      

Torna alla tabellaBack to table

Identificatore di formato di ora estesa ("T")The Long Time ("T") Format Specifier

L'identificatore di formato standard "T" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.LongTimePattern di impostazioni cultura specifiche.The "T" standard format specifier represents a custom date and time format string that is defined by a specific culture's DateTimeFormatInfo.LongTimePattern property. La stringa di formato personalizzata per le impostazioni cultura invarianti ad esempio è "HH:mm:ss".For example, the custom format string for the invariant culture is "HH:mm:ss".

Nella tabella seguente sono elencate le proprietà dell'oggetto DateTimeFormatInfo che consentono di controllare la formattazione della stringa restituita.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. L'identificatore di formato personalizzato restituito dalla proprietà DateTimeFormatInfo.LongTimePattern di alcune impostazioni cultura potrebbe non prevedere l'uso di tutte le proprietà.The custom format specifier that is returned by the DateTimeFormatInfo.LongTimePattern property of some cultures may not make use of all properties.

ProprietàProperty DESCRIZIONEDescription
LongTimePattern Definisce il formato del componente relativo all'ora della stringa di risultato.Defines the format of the time component of the result string.
TimeSeparator Definisce la stringa che separa i componenti relativi a ora, minuti e secondi di un orario.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definisce la stringa che indica le ore da mezzanotte a prima di mezzogiorno in un orario in formato 12 ore.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definisce la stringa che indica le ore da mezzogiorno a prima di mezzanotte in un orario in formato 12 ore.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Nell'esempio seguente viene usato l'identificatore di formato "T" per visualizzare un valore di data e ora.The following example uses the "T" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("T", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 6:30:00 AM                       
Console.WriteLine(date1.ToString("T", 
                  CultureInfo.CreateSpecificCulture("es-ES")));
// Displays 6:30:00                      
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("T", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 6:30:00 AM                       
Console.WriteLine(date1.ToString("T", _
                  CultureInfo.CreateSpecificCulture("es-ES")))
' Displays 6:30:00                      

Torna alla tabellaBack to table

Identificatore di formato ordinabile universale ("u")The Universal Sortable ("u") Format Specifier

L'identificatore di formato standard "u" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.UniversalSortableDateTimePattern corrente.The "u" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.UniversalSortableDateTimePattern property. Lo schema riflette uno standard definito e la proprietà è di sola lettura.The pattern reflects a defined standard, and the property is read-only. Pertanto sarà sempre lo stesso, indipendentemente dalle impostazioni cultura usate o dal provider di formato fornito.Therefore, it is always the same, regardless of the culture used or the format provider supplied. La stringa di formato personalizzata è "yyyy'-'MM'-'dd HH':'mm':'ss'Z".The custom format string is "yyyy'-'MM'-'dd HH':'mm':'ss'Z'". Quando viene usato questo identificatore di formato standard, la formattazione o l'operazione di analisi usa sempre le impostazioni cultura invarianti.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

Sebbene la stringa di risultato debba esprimere un'ora in formato UTC (Coordinated Universal Time), non viene eseguita alcuna conversione del valore DateTime originale durante l'operazione di formattazione.Although the result string should express a time as Coordinated Universal Time (UTC), no conversion of the original DateTime value is performed during the formatting operation. È pertanto necessario convertire un valore DateTime in formato UTC chiamando il metodo DateTime.ToUniversalTime prima di eseguire l'operazione di formattazione.Therefore, you must convert a DateTime value to UTC by calling the DateTime.ToUniversalTime method before formatting it. Al contrario, i valori DateTimeOffset eseguono questa conversione automaticamente; non è necessario chiamare il metodo DateTimeOffset.ToUniversalTime prima dell'operazione di formattazione.In contrast, DateTimeOffset values perform this conversion automatically; there is no need to call the DateTimeOffset.ToUniversalTime method before the formatting operation.

Nell'esempio seguente viene usato l'identificatore di formato "u" per visualizzare un valore di data e ora.The following example uses the "u" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToUniversalTime().ToString("u"));
// Displays 2008-04-10 13:30:00Z                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToUniversalTime.ToString("u"))
' Displays 2008-04-10 13:30:00Z                       

Torna alla tabellaBack to table

Identificatore di formato completo universale ("U")The Universal Full ("U") Format Specifier

L'identificatore di formato standard "U" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.FullDateTimePattern di impostazioni cultura specifiche.The "U" standard format specifier represents a custom date and time format string that is defined by a specified culture's DateTimeFormatInfo.FullDateTimePattern property. Lo schema corrisponde a quello di "F".The pattern is the same as the "F" pattern. Il valore DateTime, tuttavia, viene convertito automaticamente in formato UTC prima di essere formattato.However, the DateTime value is automatically converted to UTC before it is formatted.

Nella tabella seguente sono elencate le proprietà dell'oggetto DateTimeFormatInfo che consentono di controllare la formattazione della stringa restituita.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. L'identificatore di formato personalizzato restituito dalla proprietà FullDateTimePattern di alcune impostazioni cultura potrebbe non prevedere l'uso di tutte le proprietà.The custom format specifier that is returned by the FullDateTimePattern property of some cultures may not make use of all properties.

ProprietàProperty DESCRIZIONEDescription
FullDateTimePattern Definisce il formato complessivo della stringa di risultato.Defines the overall format of the result string.
DayNames Definisce i nomi dei giorni localizzati che possono essere visualizzati nella stringa di risultato.Defines the localized day names that can appear in the result string.
MonthNames Definisce i nomi dei mesi localizzati che possono essere visualizzati nella stringa di risultato.Defines the localized month names that can appear in the result string.
TimeSeparator Definisce la stringa che separa i componenti relativi a ora, minuti e secondi di un orario.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definisce la stringa che indica le ore da mezzanotte a prima di mezzogiorno in un orario in formato 12 ore.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definisce la stringa che indica le ore da mezzogiorno a prima di mezzanotte in un orario in formato 12 ore.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

L'identificatore di formato "U" non è supportato dal tipo DateTimeOffset e genera un evento FormatException se viene usato per formattare un valore DateTimeOffset.The "U" format specifier is not supported by the DateTimeOffset type and throws a FormatException if it is used to format a DateTimeOffset value.

Nell'esempio seguente viene usato l'identificatore di formato "U" per visualizzare un valore di data e ora.The following example uses the "U" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("U", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 1:30:00 PM                       
Console.WriteLine(date1.ToString("U", 
                  CultureInfo.CreateSpecificCulture("sv-FI")));
// Displays den 10 april 2008 13:30:00                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("U", CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 1:30:00 PM                       
Console.WriteLine(date1.ToString("U", CultureInfo.CreateSpecificCulture("sv-FI")))
' Displays den 10 april 2008 13:30:00                       

Torna alla tabellaBack to table

Identificatore di formato di mese e anno ("Y", "y")The Year Month ("Y", "y") Format Specifier

L'identificatore di formato standard "Y" o "y" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.YearMonthPattern di impostazioni cultura specifiche.The "Y" or "y" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.YearMonthPattern property of a specified culture. La stringa di formato personalizzata per le impostazioni cultura invarianti ad esempio è "yyyy MMMM".For example, the custom format string for the invariant culture is "yyyy MMMM".

Nella tabella seguente sono elencate le proprietà dell'oggetto DateTimeFormatInfo che consentono di controllare la formattazione della stringa restituita.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

ProprietàProperty DESCRIZIONEDescription
YearMonthPattern Definisce il formato complessivo della stringa di risultato.Defines the overall format of the result string.
MonthNames Definisce i nomi dei mesi localizzati che possono essere visualizzati nella stringa di risultato.Defines the localized month names that can appear in the result string.

Nell'esempio seguente viene usato l'identificatore di formato "Y" per visualizzare un valore di data e ora.The following example uses the "y" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("Y", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays April, 2008                       
Console.WriteLine(date1.ToString("y", 
                  CultureInfo.CreateSpecificCulture("af-ZA")));
// Displays April 2008                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("Y", CultureInfo.CreateSpecificCulture("en-US")))
' Displays April, 2008                       
Console.WriteLine(date1.ToString("y", CultureInfo.CreateSpecificCulture("af-ZA")))
' Displays April 2008                       

Torna alla tabellaBack to table

NoteNotes

Impostazioni del Pannello di controlloControl Panel Settings

Le impostazioni di Opzioni internazionali e della lingua nel Pannello di controllo influiscono sulla stringa risultato prodotta da un'operazione di formattazione.The settings in the Regional and Language Options item in Control Panel influence the result string produced by a formatting operation. Queste impostazioni vengono usate per inizializzare l'oggetto DateTimeFormatInfo associato alle impostazioni cultura del thread corrente, che fornisce i valori usati per definire la formattazione.These settings are used to initialize the DateTimeFormatInfo object associated with the current thread culture, which provides values used to govern formatting. Computer con impostazioni diverse generano stringhe di risultato diverse.Computers that use different settings generate different result strings.

Se inoltre viene usato il costruttore CultureInfo.CultureInfo(String) per creare un'istanza di un nuovo oggetto CultureInfo che rappresenta le stesse impostazioni cultura delle impostazioni cultura del sistema correnti, le eventuali personalizzazioni definite tramite Opzioni internazionali e della lingua nel Pannello di controllo verranno applicate al nuovo oggetto CultureInfo .In addition, if you use the CultureInfo.CultureInfo(String) constructor to instantiate a new CultureInfo object that represents the same culture as the current system culture, any customizations established by the Regional and Language Options item in Control Panel will be applied to the new CultureInfo object. È possibile usare il costruttore di CultureInfo.CultureInfo(String, Boolean) per creare un oggetto CultureInfo che non rifletta le personalizzazioni di un sistema.You can use the CultureInfo.CultureInfo(String, Boolean) constructor to create a CultureInfo object that does not reflect a system's customizations.

Proprietà DateTimeFormatInfoDateTimeFormatInfo Properties

La formattazione è influenzata dalle proprietà dell'oggetto DateTimeFormatInfo corrente, che viene fornito in modo implicito dalle impostazioni cultura del thread correnti o in modo esplicito dal parametro IFormatProvider del metodo che richiama la formattazione.Formatting is influenced by properties of the current DateTimeFormatInfo object, which is provided implicitly by the current thread culture or explicitly by the IFormatProvider parameter of the method that invokes formatting. Per il parametro IFormatProvider l'applicazione deve specificare un oggetto CultureInfo che rappresenta un tipo di impostazioni cultura o un oggetto DateTimeFormatInfo che rappresenta le convenzioni di formattazione di data e ora di impostazioni cultura particolari.For the IFormatProvider parameter, your application should specify a CultureInfo object, which represents a culture, or a DateTimeFormatInfo object, which represents a particular culture's date and time formatting conventions. Molti degli identificatori di formato di data e ora standard sono alias di schemi di formattazione definiti dalle proprietà dell'oggetto DateTimeFormatInfo corrente.Many of the standard date and time format specifiers are aliases for formatting patterns defined by properties of the current DateTimeFormatInfo object. Nell'applicazione può quindi essere modificato il risultato prodotto da alcuni identificatori di formato di data e ora personalizzati standard modificando gli schemi di formato di data e ora corrispondenti della proprietà DateTimeFormatInfo corrispondente.Your application can change the result produced by some standard date and time format specifiers by changing the corresponding date and time format patterns of the corresponding DateTimeFormatInfo property.

Vedere ancheSee also