Stringhe di formato data e ora standard

Una stringa di formato di data e ora standard usa un singolo carattere come identificatore di formato per definire la rappresentazione testuale di un DateTimevalore , DateTimeOffset, DateOnlyo TimeOnly . 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 testuale di un valore di data e ora che può essere convertito in un DateTimevalore , DateTimeOffset, DateOnlyo TimeOnly da un'operazione di analisi.

Suggerimento

È possibile scaricare Utilità formattazione, un'applicazione Windows Form .NET 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.

Tabella degli identificatori di formato

Nella tabella seguente vengono descritti gli identificatori di formato di data e ora standard. Se non diversamente specificato, un particolare identificatore di formato di data e ora standard produce una rappresentazione di stringa identica indipendentemente dal fatto che venga usato con un DateTime valore o .DateTimeOffset Non tutti gli identificatori di formato possono essere usati con DateOnly i valori e TimeOnly . Per altre informazioni, vedere Formattazione DateOnly e TimeOnly. Per informazioni su come le impostazioni internazionali in Windows e l'oggetto corrente DateTimeFormatInfo possono influire sulla formattazione di data e ora, vedere Impostazioni del Pannello di controllo e Proprietà DateTimeFormatInfo.

Identificatore di formato	Description	Esempi
"d"	Modello 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) DateOnly (2009-06-15) -> 15/6/2009 (en-US)
"D"	Modello 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 -> Lunedì, 15. Juni 2009 (de-DE)
"f"	Modello di data/ora completo (ora breve). Altre informazioni: identificatore di formato di data breve ("f") di data completa.	2009-06-15T13:45:30 -> Lunedì, 15 giugno 2009 1:45 (en-US) 2009-06-15T13:45:30 -> il 15 giugno 2009 13:45 (sv-SE) 2009-06-15T13:45:30 -> Ιεατιρα, 15 Ιοιτοι 2009 1:45 μμ (el-GR)
"F"	Modello di data/ora completo (long time). Altre informazioni: identificatore di formato di data estesa ("F").	2009-06-15T13:45:30 -> Lunedì, 15 giugno 2009 1:45:30 (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"	Modello di data/ora generale (ora breve). Altre informazioni: Identificatore di formato di data breve ("g") generale.	2009-06-15T13:45:30 -> 15/06/2009 1:45 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (zh-CN)
"G"	Modello di data/ora generale (long time). 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"	Modello mese/giorno. Altre informazioni: Identificatore di formato mese ("M", "m").	2009-06-15T13:45:30 -> 15 giugno (en-US) 2009-06-15T13:45:30 -> 15. giugno (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").	DateTime valori: 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.00000000 DateTimeOffset valori: 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00 DateOnly valori: 2009-06-15 --> 2009-06-15 TimeOnly valori: 13:45:30 --> 13:45:30.00000000
"R", "r"	RFC1123 modello. 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"	Modello 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"	Modello di tempo breve. Altre informazioni: identificatore di formato di breve durata ("t").	2009-06-15T13:45:30 -> 1:45 (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG) TimeOnly (13:45:30) -> 13:45 (en-US)
"T"	Modello di tempo lungo. Altre informazioni: identificatore di formato "T").	2009-06-15T13:45:30 -> 1:45:30 (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 2009-06-15T13:45:30 -> 01:45:30 PM (ar-EG) TimeOnly (13:45:30) -> 13:45:30 (en-US)
"u"	Modello di data/ora ordinabile universale. Altre informazioni: identificatore di formato ordinabile universale ("u").	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"	Modello di data/ora completo universale. Altre informazioni: identificatore di formato completo universale ("U").	2009-06-15T13:45:30 -> Lunedì, 15 giugno 2009 8:45:30 (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"	Modello mese anno. Altre informazioni: Identificatore di formato mese dell'anno ("Y").	2009-06-15T13:45:30 -> Giugno 2009 (en-US) 2009-06-15T13:45:30 -> giugno 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Qualsiasi altro carattere singolo	Identificatore sconosciuto.	Genera un runtime FormatException.

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 è che, anche se l'alias rimane invariante, la stringa di formato personalizzata può variare. Questo aspetto è importante perché le rappresentazioni di stringa dei valori di data e ora variano in genere in base alle impostazioni cultura. Ad esempio, la stringa di formato standard "d" indica che un valore di data e ora deve essere visualizzato usando un modello di data breve. Per le impostazioni cultura invarianti, questo modello è "MM/gg/aa". Per le impostazioni cultura fr-FR, è "dd/MM/aaaa". Per le impostazioni cultura ja-JP, è "aaaa/MM/gg".

Se una stringa di formato standard in un'operazione di formattazione esegue il mapping alla stringa di formato personalizzata di una determinata cultura, l'applicazione può definire le impostazioni cultura specifiche le cui stringhe di formato personalizzate vengono usate in uno dei modi seguenti:

È possibile usare le impostazioni cultura predefinite (o correnti). Nell'esempio seguente viene visualizzata una data utilizzando 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 CultureInfo oggetto che rappresenta le impostazioni cultura la cui formattazione deve essere utilizzata per un metodo con un IFormatProvider parametro . Nell'esempio seguente viene visualizzata una data utilizzando 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 DateTimeFormatInfo oggetto che fornisce informazioni di formattazione a un metodo con un IFormatProvider parametro . Nell'esempio seguente viene visualizzata una data utilizzando il formato di data breve di un DateTimeFormatInfo oggetto 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

Annotazioni

Per informazioni sulla personalizzazione dei modelli o delle stringhe usate nella formattazione dei valori di data e ora, vedere l'argomento relativo alla NumberFormatInfo classe.

In alcuni casi, la stringa di formato standard funge da abbreviazione pratica per una stringa di formato personalizzata più lunga che è invariante. Quattro stringhe di formato standard rientrano in questa categoria: "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 devono essere identici tra le impostazioni cultura. Nella tabella seguente vengono fornite informazioni su queste quattro stringhe di formato di data e ora standard.

Stringa di formato standard	Definito dalla proprietà DateTimeFormatInfo.InvariantInfo	Stringa di formato personalizzata
"O" o "o"	None	aaaa'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffK
"R" o "r"	RFC1123Pattern	ddd, gg MMM aaA HH':'mm':'ss 'GMT'
"s"	SortableDateTimePattern	Aaaa'-'MM'-'dd'T'HH':'mm':'ss
"u"	UniversalSortableDateTimePattern	Aaaa'-'MM'-'dd HH':'mm':'ss'Z'

Le stringhe di formato standard possono essere usate anche nelle operazioni di analisi con i DateTime.ParseExactmetodi , DateTimeOffset.ParseExact, DateOnly.ParseExacte TimeOnly.ParseExact , che richiedono che una stringa di input sia esattamente conforme a un modello specifico per l'esito positivo dell'operazione di analisi. Molte stringhe di formato standard eseguono il mapping a più stringhe di formato personalizzate, pertanto un valore di data e ora può essere rappresentato in un'ampia gamma di formati e l'operazione di analisi avrà comunque esito positivo. È possibile determinare la stringa di formato o le stringhe di formato personalizzate che corrispondono a una stringa di formato standard chiamando il DateTimeFormatInfo.GetAllDateTimePatterns(Char) metodo . Nell'esempio seguente vengono visualizzate le stringhe di formato personalizzate mappate 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($"   {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

Le sezioni seguenti descrivono gli identificatori di formato standard per DateTimei valori , DateTimeOffset DateOnly, e TimeOnly .

Formati di data

Questo gruppo include i formati seguenti:

Identificatore di formato data breve ("d")
Identificatore di formato data lunga ("D")

Identificatore di formato data breve ("d")

L'identificatore di formato standard "d" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà delle DateTimeFormatInfo.ShortDatePattern impostazioni cultura specifiche. Ad esempio, la stringa di formato personalizzata restituita dalla ShortDatePattern proprietà delle impostazioni cultura invarianti è "MM/gg/a".

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

Proprietà	Description
ShortDatePattern	Definisce il formato complessivo della stringa di risultato.
DateSeparator	Definisce la stringa che separa i componenti 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à	Description
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à	Description
LongDatePattern	Definisce il formato del componente data della stringa di risultato.
ShortTimePattern	Definisce il formato del componente time 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 hour, minute e second di un'ora.
AMDesignator	Definisce la stringa che indica le ore da mezzanotte a mezzogiorno in un orologio di 12 ore.
PMDesignator	Definisce la stringa che indica le ore da mezzogiorno a prima di mezzanotte in un orologio di 12 ore.

Proprietà	Description
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 hour, minute e second di un'ora.
AMDesignator	Definisce la stringa che indica le ore da mezzanotte a mezzogiorno in un orologio di 12 ore.
PMDesignator	Definisce la stringa che indica le ore da mezzogiorno a prima di mezzanotte in un orologio di 12 ore.

Proprietà	Description
ShortDatePattern	Definisce il formato del componente data della stringa di risultato.
LongTimePattern	Definisce il formato del componente time della stringa di risultato.
DateSeparator	Definisce la stringa che separa i componenti anno, mese e giorno di una data.
TimeSeparator	Definisce la stringa che separa i componenti hour, minute e second di un'ora.
AMDesignator	Definisce la stringa che indica le ore da mezzanotte a mezzogiorno in un orologio di 12 ore.
PMDesignator	Definisce la stringa che indica le ore da mezzogiorno a prima di mezzanotte in un orologio di 12 ore.

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

Proprietà	Description
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à	Description
YearMonthPattern	Definisce il formato complessivo della stringa di risultato.
MonthNames	Definisce i nomi dei mesi localizzati che possono essere visualizzati nella stringa di risultato.

Condividi tramite

Stringhe di formato data e ora standard

Tabella degli identificatori di formato

Funzionamento delle stringhe di formato standard

Formati di data

Identificatore di formato data breve ("d")

Identificatore di formato data lunga ("D")

Formati di data e ora

Identificatore di formato full date short time ("f")

Identificatore di formato full date long time ("F")

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

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

Identificatore di formato 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 ora

Identificatore di formato breve ("t")

Identificatore di formato long time ("T")

Formati di data parziale

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

Identificatore di formato year month ("Y", "y")

Formattazione DateOnly e TimeOnly

Impostazioni del Pannello di controllo

Proprietà DateTimeFormatInfo

Vedere anche

Commenti e suggerimenti

Risorse aggiuntive