Stringhe di formato di data e ora standard

Articolo
08/11/2011

Una stringa di formato di data e ora standard utilizza un singolo identificatore di formato per definire la rappresentazione di testo di un valore di data e ora. Le stringhe di formato di data e ora contenenti più caratteri, inclusi gli spazi, vengono interpretate come stringhe di formato di data e ora personalizzate. Per ulteriori informazioni, vedere Stringhe di formato data e ora personalizzate. Una stringa di formato standard o personalizzata può essere utilizzata 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 DateTimeOffset o DateTime da un'operazione di analisi.

Le stringhe di formato di data e ora standard possono essere utilizzate con i valori DateTime e DateTimeOffset.

Suggerimento
È possibile scaricare l'utilità di formattazione, un'applicazione che consente di applicare le stringhe di formato a valori numerici o di data e ora e di visualizzare la stringa di risultato.

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 utilizzato con un valore DateTime o con un valore DateTimeOffset. Per ulteriori informazioni sull'utilizzo di stringhe di formato di data e ora standard, vedere la sezione Note.

Identificatore di formato	Descrizione	Esempi
"d"	Schema di data breve. Ulteriori informazioni: Identificatore di formato di data breve ("d").	6/15/2009 1:45:30 PM -> 6/15/2009 (en-US) 6/15/2009 1:45:30 PM -> 15/06/2009 (fr-FR) 6/15/2009 1:45:30 PM -> 2009/06/15 (ja-JP)
"D"	Schema di data estesa. Ulteriori informazioni: Identificatore di formato di data estesa ("D").	6/15/2009 1:45:30 PM -> Monday, June 15, 2009 (en-US) 6/15/2009 1:45:30 PM -> 15 июня 2009 г. (ru-RU) 6/15/2009 1:45:30 PM -> Montag, 15. Juni 2009 (de-DE)
"f"	Schema di data/ora completa (ora breve). Ulteriori informazioni: Identificatore di formato di ora breve e data completa ("f").	6/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45 PM (en-US) 6/15/2009 1:45:30 PM -> den 15 juni 2009 13:45 (sv-SE) 6/15/2009 1:45:30 PM -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F"	Schema di data/ora completa (ora estesa). Ulteriori informazioni: Identificatore di formato di ora estesa e data completa ("F").	6/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45:30 PM (en-US) 6/15/2009 1:45:30 PM -> den 15 juni 2009 13:45:30 (sv-SE) 6/15/2009 1:45:30 PM -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g"	Schema di data/ora generale (ora breve). Ulteriori informazioni: Identificatore di formato di ora breve e data generale ("g").	6/15/2009 1:45:30 PM -> 6/15/2009 1:45 PM (en-US) 6/15/2009 1:45:30 PM -> 15/06/2009 13:45 (es-ES) 6/15/2009 1:45:30 PM -> 2009/6/15 13:45 (zh-CN)
"G"	Schema di data/ora generale (ora estesa). Ulteriori informazioni: Identificatore di formato di ora estesa e data generale ("G").	6/15/2009 1:45:30 PM -> 6/15/2009 1:45:30 PM (en-US) 6/15/2009 1:45:30 PM -> 15/06/2009 13:45:30 (es-ES) 6/15/2009 1:45:30 PM -> 2009/6/15 13:45:30 (zh-CN)
"M", "m"	Schema di mese/giorno. Ulteriori informazioni: Identificatore di formato di mese ("M", "m").	6/15/2009 1:45:30 PM -> June 15 (en-US) 6/15/2009 1:45:30 PM -> 15. juni (da-DK) 6/15/2009 1:45:30 PM -> 15 Juni (id-ID)
"O", "o"	Schema di data/ora di round trip. Ulteriori informazioni: Identificatore di formato di round trip ("O", "o").	6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30.0900000
"R", "r"	Schema RFC1123. Ulteriori informazioni: Identificatore di formato RFC1123 ("R", "r").	6/15/2009 1:45:30 PM -> Mon, 15 Jun 2009 20:45:30 GMT
"s"	Schema di data/ora ordinabile. Ulteriori informazioni: Identificatore di formato ordinabile ("s").	6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30
"t"	Schema di ora breve. Ulteriori informazioni: Identificatore di formato di ora breve ("t").	6/15/2009 1:45:30 PM -> 1:45 PM (en-US) 6/15/2009 1:45:30 PM -> 13:45 (hr-HR) 6/15/2009 1:45:30 PM -> 01:45 م (ar-EG)
"T"	Schema di ora estesa. Ulteriori informazioni: Identificatore di formato di ora estesa ("T").	6/15/2009 1:45:30 PM -> 1:45:30 PM (en-US) 6/15/2009 1:45:30 PM -> 13:45:30 (hr-HR) 6/15/2009 1:45:30 PM -> 01:45:30 م (ar-EG)
"u"	Schema di data/ora ordinabile universale. Ulteriori informazioni: Identificatore di formato ordinabile universale ("u").	6/15/2009 1:45:30 PM -> 2009-06-15 20:45:30Z
"U"	Schema di data/ora completa universale. Ulteriori informazioni: Identificatore di formato completo universale ("U").	6/15/2009 1:45:30 PM -> Monday, June 15, 2009 8:45:30 PM (en-US) 6/15/2009 1:45:30 PM -> den 15 juni 2009 20:45:30 (sv-SE) 6/15/2009 1:45:30 PM -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)
"Y", "y"	Schema di mese e anno. Ulteriori informazioni: Identificatore di formato di mese e anno ("Y").	6/15/2009 1:45:30 PM -> June, 2009 (en-US) 6/15/2009 1:45:30 PM -> juni 2009 (da-DK) 6/15/2009 1:45:30 PM -> Juni 2009 (id-ID)
Qualsiasi altro carattere singolo	Identificatore sconosciuto.	Genera un evento FormatException in fase di esecuzione.

"d"

Schema di data breve.

Ulteriori informazioni: Identificatore di formato di data breve ("d").

6/15/2009 1:45:30 PM -> 6/15/2009 (en-US)

6/15/2009 1:45:30 PM -> 15/06/2009 (fr-FR)

6/15/2009 1:45:30 PM -> 2009/06/15 (ja-JP)

"D"

Schema di data estesa.

Ulteriori informazioni: Identificatore di formato di data estesa ("D").

6/15/2009 1:45:30 PM -> Monday, June 15, 2009 (en-US)

6/15/2009 1:45:30 PM -> 15 июня 2009 г. (ru-RU)

6/15/2009 1:45:30 PM -> Montag, 15. Juni 2009 (de-DE)

"f"

Schema di data/ora completa (ora breve).

Ulteriori informazioni: Identificatore di formato di ora breve e data completa ("f").

6/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45 PM (en-US)

6/15/2009 1:45:30 PM -> den 15 juni 2009 13:45 (sv-SE)

6/15/2009 1:45:30 PM -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)

"F"

Schema di data/ora completa (ora estesa).

Ulteriori informazioni: Identificatore di formato di ora estesa e data completa ("F").

6/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45:30 PM (en-US)

6/15/2009 1:45:30 PM -> den 15 juni 2009 13:45:30 (sv-SE)

6/15/2009 1:45:30 PM -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)

"g"

Schema di data/ora generale (ora breve).

Ulteriori informazioni: Identificatore di formato di ora breve e data generale ("g").

6/15/2009 1:45:30 PM -> 6/15/2009 1:45 PM (en-US)

6/15/2009 1:45:30 PM -> 15/06/2009 13:45 (es-ES)

6/15/2009 1:45:30 PM -> 2009/6/15 13:45 (zh-CN)

"G"

Schema di data/ora generale (ora estesa).

Ulteriori informazioni: Identificatore di formato di ora estesa e data generale ("G").

6/15/2009 1:45:30 PM -> 6/15/2009 1:45:30 PM (en-US)

6/15/2009 1:45:30 PM -> 15/06/2009 13:45:30 (es-ES)

6/15/2009 1:45:30 PM -> 2009/6/15 13:45:30 (zh-CN)

"M", "m"

Schema di mese/giorno.

Ulteriori informazioni: Identificatore di formato di mese ("M", "m").

6/15/2009 1:45:30 PM -> June 15 (en-US)

6/15/2009 1:45:30 PM -> 15. juni (da-DK)

6/15/2009 1:45:30 PM -> 15 Juni (id-ID)

"O", "o"

Schema di data/ora di round trip.

Ulteriori informazioni: Identificatore di formato di round trip ("O", "o").

6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30.0900000

"R", "r"

Schema RFC1123.

Ulteriori informazioni: Identificatore di formato RFC1123 ("R", "r").

6/15/2009 1:45:30 PM -> Mon, 15 Jun 2009 20:45:30 GMT

"s"

Schema di data/ora ordinabile.

Ulteriori informazioni: Identificatore di formato ordinabile ("s").

6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30

"t"

Schema di ora breve.

Ulteriori informazioni: Identificatore di formato di ora breve ("t").

6/15/2009 1:45:30 PM -> 1:45 PM (en-US)

6/15/2009 1:45:30 PM -> 13:45 (hr-HR)

6/15/2009 1:45:30 PM -> 01:45 م (ar-EG)

"T"

Schema di ora estesa.

Ulteriori informazioni: Identificatore di formato di ora estesa ("T").

6/15/2009 1:45:30 PM -> 1:45:30 PM (en-US)

6/15/2009 1:45:30 PM -> 13:45:30 (hr-HR)

6/15/2009 1:45:30 PM -> 01:45:30 م (ar-EG)

"u"

Schema di data/ora ordinabile universale.

Ulteriori informazioni: Identificatore di formato ordinabile universale ("u").

6/15/2009 1:45:30 PM -> 2009-06-15 20:45:30Z

"U"

Schema di data/ora completa universale.

Ulteriori informazioni: Identificatore di formato completo universale ("U").

6/15/2009 1:45:30 PM -> Monday, June 15, 2009 8:45:30 PM (en-US)

6/15/2009 1:45:30 PM -> den 15 juni 2009 20:45:30 (sv-SE)

6/15/2009 1:45:30 PM -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)

"Y", "y"

Schema di mese e anno.

Ulteriori informazioni: Identificatore di formato di mese e anno ("Y").

6/15/2009 1:45:30 PM -> June, 2009 (en-US)

6/15/2009 1:45:30 PM -> juni 2009 (da-DK)

6/15/2009 1:45:30 PM -> 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'utilizzo 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 utilizzando 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 utilizzate in una di queste modalità:

È possibile utilizzare 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
Dim thisDate As Date = #03/15/2008#
Console.WriteLine(thisDate.ToString("d"))     ' Displays 3/15/2008

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

È possibile passare un oggetto CultureInfo che rappresenta le impostazioni cultura di cui deve essere utilizzata la formattazione a un metodo con un parametro IFormatProvider. 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
Dim thisDate As Date = #03/15/2008#
Dim culture As New CultureInfo("pt-BR")      
Console.WriteLine(thisDate.ToString("d", culture))   ' Displays 15/3/2008

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

È possibile passare un oggetto DateTimeFormatInfo che fornisce informazioni di formattazione a un metodo con un parametro IFormatProvider. Nell'esempio seguente viene visualizzata una data utilizzando il formato di data breve da un oggetto DateTimeFormatInfo per le impostazioni cultura hr-HR.

' 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

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

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"	Nessuna	yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzz
"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 inoltre essere utilizzate nelle operazioni di analisi con i metodi DateTimeOffset.ParseExact o DateTime.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).

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

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

Nelle sezioni seguenti vengono descritti gli identificatori di formato standard per i valori DateTime e DateTimeOffset.

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 utilizzato l'identificatore di formato "d" per visualizzare un valore di data e ora.

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

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

Torna alla tabella

Identificatore di formato di data estesa ("D")

L'identificatore di formato standard "D" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.LongDatePattern corrente. La stringa di formato personalizzata per le impostazioni cultura invarianti ad esempio è "dddd, dd MMMM yyyy".

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

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.

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

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

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

Torna alla tabella

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

L'identificatore di formato standard "f" rappresenta una combinazione degli schemi di data estesa ("D") e ora breve ("t") , separati da uno spazio.

La stringa di risultato è influenzata dalle informazioni sulla formattazione di un oggetto DateTimeFormatInfo specifico. Nella tabella seguente sono elencate le proprietà dell'oggetto DateTimeFormatInfo che consentono di controllare la formattazione della stringa restituita. L'identificatore di formato personalizzato restituito dalle proprietà DateTimeFormatInfo.LongDatePattern e DateTimeFormatInfo.ShortTimePattern di alcune impostazioni cultura potrebbe non prevedere l'utilizzo di tutte le proprietà.

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.

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

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

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

Torna alla tabella

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

L'identificatore di formato standard "F" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.FullDateTimePattern corrente. La stringa di formato personalizzata per le impostazioni cultura invarianti ad esempio è "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. L'identificatore di formato personalizzato restituito dalla proprietà FullDateTimePattern di alcune impostazioni cultura potrebbe non prevedere l'utilizzo di tutte le proprietà.

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.

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

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

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

Torna alla tabella

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

L'identificatore di formato standard "g" rappresenta una combinazione degli schemi di data breve ("d") e ora breve ("t"), separati da uno spazio.

La stringa di risultato è influenzata dalle informazioni sulla formattazione di un oggetto DateTimeFormatInfo specifico. Nella tabella seguente sono elencate le proprietà dell'oggetto DateTimeFormatInfo che consentono di controllare la formattazione della stringa restituita. L'identificatore di formato personalizzato restituito dalle proprietà DateTimeFormatInfo.ShortDatePattern e DateTimeFormatInfo.ShortTimePattern di alcune impostazioni cultura potrebbe non prevedere l'utilizzo di tutte le proprietà.

Proprietà	Descrizione
ShortDatePattern	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.
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.

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

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

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

Torna alla tabella

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

L'identificatore di formato standard "G" rappresenta una combinazione degli schemi di data breve ("d") e ora estesa ("T"), separati da uno spazio.

La stringa di risultato è influenzata dalle informazioni sulla formattazione di un oggetto DateTimeFormatInfo specifico. Nella tabella seguente sono elencate le proprietà dell'oggetto DateTimeFormatInfo che consentono di controllare la formattazione della stringa restituita. L'identificatore di formato personalizzato restituito dalle proprietà DateTimeFormatInfo.ShortDatePattern e DateTimeFormatInfo.LongTimePattern di alcune impostazioni cultura potrebbe non prevedere l'utilizzo di tutte le proprietà.

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.

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

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

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

Torna alla tabella

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

L'identificatore di formato standard "M" o "m" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.MonthDayPattern corrente. La stringa di formato personalizzata per le impostazioni cultura invarianti ad esempio è "MMMM dd".

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

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.

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

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

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

Torna alla tabella

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

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. Per i valori DateTime, questo identificatore di formato è progettato per mantenere valori di data e ora insieme alla proprietà DateTime.Kind nel testo. È possibile analizzare di nuovo la stringa formattata utilizzando il metodo DateTime.Parse(String, IFormatProvider, DateTimeStyles) o DateTime.ParseExact se il parametro styles è impostato su 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. 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. Gli apostrofi non vengono visualizzati nella stringa di output.

Lo schema per questo identificatore riflette uno standard definito (ISO 8601). Sarà pertanto sempre lo stesso, indipendentemente dalle impostazioni cultura utilizzate o dal provider di formato fornito. Le stringhe passate al metodo Parse o ParseExact devono essere esattamente conformi a questo schema di formato personalizzato, altrimenti viene generata un'eccezione FormatException.

Quando viene utilizzato questo identificatore di formato standard, la formattazione o l'operazione di analisi utilizza sempre le impostazioni cultura invarianti.

Nell'esempio seguente viene utilizzato l'identificatore di formato "o" per visualizzare un valore DateTime e un valore DateTimeOffset in un sistema nel fuso orario Pacifico (Stati Uniti).

Dim date1 As Date = #4/10/2008 6:30AM#
Dim dateOffset As New DateTimeOffset(date1, TimeZoneInfo.Local.GetUtcOFfset(date1))
Console.WriteLine(date1.ToString("o"))
' Displays 2008-04-10T06:30:00.0000000                        
Console.WriteLine(dateOffset.ToString("o"))
' Displays 2008-04-10T06:30:00.0000000-07:00

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
DateTimeOffset dateOffset = new DateTimeOffset(date1, 
                            TimeZoneInfo.Local.GetUtcOffset(date1));
Console.WriteLine(date1.ToString("o"));
// Displays 2008-04-10T06:30:00.0000000                        
Console.WriteLine(dateOffset.ToString("o"));
// Displays 2008-04-10T06:30:00.0000000-07:00

Nell'esempio seguente viene utilizzato 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.

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

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

Torna alla tabella

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

L'identificatore di formato standard "R" o "r" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.RFC1123Pattern corrente. Lo schema riflette uno standard definito e la proprietà è di sola lettura. Pertanto sarà sempre lo stesso, indipendentemente dalle impostazioni cultura utilizzate o dal provider di formato fornito. La stringa di formato personalizzata è "ddd, dd MMM yyyy HH':'mm':'ss 'GMT". Quando viene utilizzato questo identificatore di formato standard, la formattazione o l'operazione di analisi utilizza sempre le impostazioni cultura invarianti.

La stringa di risultato è influenzata dalle proprietà seguenti dell'oggetto DateTimeFormatInfo restituito dalla proprietà DateTimeFormatInfo.InvariantInfo che rappresenta la lingua inglese.

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.

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 o DateTimeOffset che viene formattato. L'applicazione deve pertanto convertire il valore di data e ora in formato UTC prima di eseguire l'operazione di formattazione. Per eseguire questa conversione, i valori DateTime possono chiamare il metodo DateTime.ToUniversalTime e i valori DateTimeOffset possono chiamare il metodo ToUniversalTime.

Nell'esempio seguente viene utilizzato l'identificatore di formato "r" per visualizzare un valore DateTime e un valore DateTimeOffset in un sistema nel fuso orario Pacifico (Stati Uniti).

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

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

Torna alla tabella

Identificatore di formato ordinabile ("s")

L'identificatore di formato standard "s" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.SortableDateTimePattern corrente. Lo schema riflette uno standard definito (ISO 8601) e la proprietà è di sola lettura. Pertanto sarà sempre lo stesso, indipendentemente dalle impostazioni cultura utilizzate o dal provider di formato fornito. La stringa di formato personalizzata è "yyyy'-'MM'-'dd'T'HH':'mm':'ss".

Quando viene utilizzato questo identificatore di formato standard, la formattazione o l'operazione di analisi utilizza sempre le impostazioni cultura invarianti.

Nell'esempio seguente viene utilizzato l'identificatore di formato "s" per visualizzare un valore DateTime e un valore DateTimeOffset in un sistema nel fuso orario Pacifico (Stati Uniti).

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

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

Torna alla tabella

Identificatore di formato di ora breve ("t")

L'identificatore di formato standard "t" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.ShortTimePattern corrente. La stringa di formato personalizzata per le impostazioni cultura invarianti ad esempio è "HH:mm".

La stringa di risultato è influenzata dalle informazioni sulla formattazione di un oggetto DateTimeFormatInfo specifico. Nella tabella seguente sono elencate le proprietà dell'oggetto DateTimeFormatInfo che consentono di controllare la formattazione della stringa restituita. L'identificatore di formato personalizzato restituito dalla proprietà DateTimeFormatInfo.ShortTimePattern di alcune impostazioni cultura potrebbe non prevedere l'utilizzo di tutte le proprietà.

Proprietà	Descrizione
ShortTimePattern	Definisce il formato del componente relativo all'ora della 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.

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

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

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

Torna alla tabella

Identificatore di formato di ora estesa ("T")

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. La stringa di formato personalizzata per le impostazioni cultura invarianti ad esempio è "HH:mm:ss".

Nella tabella seguente sono elencate le proprietà dell'oggetto DateTimeFormatInfo che consentono di controllare la formattazione della stringa restituita. L'identificatore di formato personalizzato restituito dalla proprietà DateTimeFormatInfo.LongTimePattern di alcune impostazioni cultura potrebbe non prevedere l'utilizzo di tutte le proprietà.

Proprietà	Descrizione
LongTimePattern	Definisce il formato del componente relativo all'ora della 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.

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

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

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

Torna alla tabella

Identificatore di formato ordinabile universale ("u")

L'identificatore di formato standard "u" rappresenta una stringa di formato di data e ora personalizzata definita dalla proprietà DateTimeFormatInfo.UniversalSortableDateTimePattern corrente. Lo schema riflette uno standard definito e la proprietà è di sola lettura. Pertanto sarà sempre lo stesso, indipendentemente dalle impostazioni cultura utilizzate o dal provider di formato fornito. La stringa di formato personalizzata è "yyyy'-'MM'-'dd HH':'mm':'ss'Z". Quando viene utilizzato questo identificatore di formato standard, la formattazione o l'operazione di analisi utilizza sempre le impostazioni cultura invarianti.

Sebbene la stringa di risultato debba esprimere un'ora in formato UTC (Coordinated Universal Time), non viene eseguita alcuna conversione del valore DateTime o DateTimeOffset originale durante l'operazione di formattazione. L'applicazione deve pertanto convertire il valore di data e ora in formato UTC prima di formattarlo. Per eseguire questa conversione, i valori DateTime possono chiamare il metodo DateTime.ToUniversalTime e i valori DateTimeOffset possono chiamare il metodo ToUniversalTime.

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

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

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

Torna alla tabella

Identificatore di formato completo universale ("U")

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. Lo schema corrisponde a quello di "F". Il valore DateTime, tuttavia, viene convertito automaticamente in formato UTC prima di essere formattato.

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.

L'identificatore di formato "U" non è supportato dal tipo DateTimeOffset e genera un evento FormatException se viene utilizzato per formattare un valore DateTimeOffset.

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

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

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

Torna alla tabella

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

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. La stringa di formato personalizzata per le impostazioni cultura invarianti ad esempio è "yyyy MMMM".

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

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.

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

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

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

Torna alla tabella

Note

Impostazioni del Pannello di controllo

Le impostazioni di Opzioni internazionali e della lingua nel Pannello di controllo influiscono sulla stringa risultato prodotta da un'operazione di formattazione. Queste impostazioni vengono utilizzate per inizializzare l'oggetto DateTimeFormatInfo associato alle impostazioni cultura del thread corrente, che fornisce i valori utilizzati per definire la formattazione. Computer con impostazioni diverse generano stringhe di risultato diverse.

Se inoltre viene utilizzato 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. È possibile utilizzare il costruttore di CultureInfo.CultureInfo(String, Boolean) per creare un oggetto CultureInfo che non rifletta le personalizzazioni di un sistema.

Proprietà DateTimeFormatInfo

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. 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. Molti degli identificatori di formato di data e ora standard sono alias di schemi di formattazione definiti dalle proprietà dell'oggetto DateTimeFormatInfo corrente. 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.

Vedere anche

Concetti

Formattazione dei tipi di dati

Stringhe di formato data e ora personalizzate

Cronologia delle modifiche

Data	Cronologia	Motivo
Luglio 2010	Sono state aggiunte informazioni sulle stringhe di formato standard nelle operazioni di analisi.	Commenti e suggerimenti dei clienti.
Marzo 2011	Aggiunta di un collegamento all'utilità di formattazione.	Miglioramento delle informazioni.

Luglio 2010

Sono state aggiunte informazioni sulle stringhe di formato standard nelle operazioni di analisi.

Commenti e suggerimenti dei clienti.

Marzo 2011

Aggiunta di un collegamento all'utilità di formattazione.

Miglioramento delle informazioni.

Share via

Stringhe di formato di data e ora standard

Funzionamento delle stringhe di formato standard

Identificatore di formato di data breve ("d")

Identificatore di formato di data estesa ("D")

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 mese ("M", "m")

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

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

Identificatore di formato ordinabile ("s")

Identificatore di formato di ora breve ("t")

Identificatore di formato di ora estesa ("T")

Identificatore di formato ordinabile universale ("u")

Identificatore di formato completo universale ("U")

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

Note

Impostazioni del Pannello di controllo

Proprietà DateTimeFormatInfo

Vedere anche

Concetti

Cronologia delle modifiche

Risorse aggiuntive