Formato DateTime in C#: stringhe di formato standard e personalizzate, cultura, ISO 8601

DateTime.ToString(format) trasforma una data in testo. Il formato è una stringa di formato standard (una sola lettera come d o o, il cui pattern esatto dipende dalla cultura) oppure un pattern personalizzato costruito con specificatori come yyyy, MM e HH. Le stesse stringhe funzionano nell'interpolazione, $"{date:yyyy-MM-dd}", e in string.Format.

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var shipped = new DateTime(2026, 10, 9, 18, 30, 7, 45);
        var inv = CultureInfo.InvariantCulture;

        Console.WriteLine(shipped.ToString("yyyy-MM-dd", inv));
        Console.WriteLine(shipped.ToString("yyyy-MM-dd HH:mm:ss", inv));
        Console.WriteLine(shipped.ToString("dd/MM/yyyy", inv));
        Console.WriteLine(shipped.ToString("MMM d, yyyy", inv));
        Console.WriteLine(shipped.ToString("dddd, MMMM d", inv));
        Console.WriteLine(shipped.ToString("h:mm tt", inv));
        Console.WriteLine(shipped.ToString("HH:mm:ss.fff", inv));
        Console.WriteLine($"Shipped {shipped:yyyy-MM-dd} at {shipped:HH:mm}");
    }
}

Output:

2026-10-09
2026-10-09 18:30:07
09/10/2026
Oct 9, 2026
Friday, October 9
6:30 PM
18:30:07.045
Shipped 2026-10-09 at 18:30

Gli esempi di questa pagina passano CultureInfo.InvariantCulture perché l'output sia uguale su ogni macchina; senza, ToString usa la cultura corrente, che può cambiare i nomi dei mesi, i separatori e persino il calendario.

Specificatori di formato personalizzati

Un formato personalizzato è un pattern in cui certe lettere rappresentano parti della data. Distinguono maiuscole e minuscole: M è il mese e m il minuto, H è l'ora nel formato 24 ore e h quella nel formato 12 ore.

Qualsiasi altro carattere viene copiato così com'è. Questo vale anche per le lettere che non sono specificatori, ed è così che "YYYY-DD" stampa tranquillamente YYYY-DD: in .NET non esistono gli specificatori Y o D maiuscoli.

Una sola lettera da sola viene letta come formato standard, non personalizzato: ToString("d") è il pattern della data breve, non il numero del giorno. Per avere solo il giorno scrivi ToString("%d") oppure usa la proprietà Day.

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var d = new DateTime(2026, 10, 9, 18, 30, 7);
        var inv = CultureInfo.InvariantCulture;

        Console.WriteLine(d.ToString("d", inv));             // standard short date
        Console.WriteLine(d.ToString("%d", inv));            // custom: day of month
        Console.WriteLine(d.ToString("yyyyMMdd_HHmmss", inv)); // for file names
        Console.WriteLine(d.ToString("'Week of' MMM d", inv));
        Console.WriteLine(d.ToString("HH'h'mm", inv));
        Console.WriteLine(d.ToString("yyyy-MM-ddTHH:mm:ss", inv));
        Console.WriteLine(d.ToString("YYYY-DD", inv));      // not specifiers: copied
    }
}

Output:

10/09/2026
9
20261009_183007
Week of Oct 9
18h30
2026-10-09T18:30:07
YYYY-DD

Stringhe di formato standard

I formati standard sono singole lettere il cui pattern effettivo è definito dalla cultura. Sono la scelta giusta per il testo mostrato agli utenti, perché ogni cultura ottiene gratis le proprie convenzioni.

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var d = new DateTime(2026, 10, 9, 18, 30, 7, DateTimeKind.Utc);
        var inv = CultureInfo.InvariantCulture;

        foreach (string f in new[] { "d", "D", "f", "g", "G", "M", "Y", "t", "T", "o", "s", "u", "r" })
        {
            Console.WriteLine($"{f}  {d.ToString(f, inv)}");
        }

        var us = new CultureInfo("en-US");
        Console.WriteLine($"en-US d: {d.ToString("d", us)}, D: {d.ToString("D", us)}");
    }
}

Output:

d  10/09/2026
D  Friday, 09 October 2026
f  Friday, 09 October 2026 18:30
g  10/09/2026 18:30
G  10/09/2026 18:30:07
M  October 09
Y  2026 October
t  18:30
T  18:30:07
o  2026-10-09T18:30:07.0000000Z
s  2026-10-09T18:30:07
u  2026-10-09 18:30:07Z
r  Fri, 09 Oct 2026 18:30:07 GMT
en-US d: 10/9/2026, D: Friday, October 9, 2026

o, s, u e r producono lo stesso testo in ogni cultura, il che li rende sicuri per log, nomi di file e scambio di dati. Nota che su un DateTime, u e r non convertono il valore in UTC; lo stampano così com'è e lo etichettano come UTC, quindi chiama prima ToUniversalTime() (o usa DateTime.UtcNow) se il valore è locale. (Su un DateTimeOffset invece convertono.)

La cultura cambia l'output

I formati standard, i nomi dei mesi e dei giorni e i separatori / e : arrivano tutti dalla cultura. Passane una come secondo argomento di ToString:

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var d = new DateTime(2026, 10, 9, 18, 30, 0);
        string[] cultures = { "en-US", "en-GB", "de-DE", "fr-FR", "ja-JP" };

        foreach (string name in cultures)
        {
            var c = new CultureInfo(name);
            Console.WriteLine($"{name}  {d.ToString("d", c)}");
        }

        var de = new CultureInfo("de-DE");
        Console.WriteLine(d.ToString("D", de));
        Console.WriteLine(d.ToString("D", new CultureInfo("fr-FR")));
        Console.WriteLine(d.ToString("dd/MM/yyyy", de));      // "/" becomes "."
        Console.WriteLine(d.ToString("dd'/'MM'/'yyyy", de));  // quoted: a real slash
    }
}

Output:

en-US  10/9/2026
en-GB  09/10/2026
de-DE  09.10.2026
fr-FR  09/10/2026
ja-JP  2026/10/09
Freitag, 9. Oktober 2026
vendredi 9 octobre 2026
09.10.2026
09/10/2026

I dati di cultura non sono congelati. .NET su Linux e macOS li legge dalla libreria ICU installata nel sistema, e da .NET 5 lo fa anche .NET su Windows 10 e successivi (.NET Framework usa i dati NLS di Windows), quindi un pattern può cambiare leggermente tra versioni e piattaforme: le versioni recenti di ICU, per esempio, mettono uno spazio stretto indivisibile invece di uno spazio normale prima di "PM" nel formato dell'ora breve statunitense, e alcune danno le date brevi spagnole senza lo zero iniziale. Un motivo in più per non analizzare mai testo formattato per la visualizzazione.

Ne derivano due regole. Per il testo che legge una persona, formatta con la sua cultura (su un server, quella della richiesta, non quella del server) e preferisci i formati standard, così un lettore tedesco vede 09.10.2026 e uno americano 10/9/2026. Per il testo che legge un programma, usa CultureInfo.InvariantCulture e un pattern non ambiguo come yyyy-MM-dd o o. Una data scritta con la cultura corrente e analizzata su un'altra macchina è una fonte classica di giorni e mesi scambiati.

ISO 8601 e round-trip con "o"

Il formato round-trip "o" scrive ogni tick più le informazioni sul fuso, quindi analizzando il testo si ottiene esattamente lo stesso DateTime, compreso il suo Kind:

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var inv = CultureInfo.InvariantCulture;
        var utc = new DateTime(2026, 10, 9, 18, 30, 7, 45, DateTimeKind.Utc);
        var unspecified = new DateTime(2026, 10, 9, 18, 30, 7, 45);
        var offset = new DateTimeOffset(2026, 10, 9, 20, 30, 7, TimeSpan.FromHours(2));

        string stored = utc.ToString("o", inv);
        Console.WriteLine(stored);
        Console.WriteLine(unspecified.ToString("o", inv));
        Console.WriteLine(offset.ToString("o", inv));

        DateTime back = DateTime.Parse(stored, inv, DateTimeStyles.RoundtripKind);
        Console.WriteLine(back == utc);
        Console.WriteLine(back.Kind);

        Console.WriteLine(utc.ToString("yyyy-MM-ddTHH:mm:ssK", inv));    // no fractions
        Console.WriteLine(offset.ToString("yyyy-MM-dd HH:mm zzz", inv));
    }
}

Output:

2026-10-09T18:30:07.0450000Z
2026-10-09T18:30:07.0450000
2026-10-09T20:30:07.0000000+02:00
True
Utc
2026-10-09T18:30:07Z
2026-10-09 20:30 +02:00

Il suffisso Z indica UTC; un DateTime con Kind Unspecified non riceve alcun suffisso; un'ora locale o un DateTimeOffset riceve il suo offset (+02:00). Analizza con DateTimeStyles.RoundtripKind perché il Kind venga conservato. I serializzatori JSON, i database e il Date di JavaScript leggono tutti questo formato.

Formattare un TimeSpan

TimeSpan ha un proprio insieme più ridotto di specificatori personalizzati: d (giorni), hh, mm, ss e fff. A differenza di DateTime, ogni carattere letterale, compresi : e ., va preceduto da una barra rovesciata o messo tra apici:

using System;

class Program
{
    static void Main()
    {
        var elapsed = new TimeSpan(1, 3, 25, 9, 120);   // 1 day 3:25:09.120

        Console.WriteLine(elapsed.ToString());
        Console.WriteLine(elapsed.ToString("c"));
        Console.WriteLine(elapsed.ToString(@"hh\:mm\:ss"));        // hours component only
        Console.WriteLine(elapsed.ToString(@"d\.hh\:mm"));
        Console.WriteLine(elapsed.ToString(@"mm\:ss\.fff"));
        Console.WriteLine($"{(int)elapsed.TotalHours}:{elapsed.Minutes:D2}");  // 27:25
    }
}

Output:

1.03:25:09.1200000
1.03:25:09.1200000
03:25:09
1.03:25
25:09.120
27:25

hh in un formato TimeSpan è la componente delle ore (da 0 a 23), quindi una durata di 27 ore viene stampata come 03. Per totali superiori a un giorno, calcola a partire da TotalHours come nell'ultima riga. elapsed.ToString("hh:mm") senza la barra rovesciata lancia una FormatException.

Errori comuni

• mm per il mese. "yyyy-mm-dd" stampa i minuti al centro: 2026-30-09. Il mese è MM.
• hh senza tt. "hh:mm" è un orologio a 12 ore senza AM né PM, quindi 06:30 è ambiguo. Usa HH per l'ora nel formato 24 ore.
• YYYY e DD. In .NET non sono specificatori; vengono stampati letteralmente. Usa yyyy e dd.
• / in un pattern per i dati. È il separatore delle date della cultura. Mettilo tra apici o usa la cultura invariante.
• ToString() predefinito nei log o nei file. Il formato dipende dalla macchina. Passa un formato e una cultura.
• Ora locale etichettata come UTC. "u", "r" e una 'Z' scritta a mano non convertono; converti prima.
• Analizzare con un pattern diverso da quello usato per scrivere. Tieni le stringhe di formato per i dati in un'unica costante e usala sia con ToString sia con ParseExact.