Share via


Stringhe di formato data e ora personalizzate

Aggiornamento: novembre 2007

Una stringa di formato di data e ora personalizzato definisce la rappresentazione di testo di un valore DateTime o DateTimeOffset derivante da un'operazione di formattazione. La stringa di formato personalizzato è costituita da uno o più identificatori di formato di data e ora personalizzati. Qualsiasi stringa diversa da una stringa di formato di data e ora standard viene interpretata come stringa di formato di data e ora personalizzato.

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

Identificatori di formato di data e ora personalizzato

Nella tabella riportata di seguito vengono descritti gli identificatori di formato di data e ora personalizzato. Se non specificato diversamente, un particolare identificatore di formato di data e ora personalizzato genera una rappresentazione di stringa identica, sia che venga utilizzato con un valore DateTime o con un valore DateTimeOffset.

Identificatore di formato

Descrizione

d

Rappresenta il giorno del mese come numero compreso tra 1 e 31. I giorni costituiti da una singola cifra vengono formattati senza zero iniziale. Per ulteriori informazioni sull'utilizzo di un singolo identificatore di formato personalizzato, vedere Utilizzo di singoli identificatori di formato personalizzato.

Nell'esempio seguente l'identificatore di formato personalizzato d viene incluso in diverse stringhe di formato.

Dim date1 As Date = #08/29/2008 7:27:15PM#
Console.WriteLine(date1.ToString("d, M", _
CultureInfo.InvariantCulture))
' Displays 29, 8
Console.WriteLine(date1.ToString("d MMMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays 29 August
Console.WriteLine(date1.ToString("d MMMM", _
CultureInfo.CreateSpecificCulture("es-MX")))
' Displays 29 agosto
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);
Console.WriteLine(date1.ToString("d, M",
CultureInfo.InvariantCulture));
// Displays 29, 8
Console.WriteLine(date1.ToString("d MMMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays 29 August
Console.WriteLine(date1.ToString("d MMMM",
CultureInfo.CreateSpecificCulture("es-MX")));
// Displays 29 agosto

dd

Rappresenta il giorno del mese come numero compreso tra 01 e 31. I giorni costituiti da una singola cifra vengono formattati con uno zero iniziale. Nell'esempio seguente l'identificatore di formato personalizzato dd viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = #1/2/2008 6:30:15AM#
Console.WriteLine(date1.ToString("dd, MM", _
CultureInfo.InvariantCulture))
' 02, 01
DateTime date1 = new DateTime(2008, 1, 2, 6, 30, 15);
Console.WriteLine(date1.ToString("dd, MM",
CultureInfo.InvariantCulture));
// 02, 01

ddd

Rappresenta il nome abbreviato del giorno della settimana come definito nella proprietà DateTimeFormatInfo.AbbreviatedDayNames corrente. Nell'esempio seguente l'identificatore di formato personalizzato ddd viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = #08/29/2008 7:27:15PM#
Console.WriteLine(date1.ToString("ddd d MMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays Fri 29 Aug
Console.WriteLine(date1.ToString("ddd d MMM", _
CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays ven. 29 aot
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);
Console.WriteLine(date1.ToString("ddd d MMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays Fri 29 Aug
Console.WriteLine(date1.ToString("ddd d MMM",
CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays ven. 29 aot

dddd (più un numero qualsiasi di identificatori d aggiuntivi)

Rappresenta il nome completo del giorno della settimana come definito nella proprietà DateTimeFormatInfo.DayNames corrente. Nell'esempio seguente l'identificatore di formato personalizzato dddd viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = #08/29/2008 7:27:15PM#
Console.WriteLine(date1.ToString("dddd dd MMMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays Friday 29 August
Console.WriteLine(date1.ToString("dddd dd MMMM", _
CultureInfo.CreateSpecificCulture("it-IT")))
' Displays venerd 29 agosto
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);
Console.WriteLine(date1.ToString("dddd dd MMMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays Friday 29 August
Console.WriteLine(date1.ToString("dddd dd MMMM",
CultureInfo.CreateSpecificCulture("it-IT")));
// Displays venerd 29 agosto

f

Rappresenta la cifra più significativa della frazione di secondi, ovvero i decimi di secondo in un valore di data e ora.

Se l'identificatore di formato f viene utilizzato senza altri identificatori di formato,viene interpretato come l'identificatore di formato di data e ora standard f. Per ulteriori informazioni sull'utilizzo di un solo identificatore di formato, vedere Utilizzo di singoli identificatori di formato personalizzato.

In caso di utilizzo come parte di una stringa di formato fornita ai metodi ParseExact, TryParseExact, ParseExact o TryParseExact, il numero di identificatori di formato f utilizzato indica il numero di cifre più significative della frazione di secondi che deve essere presente per analizzare correttamente la stringa.

Nell'esempio seguente l'identificatore di formato personalizzato f viene incluso in una stringa di formato personalizzato.

Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018

ff

Rappresenta le due cifre più significative della frazione di secondi, ovvero i centesimi di secondo in un valore di data e ora. Nell'esempio seguente l'identificatore di formato personalizzato ff viene incluso in una stringa di formato personalizzato.

Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018

fff

Rappresenta le tre cifre più significative della frazione di secondi, ovvero i millisecondi in un valore di data e ora. Nell'esempio seguente l'identificatore di formato personalizzato fff viene incluso in una stringa di formato personalizzato.

Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018

ffff

Rappresenta le quattro cifre più significative della frazione di secondi, ovvero i decimillesimi di secondo in un valore di data e ora.

Mentre è possibile visualizzare i decimillesimi di un componente secondi di un valore di data e ora, tale valore potrebbe non essere significativo. La precisione dei valori di data e ora dipende dalla risoluzione del clock di sistema. In Windows NT 3.5 e versioni successive e nei sistemi operativi Windows Vista la risoluzione del clock è di circa 10-15 millisecondi.

fffff

Rappresenta le cinque cifre più significative della frazione di secondi, ovvero i centomillesimi di secondo in un valore di data e ora.

Mentre è possibile visualizzare i centomillesimi di un componente secondi di un valore di data e ora, tale valore potrebbe non essere significativo. La precisione dei valori di data e ora dipende dalla risoluzione del clock di sistema. In Windows NT 3.5 e versioni successive e nei sistemi operativi Windows Vista la risoluzione del clock è di circa 10-15 millisecondi.

ffffff

Rappresenta le sei cifre più significative della frazione di secondi, ovvero i milionesimi di secondo in un valore di data e ora.

Mentre è possibile visualizzare i milionesimi di un componente secondi di un valore di data e ora, tale valore potrebbe non essere significativo. La precisione dei valori di data e ora dipende dalla risoluzione del clock di sistema. In Windows NT 3.5 e versioni successive e nei sistemi operativi Windows Vista la risoluzione del clock è di circa 10-15 millisecondi.

fffffff

Rappresenta le sette cifre più significative della frazione di secondi, ovvero i decimilionesimi di secondo in un valore di data e ora.

Mentre è possibile visualizzare i decimilionesimi di un componente secondi di un valore di data e ora, tale valore potrebbe non essere significativo. La precisione dei valori di data e ora dipende dalla risoluzione del clock di sistema. In Windows NT 3.5 e versioni successive e nei sistemi operativi Windows Vista la risoluzione del clock è di circa 10-15 millisecondi.

F

Rappresenta la cifra più significativa della frazione di secondi, ovvero i decimi di secondo in un valore di data e ora. Se la cifra è zero, non viene prodotta alcuna visualizzazione.

Se l'identificatore di formato F viene utilizzato senza altri identificatori di formato, viene interpretato come l'identificatore di formato di data e ora standard F. Per ulteriori informazioni sull'utilizzo di un solo identificatore di formato, vedere Utilizzo di singoli identificatori di formato personalizzato.

Il numero di identificatoti di formato F utilizzato con i metodi ParseExact, TryParseExact, ParseExact o TryParseExact indica il numero massimo di cifre più significative della frazione di secondi che può essere presente per analizzare correttamente la stringa.

Nell'esempio seguente l'identificatore di formato personalizzato F viene incluso in una stringa di formato personalizzato.

Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018

FF

Rappresenta le due cifre più significative della frazione di secondi, ovvero i centesimi di secondo in un valore di data e ora. Gli zeri finali o le cifre con due zeri non vengono tuttavia visualizzate. Nell'esempio seguente l'identificatore di formato personalizzato FF viene incluso in una stringa di formato personalizzato.

Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018

FFF

Rappresenta le tre cifre più significative della frazione di secondi ovvero i millisecondi in un valore di data e ora. Gli zeri finali o le cifre con tre zeri non vengono tuttavia visualizzate. Nell'esempio seguente l'identificatore di formato personalizzato FFF viene incluso in una stringa di formato personalizzato.

Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018

FFFF

Rappresenta le quattro cifre più significative della frazione di secondi ovvero i decimillesimi di secondo in un valore di data e ora. Gli zeri finali o le cifre con quattro zeri non vengono tuttavia visualizzate.

Mentre è possibile visualizzare i decimillesimi di un componente secondi di un valore di data e ora, tale valore potrebbe non essere significativo. La precisione dei valori di data e ora dipende dalla risoluzione del clock di sistema. In Windows NT 3.5 e versioni successive e nei sistemi operativi Windows Vista la risoluzione del clock è di circa 10-15 millisecondi.

FFFFF

Rappresenta le cinque cifre più significative della frazione di secondi ovvero i centomillesimi di secondo in un valore di data e ora. Gli zeri finali o le cifre con cinque zeri non vengono tuttavia visualizzate.

Mentre è possibile visualizzare i centomillesimi di un componente secondi di un valore di data e ora, tale valore potrebbe non essere significativo. La precisione dei valori di data e ora dipende dalla risoluzione del clock di sistema. In Windows NT 3.5 e versioni successive e nei sistemi operativi Windows Vista la risoluzione del clock è di circa 10-15 millisecondi.

FFFFFF

Rappresenta le sei cifre più significative della frazione di secondi ovvero i milionesimi di secondo in un valore di data e ora. Gli zeri finali o le cifre con sei zeri non vengono visualizzate.

Mentre è possibile visualizzare i milionesimi di un componente secondi di un valore di data e ora, tale valore potrebbe non essere significativo. La precisione dei valori di data e ora dipende dalla risoluzione del clock di sistema. In Windows NT 3.5 e versioni successive e nei sistemi operativi Windows Vista la risoluzione del clock è di circa 10-15 millisecondi.

FFFFFFF

Rappresenta le sette cifre più significative della frazione di secondi ovvero i decimilionesimi di secondo in un valore di data e ora. Gli zeri finali o le cifre con sette zeri non vengono tuttavia visualizzate.

Mentre è possibile visualizzare i decimilionesimi di un componente secondi di un valore di data e ora, tale valore potrebbe non essere significativo. La precisione dei valori di data e ora dipende dalla risoluzione del clock di sistema. In Windows NT 3.5 e versioni successive e nei sistemi operativi Windows Vista la risoluzione del clock è di circa 10-15 millisecondi.

g, gg (più un numero qualsiasi di identificatori g aggiuntivi)

Rappresenta il periodo o l'era, ad esempio d.C. Questo identificatore viene ignorato dalla formattazione se la data da formattare non è associata a una stringa di periodo o di era. Per ulteriori informazioni sull'utilizzo di un solo identificatore di formato, vedere Utilizzo di singoli identificatori di formato personalizzato.

Nell'esempio seguente l'identificatore di formato personalizzato g viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = #08/04/0070#
Console.WriteLine(date1.ToString("MM/dd/yyyy g", _
CultureInfo.InvariantCulture))
' Displays 08/04/0070 A.D.
Console.WriteLine(date1.ToString("MM/dd/yyyy g", _
CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays 08/04/0070 ap. J.-C.
DateTime date1 = new DateTime(70, 08, 04);
Console.WriteLine(date1.ToString("MM/dd/yyyy g",
CultureInfo.InvariantCulture));
// Displays 08/04/0070 A.D.
Console.WriteLine(date1.ToString("MM/dd/yyyy g",
CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays 08/04/0070 ap. J.-C.

h

Rappresenta l'ora come numero compreso tra 1 e 12, ovvero l'ora rappresentata nel formato delle 12 ore in base al quale il conteggio riparte da mezzanotte o da mezzogiorno. Una particolare ora dopo mezzanotte non è distinguibile dalla stessa ora dopo mezzogiorno. L'ora non viene arrotondata e se è costituita da una singola cifra viene formattata senza zero iniziale. Ad esempio, per un valore 5.43 questo identificatore di formato personalizzato visualizza "5". Per ulteriori informazioni sull'utilizzo di un solo identificatore di formato, vedere Utilizzo di singoli identificatori di formato personalizzato.

Nell'esempio seguente l'identificatore di formato personalizzato h viene incluso in una stringa di formato personalizzato.

Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5

hh, hh (più un numero qualsiasi di identificatori h aggiuntivi)

Rappresenta l'ora come numero compreso tra 01 e 12, ovvero l'ora rappresentata nel formato delle 12 ore in base al quale il conteggio riparte da mezzanotte o da mezzogiorno. Una particolare ora dopo mezzanotte non è distinguibile dalla stessa ora dopo mezzogiorno. L'ora non viene arrotondata e se è costituita da una singola cifra viene formattata con uno zero iniziale. Per un valore 5:43 ad esempio questo identificatore di formato visualizza "05".

Nell'esempio seguente l'identificatore di formato personalizzato hh viene incluso in una stringa di formato personalizzato.

Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.

H

Rappresenta l'ora come numero compreso tra 0 e 23, ovvero l'ora rappresentata nel formato delle 24 ore in base zero in cui il conteggio parte da mezzanotte. Un'ora costituita da una singola cifra viene formattata senza zero iniziale.

Per ulteriori informazioni sull'utilizzo di un solo identificatore di formato, vedere Utilizzo di singoli identificatori di formato personalizzato.

Nell'esempio seguente l'identificatore di formato personalizzato H viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = #6:09:01AM#
Console.WriteLine(date1.ToString("H:mm:ss", _
CultureInfo.InvariantCulture))
' Displays 6:09:01
DateTime date1 = new DateTime(2008, 1, 1, 6, 9, 1);
Console.WriteLine(date1.ToString("H:mm:ss",
CultureInfo.InvariantCulture));
// Displays 6:09:01

HH, HH (più un numero qualsiasi di identificatori H aggiuntivi)

Rappresenta l'ora come numero compreso tra 00 e 23, ovvero l'ora rappresentata nel formato delle 24 ore in base zero in cui il conteggio parte da mezzanotte. Un'ora costituita da una singola cifra viene formattata con uno zero iniziale. Nell'esempio seguente l'identificatore di formato personalizzato HH viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = #6:09:01AM#
Console.WriteLine(date1.ToString("HH:mm:ss", _
CultureInfo.InvariantCulture))
' Displays 06:09:01
DateTime date1 = new DateTime(2008, 1, 1, 6, 9, 1);
Console.WriteLine(date1.ToString("HH:mm:ss",
CultureInfo.InvariantCulture));
// Displays 06:09:01

K

Rappresenta le informazioni sul fuso orario di un valore di data e ora. In caso di utilizzo con valori DateTime, la stringa di risultato viene definita dal valore della proprietà DateTime.Kind. Per il fuso orario locale (un valore della proprietà DateTime.Kind di DateTimeKind.Local) questo identificatore è equivalente all'identificatore zzz e genera una stringa di risultato che contiene l'offset locale rispetto all'ora UTC, ad esempio "-07.00". Per un'ora UTC (un valore della proprietà DateTime.Kind di DateTimeKind.Utc) la stringa di risultato include un carattere "Z" per rappresentare una data UTC. Per un'ora da un fuso orario non specificato (un'ora la cui proprietà DateTime.Kind è uguale a DateTimeKind.Unspecified) il risultato è equivalente a String.Empty. Per i valori DateTimeOffset l'identificatore di formato K è equivalente all'identificatore di formato zz e genera una stringa di risultato che contiene l'offset del valore DateTimeOffset rispetto a UTC.

Per ulteriori informazioni sull'utilizzo di un solo identificatore di formato, vedere Utilizzo di singoli identificatori di formato personalizzato.

Nell'esempio seguente viene visualizzata la stringa risultante dall'utilizzo dell'identificatore di formato personalizzato K con vari valori DateTime e DateTimeOffset in un sistema nel fuso Ora solare Pacifico (Stati Uniti).

Console.WriteLine(Date.Now.ToString("%K"))
' Displays -07:00
Console.WriteLine(Date.UtcNow.ToString("%K"))
' Displays Z
Console.WriteLine("'{0}'", _
Date.SpecifyKind(Date.Now, _
DateTimeKind.Unspecified). _
ToString("%K"))
' Displays ''
Console.WriteLine(DateTimeOffset.Now.ToString("%K"))
' Displays -07:00
Console.WriteLine(DateTimeOffset.UtcNow.ToString("%K"))
' Displays +00:00
Console.WriteLine(New DateTimeOffset(2008, 5, 1, 6, 30, 0, _
New TimeSpan(5, 0, 0)). _
ToString("%K"))
' Displays +05:00
Console.WriteLine(DateTime.Now.ToString("%K"));
// Displays -07:00
Console.WriteLine(DateTime.UtcNow.ToString("%K"));
// Displays Z
Console.WriteLine("'{0}'",
DateTime.SpecifyKind(DateTime.Now,
DateTimeKind.Unspecified).ToString("%K"));
// Displays ''
Console.WriteLine(DateTimeOffset.Now.ToString("%K"));
// Displays -07:00
Console.WriteLine(DateTimeOffset.UtcNow.ToString("%K"));
// Displays +00:00
Console.WriteLine(new DateTimeOffset(2008, 5, 1, 6, 30, 0,
new TimeSpan(5, 0, 0)).ToString("%K"));
// Displays +05:00

m

Rappresenta il minuto come numero compreso tra 0 e 59. Il minuto rappresenta minuti interi trascorsi dall'ultima ora. Un minuto costituito da una singola cifra viene formattato senza zero iniziale. Per ulteriori informazioni sull'utilizzo di un solo identificatore di formato, vedere Utilizzo di singoli identificatori di formato personalizzato. Nell'esempio seguente l'identificatore di formato personalizzato m viene incluso in una stringa di formato personalizzato.

Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5

mm, mm (più un numero qualsiasi di identificatori m aggiuntivi)

Rappresenta il minuto come numero compreso tra 00 e 59. Il minuto rappresenta minuti interi trascorsi dall'ultima ora. Un minuto costituito da una singola cifra viene formattato con uno zero iniziale. Nell'esempio seguente l'identificatore di formato personalizzato mm viene incluso in una stringa di formato personalizzato.

Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.

M

Rappresenta il mese come numero compreso tra 1 e 12. Un mese costituito da una singola cifra viene formattato senza zero iniziale. Per ulteriori informazioni sull'utilizzo di un solo identificatore di formato, vedere Utilizzo di singoli identificatori di formato personalizzato. Nell'esempio seguente l'identificatore di formato personalizzato M viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = #8/18/2008#
Console.WriteLine(date1.ToString("(M) MMM, MMMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays (8) Aug, August
Console.WriteLine(date1.ToString("(M) MMM, MMMM", _
CultureInfo.CreateSpecificCulture("nl-NL")))
' Displays (8) aug, augustus
Console.WriteLine(date1.ToString("(M) MMM, MMMM", _
CultureInfo.CreateSpecificCulture("lv-LV")))
' Displays (8) Aug, augusts
DateTime date1 = new DateTime(2008, 8, 18);
Console.WriteLine(date1.ToString("(M) MMM, MMMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays (8) Aug, August
Console.WriteLine(date1.ToString("(M) MMM, MMMM",
CultureInfo.CreateSpecificCulture("nl-NL")));
// Displays (8) aug, augustus
Console.WriteLine(date1.ToString("(M) MMM, MMMM",
CultureInfo.CreateSpecificCulture("lv-LV")));
// Displays (8) Aug, augusts

MM

Rappresenta il mese come numero compreso tra 01 e 12. Un mese costituito da una singola cifra viene formattato con uno zero iniziale. Nell'esempio seguente l'identificatore di formato personalizzato MM viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = #1/2/2008 6:30:15AM#
Console.WriteLine(date1.ToString("dd, MM", _
CultureInfo.InvariantCulture))
' 02, 01
DateTime date1 = new DateTime(2008, 1, 2, 6, 30, 15);
Console.WriteLine(date1.ToString("dd, MM",
CultureInfo.InvariantCulture));
// 02, 01

MMM

Rappresenta il nome abbreviato del mese come definito nella proprietà DateTimeFormatInfo.AbbreviatedMonthNames corrente. Nell'esempio seguente l'identificatore di formato personalizzato MMM viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = #08/29/2008 7:27:15PM#
Console.WriteLine(date1.ToString("ddd d MMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays Fri 29 Aug
Console.WriteLine(date1.ToString("ddd d MMM", _
CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays ven. 29 aot
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);
Console.WriteLine(date1.ToString("ddd d MMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays Fri 29 Aug
Console.WriteLine(date1.ToString("ddd d MMM",
CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays ven. 29 aot

MMMM

Rappresenta il nome completo del mese come definito nella proprietà DateTimeFormatInfo.MonthNames corrente. Nell'esempio seguente l'identificatore di formato personalizzato MMMM viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = #08/29/2008 7:27:15PM#
Console.WriteLine(date1.ToString("dddd dd MMMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays Friday 29 August
Console.WriteLine(date1.ToString("dddd dd MMMM", _
CultureInfo.CreateSpecificCulture("it-IT")))
' Displays venerd 29 agosto
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);
Console.WriteLine(date1.ToString("dddd dd MMMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays Friday 29 August
Console.WriteLine(date1.ToString("dddd dd MMMM",
CultureInfo.CreateSpecificCulture("it-IT")));
// Displays venerd 29 agosto

s

Rappresenta i secondi come numero compreso tra 0 e 59. Il risultato rappresenta secondi interi trascorsi dall'ultimo minuto. Un secondo costituito da una singola cifra viene formattato senza zero iniziale. Per ulteriori informazioni sull'utilizzo di un solo identificatore di formato, vedere Utilizzo di singoli identificatori di formato personalizzato. Nell'esempio seguente l'identificatore di formato personalizzato s viene incluso in una stringa di formato personalizzato.

Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5

ss, ss (più un numero qualsiasi di identificatori s aggiuntivi)

Rappresenta i secondi come numero compreso tra 00 e 59. Il risultato rappresenta secondi interi trascorsi dall'ultimo minuto. Un secondo costituito da una singola cifra viene formattato con uno zero iniziale. Nell'esempio seguente l'identificatore di formato personalizzato ss viene incluso in una stringa di formato personalizzato.

Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.

t

Rappresenta il primo carattere dell'indicatore AM/PM definito nella proprietà DateTimeFormatInfo.AMDesignator o DateTimeFormatInfo.PMDesignator corrente. L'indicatore AM viene utilizzato se l'ora da formattare è minore di 12, altrimenti viene utilizzato l'indicatore PM. Per ulteriori informazioni sull'utilizzo di un solo identificatore di formato, vedere Utilizzo di singoli identificatori di formato personalizzato.

Nell'esempio seguente l'identificatore di formato personalizzato t viene incluso in una stringa di formato personalizzato.

Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5

tt, tt (più un numero qualsiasi di identificatori t aggiuntivi)

Rappresenta l'indicatore AM/PM definito nella proprietà DateTimeFormatInfo.AMDesignator o DateTimeFormatInfo.PMDesignator corrente. L'indicatore AM viene utilizzato se l'ora da formattare è minore di 12, altrimenti viene utilizzato l'indicatore PM.

Assicurarsi che l'applicazione utilizzi l'identificatore tt per le lingue per cui è necessario mantenere la distinzione tra AM e PM. Un esempio è la lingua giapponese per cui gli indicatori AM e PM differiscono in corrispondenza del secondo carattere anziché del primo.

Nell'esempio seguente l'identificatore di formato personalizzato tt viene incluso in una stringa di formato personalizzato.

Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.

y

Rappresenta l'anno come numero a una o due cifre. Se l'anno ha più di due cifre, nel risultato vengono visualizzate solo le due cifre di ordine inferiore. Se la prima cifra di un anno a due cifre inizia con zero (ad esempio, 2008), il numero viene formattato senza zero iniziale. Per ulteriori informazioni sull'utilizzo di un solo identificatore di formato, vedere Utilizzo di singoli identificatori di formato personalizzato.

Nell'esempio seguente l'identificatore di formato personalizzato y viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010
DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010

yy

Rappresenta l'anno come numero a due cifre. Se l'anno ha più di due cifre, nel risultato vengono visualizzate solo le due cifre di ordine inferiore. Se l'anno a due cifre ha meno di due cifre significative, al numero vengono anteposti tanti zeri quanti sono necessari per ottenere due cifre.

Nell'esempio seguente l'identificatore di formato personalizzato yy viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010
DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010

yyy

Rappresenta l'anno con un minimo di tre cifre. Se l'anno ha più di tre cifre significative, queste vengono incluse nella stringa di risultato. Se l'anno ha meno di tre cifre, al numero vengono anteposti tanti zeri quanti sono necessari per ottenere tre cifre.

Per il calendario buddista tailandese, in cui sono previsti anni di cinque cifre, questo identificatore di formato visualizza tutte e cinque le cifre.

Nell'esempio seguente l'identificatore di formato personalizzato yyy viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010
DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010

yyyy

Rappresenta l'anno come numero a quattro cifre. Se l'anno ha più di quattro cifre, nel risultato vengono visualizzate solo le quattro cifre di ordine inferiore. Se l'anno ha meno di quattro cifre, al numero vengono anteposti tanti zeri quanti sono necessari per ottenere quattro cifre.

Per il calendario buddista tailandese, in cui sono previsti anni di cinque cifre, questo identificatore di formato include tutte e cinque le cifre.

Nell'esempio seguente l'identificatore di formato personalizzato yyyy viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010
DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010

yyyyy (più un numero qualsiasi di identificatori y aggiuntivi)

Rappresenta l'anno come numero a cinque cifre. Se l'anno ha più di cinque cifre, nel risultato vengono visualizzate solo le cinque cifre di ordine inferiore. Se l'anno ha meno di cinque cifre, al numero vengono anteposti tanti zeri quanto sono necessari per ottenere cinque cifre.

Se esistono ulteriori identificatori y, al numero vengono anteposti tanti zeri quanti sono necessari per ottenere il numero di identificatori y.

Nell'esempio seguente l'identificatore di formato personalizzato yyyyy viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010
DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010

z

Con i valori DateTime rappresenta l'offset con segno del fuso orario del sistema operativo locale rispetto a UTC, misurato in ore. Non riflette il valore della proprietà Kind di un'istanza. Per questo motivo si sconsiglia di utilizzare l'identificatore di formato z con i valori DateTime.

Con i valori DateTimeOffset rappresenta l'offset del valore DateTimeOffset rispetto a UTC, in ore.

Lo scarto viene visualizzato sempre con un segno iniziale. Un segno più (+) indica le ore in più e un segno meno (-) le ore in meno rispetto all'ora UTC. Lo scarto può essere compreso tra -12 e +13. Uno scarto costituito da una singola cifra viene formattato senza zero iniziale. Per ulteriori informazioni sull'utilizzo di un solo identificatore di formato, vedere Utilizzo di singoli identificatori di formato personalizzato. Nell'esempio seguente l'identificatore di formato personalizzato z viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date1))
' Displays -7, -07, -07:00
Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date2))
' Displays +6, +06, +06:00
DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date1));
// Displays -7, -07, -07:00
DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0,
new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date2));
// Displays +6, +06, +06:00

zz

Con i valori DateTime rappresenta l'offset con segno del fuso orario del sistema operativo locale rispetto a UTC, misurato in ore. Non riflette il valore della proprietà Kind di un'istanza. Per questo motivo si sconsiglia di utilizzare l'identificatore di formato zz con i valori DateTime.

Con i valori DateTimeOffset rappresenta l'offset del valore DateTimeOffset rispetto a UTC, in ore.

Lo scarto viene visualizzato sempre con un segno iniziale. Un segno più (+) indica le ore in più e un segno meno (-) le ore in meno rispetto all'ora UTC. Il valore dell'offset è compreso tra -12 e +13. Un valore di offset di una sola cifra viene formattato con uno zero iniziale. Nell'esempio seguente l'identificatore di formato personalizzato zz viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date1))
' Displays -7, -07, -07:00
Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date2))
' Displays +6, +06, +06:00
DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date1));
// Displays -7, -07, -07:00
DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0,
new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date2));
// Displays +6, +06, +06:00

zzz, zzz (più un numero qualsiasi di identificatori z aggiuntivi)

Con i valori DateTime rappresenta l'offset con segno del fuso orario del sistema operativo locale rispetto a UTC, misurato in ore e minuti. Non riflette il valore della proprietà Kind di un'istanza. Per questo motivo si sconsiglia di utilizzare l'identificatore di formato zzz con i valori DateTime.

Con i valori DateTimeOffset rappresenta l'offset del valore DateTimeOffset rispetto a UTC, in ore e minuti.

Lo scarto viene visualizzato sempre con un segno iniziale. Un segno più (+) indica le ore in più e un segno meno (-) le ore in meno rispetto all'ora UTC. Il valore dell'offset è compreso tra -12 e +13. Un valore di offset di una sola cifra viene formattato con uno zero iniziale. Nell'esempio seguente l'identificatore di formato personalizzato zzz viene incluso in una stringa di formato personalizzato.

Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date1))
' Displays -7, -07, -07:00
Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date2))
' Displays +6, +06, +06:00
DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date1));
// Displays -7, -07, -07:00
DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0,
new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date2));
// Displays +6, +06, +06:00

:

Rappresenta il separatore dell'ora definito nella proprietà DateTimeFormatInfo.TimeSeparator corrente. Questo separatore viene utilizzato per distinguere ore, minuti e secondi.

/

Rappresenta il separatore della data definito nella proprietà DateTimeFormatInfo.DateSeparator corrente. Questo separatore viene utilizzato per distinguere anni, mesi e giorni.

"

Rappresenta una stringa tra virgolette (virgolette). Visualizza il valore letterale di una stringa tra due virgolette ("). È necessario che nell'applicazione venga anteposto un carattere di escape (\) a ogni virgoletta.

'

Rappresenta una stringa tra virgolette (apostrofo). Visualizza il valore letterale di una stringa tra virgolette singole (').

%c

Rappresenta il risultato associato a un identificatore di formato personalizzato c, quando la stringa di formato di data e ora personalizzato è costituita unicamente da tale identificatore di formato personalizzato. Ciò significa che per utilizzare l'identificatore di formato personalizzato d, f, F, h, m, s, t, y, z, H o M da solo, nell'applicazione dovrà essere specificato %d, %f, %F, %h, %m, %s, %t, %y, %z, %H o %M. Per ulteriori informazioni sull'utilizzo di un solo identificatore di formato, vedere Utilizzo di singoli identificatori di formato personalizzato.

\c

Rappresenta il carattere di escape e consente di visualizzare il carattere "c" come valore letterale se tale carattere è preceduto dal carattere di escape (\). Per inserire il carattere barra rovesciata nella stringa di risultato, nell'applicazione dovranno essere utilizzati due caratteri di escape ("\\").

Qualsiasi altro carattere

Viene copiato qualsiasi altro carattere nella stringa di risultati senza influire sulla formattazione.

Impostazioni del Pannello di controllo

Le impostazioni delle opzioni internazionali e della lingua nel Pannello di controllo influiscono sulla stringa di risultati prodotta da un'operazione di formattazione che include molti degli identificatori di formato di data e ora personalizzato. 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 risultati diverse.

Inoltre, se 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 dall'elemento Opzioni internazionali e della lingua nel Pannello Controllo verranno applicate al nuovo oggetto CultureInfo. È possibile utilizzare il metodo CreateSpecificCulture per creare un oggetto CultureInfo che non rifletta le personalizzazioni del sistema.

Proprietà DateTimeFormatInfo

La formattazione è influenzata dalle proprietà dell'oggetto DateTimeFormatInfo corrente, che viene fornito in modo implicito dalle impostazioni cultura del thread corrente o in modo esplicito dal parametro IFormatProvider del metodo che richiama la formattazione. Per il parametro IFormatProvider, nell'applicazione deve essere specificato un oggetto CultureInfo, che rappresenta determinate impostazioni cultura, o un oggetto DateTimeFormatInfo.

La stringa di risultato prodotta da molti degli identificatori di formato di data e ora personalizzato dipende dalle proprietà dell'oggetto DateTimeFormatInfo corrente. Nell'applicazione può quindi essere modificato il risultato prodotto da alcuni identificatori di formato di data e ora personalizzato modificando la proprietà DateTimeFormatInfo corrispondente. Ad esempio, l'identificatore di formato ddd aggiunge un nome del giorno della settimana abbreviato trovato nella matrice di stringhe AbbreviatedDayNames alla stringa di risultato. In modo analogo, l'identificatore di formato MMMM aggiunge un nome del mese completo trovato nella matrice di stringhe MonthNames alla stringa di risultato.

Utilizzo di singoli identificatori di formato personalizzato

Una stringa di formato di data e ora personalizzato è costituita da due o più caratteri. Ad esempio, se la stringa di formato è costituita solo dall'identificatore h, viene interpretata come un identificatore di formato di data e ora standard. In questo caso specifico, tuttavia, viene generata un'eccezione perché non esiste alcun identificatore di formato di data e orastandard h.

Per utilizzare un identificatore di formato di data e ora personalizzato, includere uno spazio prima o dopo tale identificatore oppure includere un identificatore di formato percentuale (%) prima del singolo identificatore di data e ora personalizzato. Ad esempio, le stringhe di formato "h" e "% h" vengono interpretate come stringhe di formato di data e ora personalizzato che visualizzano l'ora rappresentata dal valore di data e ora corrente. Se si utilizza uno spazio, questo viene visualizzato come carattere letterale nella stringa di risultato.

Vedere anche

Concetti

Stringhe di formato data e ora standard

Riferimenti

System.DateTime

System.IFormatProvider

Altre risorse

Formattazione dei tipi di dati