Stringhe di formato di data e ora standard

Articolo
04/08/2023

Una stringa di formato data e ora standard usa un singolo carattere come identificatore di formato per definire la rappresentazione testuale di un DateTime valore o DateTimeOffset . Qualsiasi stringa di formato di data e ora che contiene più di un carattere, incluso lo spazio vuoto, viene interpretata come una stringa di formato di data e ora personalizzata. Una stringa di formato standard o personalizzata può essere usata in due modi:

Per definire la stringa risultante da un'operazione di formattazione.
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.

Suggerimento

È possibile scaricare Utilità formattazione, un'applicazione .NET Windows Forms che consente di applicare stringhe di formato a valori numerici o di data e ora e visualizzare la stringa di risultato. Il codice sorgente è disponibile per C# e Visual Basic.

Nota

Alcuni degli esempi in C# in questo articolo vengono eseguiti nello strumento di esecuzione e playground per codice inline Try.NET. Selezionare il pulsante Esegui per eseguire un esempio in una finestra interattiva. Dopo aver eseguito il codice, è possibile modificarlo ed eseguire il codice modificato selezionando di nuovo Esegui. 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#.

Il fuso orario locale dello strumento di esecuzione e playground per codice inline Try.NET è Coordinated Universal Time o ora UTC. Ciò può influire sul comportamento e l'output degli esempi che illustrano i tipi DateTime, DateTimeOffset e TimeZoneInfo e i relativi membri.

Tabella degli identificatori di formato

Nella tabella seguente vengono descritti gli identificatori di formato di data e ora standard. 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. Per altre informazioni sull'uso delle stringhe di formato di data e ora standard, vedere Pannello di controllo Settings and DateTimeFormatInfo Properties .See Pannello di controllo Settings and DateTimeFormatInfo Properties for additional information about using standard date and time format strings.

Identificatore di formato	Descrizione	Esempi
"d"	Schema di data breve. Altre informazioni:Identificatore di formato data breve ("d").	2009-06-15T13:45:30 -> 15/6/2009 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D"	Schema di data estesa. Altre informazioni:Identificatore di formato data estesa ("D").	2009-06-15T13:45:30 -> Lunedì, 15 giugno 2009 (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
"f"	Schema di data/ora completa (ora breve). Altre informazioni: identificatore di formato full date short time ("f").	2009-06-15T13:45:30 -> Lunedì, 15 giugno 2009 1:45 (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE) 2009-06-15T13:45:30 -> Μεατιρα, 15 Ιοονοα 2009 1:45 μμ (el-GR)
"F"	Schema di data/ora completa (ora estesa). Altre informazioni: identificatore di formato di data estesa completa ("F").	2009-06-15T13:45:30 -> Lunedì, 15 giugno 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 -> Μεατιρα, 15 Ιοονοα 2009 1:45:30 μμ (el-GR)
"g"	Schema di data/ora generale (ora breve). Altre informazioni: identificatore di formato di data breve ("g") generale.	2009-06-15T13:45:30 -> 15/6/2009 1:45 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G"	Schema di data/ora generale (ora estesa). Altre informazioni: Identificatore di formato di data estesa generale ("G").	2009-06-15T13:45:30 -> 15/6/2009 1:45:30 (en-US) 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)
"M", "m"	Schema di mese/giorno. Altre informazioni: Identificatore di formato month ("M", "m").	2009-06-15T13:45:30 -> 15 giugno (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o"	modello di data/ora round trip. Altre informazioni: Identificatore di formato round trip ("O", "o").	Valori DateTime: 2009-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.000000Z 2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000 Valori DateTimeOffset: 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.000000-07:00
"R", "r"	Schema RFC1123. Altre informazioni: Identificatore di formato RFC1123 ("R", "r").	DateTimeOffset input: 2009-06-15T13:45:30 -> Lun, 15 Giugno 2009 20:45:30 GMT DateTime input: 2009-06-15T13:45:30 -> Lun, 15 Giugno 2009 13:45:30 GMT
"s"	Schema di data/ora ordinabile. Altre informazioni: Identificatore di formato ordinabile ("s").	2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30 2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30
"t"	Schema di ora breve. Altre informazioni: identificatore di formato breve ("t").	2009-06-15T13:45:30 -> 1:45 PM (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T"	Schema di ora estesa. Altre informazioni: identificatore di formato long time ("T").	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 -> 01:45:30 م (ar-EG)
"u"	Schema di data/ora ordinabile universale. Altre informazioni: identificatore di formato universali ("u") ordinabile.	Con un DateTime valore: 2009-06-15T13:45:30> - 2009-06-15 13:45:30Z Con un DateTimeOffset valore: 2009-06-15T13:45:30> - 2009-06-15 20:45:30Z
"U"	Schema di data/ora completa universale. Altre informazioni: identificatore di formato completo (U) universale.	2009-06-15T13:45:30 -> Lunedì, 15 giugno 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 -> Δευτρα, 15 Ιουσου 2009 8:45:30 μμ (el-GR)
"Y", "y"	Schema di mese e anno. Altre informazioni: identificatore di formato "Y") dell'anno.	2009-06-15T13:45:30 -> Giugno 2009 (en-US) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Qualsiasi altro carattere singolo	Identificatore sconosciuto.	Genera un evento FormatException in fase di esecuzione.

Funzionamento delle stringhe di formato standard

In un'operazione di formattazione, una stringa di formato standard è semplicemente un alias per una stringa di formato personalizzata. 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. Questo aspetto è importante perché le rappresentazioni di stringa di valori di data e ora variano in genere in base alle impostazioni cultura. 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. Per le impostazioni cultura invarianti questo schema è "MM/dd/yyyy". Per le impostazioni cultura fr-FR questo schema è "dd/MM/yyyy". Per le impostazioni cultura ja-JP questo schema è "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à:

È possibile usare le impostazioni cultura predefinite, o correnti. Nell'esempio seguente viene visualizzata una data usando il formato di data breve delle impostazioni cultura correnti. In questo caso le impostazioni cultura correnti sono 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. Nell'esempio seguente viene visualizzata una data usando il formato di data breve delle impostazioni cultura pt-BR.

// 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. Nell'esempio seguente viene visualizzata una data usndo il formato di data breve da un oggetto DateTimeFormatInfo per le impostazioni cultura hr-HR.

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

In alcuni casi la stringa di formato standard serve come una pratica abbreviazione per una stringa di formato personalizzata più lunga, che è invariante. In questa categoria rientrano quattro stringhe di formato standard: "O" (o "o"), "R" (o "r"), "s" e "u". Queste stringhe corrispondono a stringhe di formato personalizzate definite dalle impostazioni cultura invarianti. Producono rappresentazioni di stringa di valori di data e ora che dovranno essere identiche nelle diverse impostazioni cultura. Nella tabella seguente vengono fornite informazioni su queste quattro stringhe di formato di data e ora standard.

Stringa di formato standard	Definita dalla proprietà DateTimeFormatInfo.InvariantInfo	Stringa di formato personalizzata
"O" o "o"	Nessuno	y'-'MM'-'dd'T'HH':'mm':'ss'. fffffffK
"R" o "r"	RFC1123Pattern	ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s"	SortableDateTimePattern	yyyy'-'MM'-'dd'T'HH':'mm':'ss
"u"	UniversalSortableDateTimePattern	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. 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. È possibile determinare la stringa o le stringhe di formato personalizzate che corrispondono a una stringa di formato standard chiamando il metodo DateTimeFormatInfo.GetAllDateTimePatterns(Char). Nell'esempio seguente vengono visualizzate le stringhe di formato personalizzate che eseguono il mapping alla stringa di formato standard "d" (modello di data breve).

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.

Formati di data

Questo gruppo include i formati seguenti:

Identificatore di formato di breve data ("d")
Identificatore di formato long date ("D")

Identificatore di formato di data breve ("d")

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. La stringa di formato personalizzata restituita dalla proprietà ShortDatePattern della lingua inglese è, ad esempio, "MM/dd/yyyy".

Nella tabella seguente sono elencate le proprietà dell'oggetto DateTimeFormatInfo che consentono di controllare la formattazione della stringa restituita.

Proprietà	Descrizione
ShortDatePattern	Definisce il formato complessivo della stringa di risultato.
DateSeparator	Definisce la stringa che separa i componenti relativi ad anno, mese e giorno di una data.

Nell'esempio seguente viene usato l'identificatore di formato "d" per visualizzare un valore di data e ora.

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

Proprietà	Descrizione
LongDatePattern	Definisce il formato complessivo della stringa di risultato.
DayNames	Definisce i nomi dei giorni localizzati che possono essere visualizzati nella stringa di risultato.
MonthNames	Definisce i nomi dei mesi localizzati che possono essere visualizzati nella stringa di risultato.

Proprietà	Descrizione
LongDatePattern	Definisce il formato del componente relativo alla data della stringa di risultato.
ShortTimePattern	Definisce il formato del componente relativo all'ora della stringa di risultato.
DayNames	Definisce i nomi dei giorni localizzati che possono essere visualizzati nella stringa di risultato.
MonthNames	Definisce i nomi dei mesi localizzati che possono essere visualizzati nella stringa di risultato.
TimeSeparator	Definisce la stringa che separa i componenti relativi a ora, minuti e secondi di un orario.
AMDesignator	Definisce la stringa che indica le ore da mezzanotte a prima di mezzogiorno in un orario in formato 12 ore.
PMDesignator	Definisce la stringa che indica le ore da mezzogiorno a prima di mezzanotte in un orario in formato 12 ore.

Proprietà	Descrizione
FullDateTimePattern	Definisce il formato complessivo della stringa di risultato.
DayNames	Definisce i nomi dei giorni localizzati che possono essere visualizzati nella stringa di risultato.
MonthNames	Definisce i nomi dei mesi localizzati che possono essere visualizzati nella stringa di risultato.
TimeSeparator	Definisce la stringa che separa i componenti relativi a ora, minuti e secondi di un orario.
AMDesignator	Definisce la stringa che indica le ore da mezzanotte a prima di mezzogiorno in un orario in formato 12 ore.
PMDesignator	Definisce la stringa che indica le ore da mezzogiorno a prima di mezzanotte in un orario in formato 12 ore.

Proprietà	Descrizione
ShortDatePattern	Definisce il formato del componente relativo alla data della stringa di risultato.
LongTimePattern	Definisce il formato del componente relativo all'ora della stringa di risultato.
DateSeparator	Definisce la stringa che separa i componenti relativi ad anno, mese e giorno di una data.
TimeSeparator	Definisce la stringa che separa i componenti relativi a ora, minuti e secondi di un orario.
AMDesignator	Definisce la stringa che indica le ore da mezzanotte a prima di mezzogiorno in un orario in formato 12 ore.
PMDesignator	Definisce la stringa che indica le ore da mezzogiorno a prima di mezzanotte in un orario in formato 12 ore.

Proprietà	Descrizione
RFC1123Pattern	Definisce il formato della stringa di risultato.
AbbreviatedDayNames	Definisce i nomi dei giorni abbreviati che possono essere visualizzati nella stringa di risultato.
AbbreviatedMonthNames	Definisce i nomi dei mesi abbreviati che possono essere visualizzati nella stringa di risultato.

Proprietà	Descrizione
MonthDayPattern	Definisce il formato complessivo della stringa di risultato.
MonthNames	Definisce i nomi dei mesi localizzati che possono essere visualizzati nella stringa di risultato.

Proprietà	Descrizione
YearMonthPattern	Definisce il formato complessivo della stringa di risultato.
MonthNames	Definisce i nomi dei mesi localizzati che possono essere visualizzati nella stringa di risultato.

Stringhe di formato di data e ora standard

Tabella degli identificatori di formato

Funzionamento delle stringhe di formato standard

Formati di data

Identificatore di formato di data breve ("d")

Identificatore di formato di data estesa ("D")

Formati di data e ora

Identificatore di formato di ora breve e data completa ("f")

Identificatore di formato di ora estesa e data completa ("F")

Identificatore di formato di ora breve e data generale ("g")

Identificatore di formato di ora estesa e data generale ("G")

Identificatore di formato di round trip ("O", "o")

Identificatore di formato RFC1123 ("R", "r")

Identificatore di formato ordinabile ("s")

Identificatore di formato ordinabile universale ("u")

Identificatore di formato completo universale ("U")

Formati di data/ora

Identificatore di formato di ora breve ("t")

Identificatore di formato di ora estesa ("T")

Formati di data parziale

Identificatore di formato di mese ("M", "m")

Identificatore di formato di mese e anno ("Y", "y")

Impostazioni del Pannello di controllo

Proprietà DateTimeFormatInfo

Vedi anche

Commenti e suggerimenti

Risorse aggiuntive