Guida C# interattiva: DateTime

Q: Che differenza c'è tra DateTime.Now e DateTime.UtcNow?

DateTime.Now è l'ora corrente nel fuso orario locale del computer, con Kind impostato a Local. DateTime.UtcNow è l'ora corrente in UTC, con Kind impostato a Utc, ed è anche più veloce perché salta la conversione di fuso orario. Memorizza e confronta i timestamp in UTC, e converti in ora locale solo per la visualizzazione.

Q: Come ottengo la differenza tra due date in C#?

Sottraile: TimeSpan gap = end - start;. Poi leggi gap.TotalDays, gap.TotalHours o gap.TotalMinutes per l'intera durata come double, oppure gap.Days per la parte in giorni interi. Per mesi o anni di calendario non esiste una proprietà predefinita, perché i mesi hanno lunghezze diverse; confronta tu i campi anno e mese.

Q: Che differenza c'è tra TimeSpan.Hours e TotalHours?

Hours è solo la componente delle ore, da 0 a 23, dopo aver tolto i giorni interi. TotalHours è l'intera durata espressa in ore, come double. Per un intervallo di 1 giorno e 3 ore, Hours vale 3 e TotalHours vale 27. Usare Hours dove serviva TotalHours è un bug molto comune.

Q: Come analizzo una stringa di data in C#?

Quando conosci il formato, usa DateTime.ParseExact(text, "yyyy-MM-dd", CultureInfo.InvariantCulture), oppure DateTime.TryParseExact per ottenere false invece di una FormatException con un input non valido. DateTime.Parse indovina il formato dalla cultura corrente, quindi 03/04/2026 significa 4 marzo negli Stati Uniti e 3 aprile nel Regno Unito.

Q: Perché AddDays non modifica il mio DateTime?

DateTime è un tipo valore immutabile. AddDays, AddHours e gli altri metodi restituiscono un nuovo DateTime e lasciano invariato l'originale, quindi devi assegnare il risultato: due = due.AddDays(7);.

Q: Quando usare DateTimeOffset invece di DateTime?

Usa DateTimeOffset per i timestamp che devono identificare un momento esatto, come quando è stato fatto un ordine o scritta una voce di log, soprattutto se i dati passano tra server e fusi orari diversi. Memorizza l'offset da UTC insieme al valore. DateTime va bene per i timestamp solo in UTC e per le date senza un fuso orario significativo.

System.DateTime rappresenta una data e un'ora del giorno, dall'anno 1 all'anno 9999, con una precisione di 100 nanosecondi (un "tick"). System.TimeSpan rappresenta una durata: la differenza tra due valori DateTime. Entrambi sono tipi valore immutabili (struct), quindi ogni operazione restituisce un nuovo valore.

using System;

class Program
{
    static void Main()
    {
        var launch = new DateTime(2026, 9, 24);                 // midnight
        var meeting = new DateTime(2026, 9, 24, 14, 30, 0);     // 14:30:00
        var precise = new DateTime(2026, 9, 24, 14, 30, 5, 250); // with milliseconds

        Console.WriteLine(launch.ToString("yyyy-MM-dd HH:mm:ss"));
        Console.WriteLine(meeting.ToString("yyyy-MM-dd HH:mm:ss"));
        Console.WriteLine(precise.ToString("HH:mm:ss.fff"));

        Console.WriteLine($"{meeting.Year} {meeting.Month} {meeting.Day}");
        Console.WriteLine($"{meeting.Hour}:{meeting.Minute}");
        Console.WriteLine(meeting.DayOfWeek);
        Console.WriteLine(meeting.DayOfYear);
        Console.WriteLine(meeting.Date.ToString("yyyy-MM-dd HH:mm")); // time set to 00:00
        Console.WriteLine(meeting.TimeOfDay);                          // a TimeSpan
    }
}

Output:

2026-09-24 00:00:00
2026-09-24 14:30:00
14:30:05.250
2026 9 24
14:30
Thursday
267
2026-09-24 00:00
14:30:00

Ogni esempio di questa pagina stampa le date con una stringa di formato esplicita. Il ToString() predefinito segue la cultura corrente (9/24/2026 2:30:00 PM negli Stati Uniti, 24.09.2026 14:30:00 in Germania), quindi il suo output dipende dalla macchina. I codici di formato sono nella pagina sul formato DateTime.

Una data non valida lancia un'eccezione: new DateTime(2026, 2, 30) solleva una ArgumentOutOfRangeException, così come il mese 13 o l'ora 24.

Now, UtcNow e Today

Tre proprietà statiche leggono l'orologio:

using System;

class Program
{
    static void Main()
    {
        DateTime local = DateTime.Now;      // local time zone
        DateTime utc = DateTime.UtcNow;     // Coordinated Universal Time
        DateTime today = DateTime.Today;    // local date, time 00:00:00

        Console.WriteLine($"Now:    {local:yyyy-MM-dd HH:mm:ss} ({local.Kind})");
        Console.WriteLine($"UtcNow: {utc:yyyy-MM-dd HH:mm:ss} ({utc.Kind})");
        Console.WriteLine($"Today:  {today:yyyy-MM-dd HH:mm:ss}");
    }
}

Output di esempio:

Now:    2026-09-24 18:20:41 (Local)
UtcNow: 2026-09-24 16:20:41 (Utc)
Today:  2026-09-24 00:00:00

In questo esempio il fuso orario locale è due ore avanti rispetto a UTC, quindi le prime due righe differiscono di due ore; su una macchina impostata su UTC coincidono. La proprietà Kind registra se un valore è Local, Utc o Unspecified (il valore predefinito per le date che costruisci tu). Usa DateTime.UtcNow per tutto ciò che memorizzi, registri nei log, confronti o invii a un altro sistema: non salta quando inizia o finisce l'ora legale e indica lo stesso momento su ogni server. Converti in ora locale solo quando mostri un valore a una persona.

Per misurare quanto tempo impiega il codice, usa System.Diagnostics.Stopwatch invece di sottrarre due valori DateTime.Now; ha una risoluzione molto più fine e non risente delle regolazioni dell'orologio.

Aggiungere e sottrarre tempo

AddDays, AddHours, AddMinutes, AddSeconds, AddMonths e AddYears restituiscono un nuovo DateTime. Passa un numero negativo per tornare indietro. Dato che DateTime è immutabile, il risultato va assegnato:

using System;

class Program
{
    static void Main()
    {
        var ordered = new DateTime(2026, 1, 31, 9, 0, 0);

        ordered.AddDays(3);                     // result discarded: no effect
        Console.WriteLine(ordered.ToString("yyyy-MM-dd"));

        DateTime shipped = ordered.AddDays(3);
        DateTime reminder = ordered.AddHours(-12);
        DateTime renewal = ordered.AddMonths(1);  // Jan 31 + 1 month
        DateTime nextYear = ordered.AddYears(1);

        Console.WriteLine(shipped.ToString("yyyy-MM-dd HH:mm"));
        Console.WriteLine(reminder.ToString("yyyy-MM-dd HH:mm"));
        Console.WriteLine(renewal.ToString("yyyy-MM-dd"));
        Console.WriteLine(nextYear.ToString("yyyy-MM-dd"));

        DateTime later = ordered + TimeSpan.FromMinutes(90);  // + a TimeSpan
        Console.WriteLine(later.ToString("HH:mm"));

        Console.WriteLine(DateTime.DaysInMonth(2028, 2));
        Console.WriteLine(DateTime.IsLeapYear(2028));
    }
}

Output:

2026-01-31
2026-02-03 09:00
2026-01-30 21:00
2026-02-28
2027-01-31
10:30
29
True

AddMonths si ferma all'ultimo giorno del mese quando il giorno non esiste: 31 gennaio più un mese dà 28 febbraio (o 29 in un anno bisestile), non 3 marzo. Aggiungere un mese due volte e aggiungere due mesi può quindi dare date diverse.

Sottrarre date: TimeSpan

Sottrarre un DateTime da un altro dà un TimeSpan:

using System;

class Program
{
    static void Main()
    {
        var checkIn = new DateTime(2026, 9, 20, 15, 0, 0);
        var checkOut = new DateTime(2026, 9, 24, 11, 30, 0);

        TimeSpan stay = checkOut - checkIn;

        Console.WriteLine(stay);                         // d.hh:mm:ss
        Console.WriteLine($"Days: {stay.Days}, Hours: {stay.Hours}, Minutes: {stay.Minutes}");
        Console.WriteLine($"TotalDays: {stay.TotalDays:F2}");
        Console.WriteLine($"TotalHours: {stay.TotalHours}");
        Console.WriteLine($"TotalMinutes: {stay.TotalMinutes}");

        int nights = (checkOut.Date - checkIn.Date).Days;   // calendar days
        Console.WriteLine($"Nights: {nights}");
    }
}

Output:

3.20:30:00
Days: 3, Hours: 20, Minutes: 30
TotalDays: 3.85
TotalHours: 92.5
TotalMinutes: 5550
Nights: 4

Questa è la parte dell'API su cui si sbaglia più spesso. Days, Hours, Minutes e Seconds sono le componenti dell'intervallo (3 giorni, 20 ore, 30 minuti). TotalDays, TotalHours e TotalMinutes sono l'intera durata in una sola unità, come double. "Quante ore è rimasto l'ospite?" è TotalHours (92.5), non Hours (20).

L'ultima riga mostra un punto collegato: sono trascorsi 3.85 giorni, ma l'ospite è rimasto 4 notti. Confrontare le parti .Date conta i giorni di calendario, che di solito è ciò che serve per la fatturazione e per le indicazioni del tipo "mancano X giorni".

Creare e formattare valori TimeSpan

using System;

class Program
{
    static void Main()
    {
        TimeSpan a = TimeSpan.FromMinutes(135);
        TimeSpan b = new TimeSpan(1, 30, 0);          // hours, minutes, seconds
        TimeSpan c = TimeSpan.FromDays(1.5);
        TimeSpan d = TimeSpan.Parse("02:15:00");

        Console.WriteLine(a);
        Console.WriteLine(b);
        Console.WriteLine(c);
        Console.WriteLine(a == d);
        Console.WriteLine(a + b);
        Console.WriteLine(a > b);
        Console.WriteLine(a.ToString(@"hh\:mm"));
        Console.WriteLine($"{(int)c.TotalHours}h {c.Minutes}m");
        Console.WriteLine(TimeSpan.Zero);
    }
}

Output:

02:15:00
01:30:00
1.12:00:00
True
03:45:00
True
02:15
36h 0m
00:00:00

TimeSpan supporta +, -, i confronti, Duration() (valore assoluto) e Negate(). I formati personalizzati come @"hh\:mm" richiedono una barra rovesciata prima dei caratteri letterali, e lì hh mostra solo la componente delle ore (da 0 a 23), quindi per durate superiori a un giorno costruisci il testo a partire da TotalHours come nella penultima riga.

Confrontare date

DateTime supporta ==, !=, <, >, <= e >=, più CompareTo e DateTime.Compare. Per confrontare solo la data ignorando l'ora, confronta le proprietà .Date:

using System;

class Program
{
    static void Main()
    {
        var deadline = new DateTime(2026, 10, 1, 17, 0, 0);
        var submitted = new DateTime(2026, 10, 1, 18, 45, 0);

        Console.WriteLine(submitted > deadline);            // late by time
        Console.WriteLine(submitted.Date == deadline.Date); // same day
        Console.WriteLine(DateTime.Compare(submitted, deadline)); // 1: later

        var start = new DateTime(2026, 9, 1);
        var end = new DateTime(2026, 9, 30);
        var check = new DateTime(2026, 9, 24, 12, 0, 0);
        Console.WriteLine(check >= start && check < end.AddDays(1));   // in range, inclusive of the end day

        DateTime earliest = start < check ? start : check;
        Console.WriteLine(earliest.ToString("yyyy-MM-dd"));
    }
}

Output:

True
True
1
True
2026-09-01

Per "questo timestamp cade entro il 30 settembre?", confronta con l'inizio del giorno successivo usando <, come sopra. Scrivere check <= end escluderebbe tutto ciò che viene dopo la mezzanotte dell'ultimo giorno, perché end è 2026-09-30 00:00:00.

I confronti guardano solo i tick, non Kind: un valore Local e un valore Utc che vengono stampati uguali sono considerati uguali anche se sono momenti diversi. Un altro motivo per memorizzare le ore in UTC.

Giorno della settimana e inizio della settimana

DayOfWeek è un enum che va da Sunday (0) a Saturday (6). L'aritmetica su di esso permette di trovare giorni feriali e confini della settimana:

using System;

class Program
{
    static void Main()
    {
        var date = new DateTime(2026, 9, 24);
        Console.WriteLine(date.DayOfWeek);
        Console.WriteLine((int)date.DayOfWeek);

        bool weekend = date.DayOfWeek == DayOfWeek.Saturday || date.DayOfWeek == DayOfWeek.Sunday;
        Console.WriteLine($"Weekend: {weekend}");

        // Monday of the same week
        int sinceMonday = ((int)date.DayOfWeek + 6) % 7;
        DateTime monday = date.AddDays(-sinceMonday);
        Console.WriteLine($"Week starts {monday:yyyy-MM-dd} ({monday.DayOfWeek})");

        // Next Friday (today counts if it is Friday)
        int toFriday = ((int)DayOfWeek.Friday - (int)date.DayOfWeek + 7) % 7;
        Console.WriteLine($"Next Friday: {date.AddDays(toFriday):yyyy-MM-dd}");

        // First and last day of the month
        var first = new DateTime(date.Year, date.Month, 1);
        var last = first.AddMonths(1).AddDays(-1);
        Console.WriteLine($"{first:yyyy-MM-dd} to {last:yyyy-MM-dd}");
    }
}

Output:

Thursday
4
Weekend: False
Week starts 2026-09-21 (Monday)
Next Friday: 2026-09-25
2026-09-01 to 2026-09-30

I nomi dei giorni stampati da DayOfWeek.ToString() sono sempre in inglese. Per un nome localizzato, formatta la data con "dddd" e una cultura.

Analizzare date da stringhe

Quando conosci il formato dell'input, usa ParseExact o TryParseExact con CultureInfo.InvariantCulture. La stringa di formato usa gli stessi codici della formattazione:

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var inv = CultureInfo.InvariantCulture;

        DateTime a = DateTime.ParseExact("2026-09-24", "yyyy-MM-dd", inv);
        DateTime b = DateTime.ParseExact("24/09/2026 18:05", "dd/MM/yyyy HH:mm", inv);
        Console.WriteLine(a.ToString("yyyy-MM-dd HH:mm"));
        Console.WriteLine(b.ToString("yyyy-MM-dd HH:mm"));

        string[] inputs = { "2026-02-28", "2026-02-30", "28.02.2026", "" };
        foreach (string text in inputs)
        {
            if (DateTime.TryParseExact(text, "yyyy-MM-dd", inv, DateTimeStyles.None, out DateTime d))
                Console.WriteLine($"'{text}' -> {d:dddd, MMMM d}");
            else
                Console.WriteLine($"'{text}' -> invalid");
        }

        // Several accepted formats
        string[] formats = { "yyyy-MM-dd", "dd.MM.yyyy", "MM/dd/yyyy" };
        DateTime c = DateTime.ParseExact("28.02.2026", formats, inv, DateTimeStyles.None);
        Console.WriteLine(c.ToString("yyyy-MM-dd"));

        // ISO 8601 with an offset or Z
        DateTime utc = DateTime.Parse("2026-09-24T10:00:00Z", inv, DateTimeStyles.AdjustToUniversal);
        Console.WriteLine($"{utc:yyyy-MM-dd HH:mm} {utc.Kind}");
    }
}

Output:

2026-09-24 00:00
2026-09-24 18:05
'2026-02-28' -> Saturday, February 28
'2026-02-30' -> invalid
'28.02.2026' -> invalid
'' -> invalid
2026-02-28
2026-09-24 10:00 Utc

DateTime.Parse(text) senza formato prova a indovinare usando la cultura corrente. "03/04/2026" è il 4 marzo su una macchina statunitense e il 3 aprile su una britannica, e una data che viene analizzata senza problemi sul tuo portatile può lanciare una FormatException su un server. Tieni Parse per l'input digitato da un utente locale; usa ParseExact con la cultura invariante per file, API e database. ParseExact lancia FormatException quando il testo non corrisponde; TryParseExact restituisce invece false.

Calcolare un'età

Sottrarre le date di nascita e dividere per 365 è sbagliato vicino ai compleanni e negli anni bisestili. Confronta gli anni, poi correggi se il compleanno di quest'anno non è ancora arrivato:

using System;

class Program
{
    static int Age(DateTime birth, DateTime today)
    {
        int age = today.Year - birth.Year;
        if (birth.Date > today.AddYears(-age)) age--;   // birthday not reached yet this year
        return age;
    }

    static void Main()
    {
        var today = new DateTime(2026, 9, 24);
        Console.WriteLine(Age(new DateTime(1990, 9, 24), today));  // birthday today
        Console.WriteLine(Age(new DateTime(1990, 9, 25), today));  // tomorrow
        Console.WriteLine(Age(new DateTime(2008, 2, 29), today));  // leap day

        var nextBirthday = new DateTime(today.Year, 12, 3);
        if (nextBirthday < today) nextBirthday = nextBirthday.AddYears(1);
        Console.WriteLine($"{(nextBirthday - today).Days} days to go");
    }
}

Output:

36
35
18
70 days to go

DateTimeOffset

Un DateTime non registra in quale fuso orario si trova, al di là del vago flag Kind. DateTimeOffset memorizza il valore insieme al suo offset da UTC, quindi identifica sempre un momento esatto:

using System;

class Program
{
    static void Main()
    {
        var placed = new DateTimeOffset(2026, 9, 24, 14, 0, 0, TimeSpan.FromHours(2));   // UTC+2
        var received = new DateTimeOffset(2026, 9, 24, 8, 30, 0, TimeSpan.FromHours(-4)); // UTC-4

        Console.WriteLine(placed.ToString("yyyy-MM-dd HH:mm zzz"));
        Console.WriteLine(placed.UtcDateTime.ToString("yyyy-MM-dd HH:mm"));
        Console.WriteLine(received.UtcDateTime.ToString("yyyy-MM-dd HH:mm"));
        Console.WriteLine(received - placed);          // compared as moments
        Console.WriteLine(placed.ToOffset(TimeSpan.FromHours(9)).ToString("HH:mm zzz"));
    }
}

Output:

2026-09-24 14:00 +02:00
2026-09-24 12:00
2026-09-24 12:30
00:30:00
21:00 +09:00

Usa DateTimeOffset (o valori DateTime in UTC) per i timestamp: quando è stato fatto un ordine, quando è stato inviato un messaggio. Database e serializzatori JSON lo gestiscono bene. Per convertire tra fusi orari con nome e regole sull'ora legale, usa TimeZoneInfo.ConvertTime; gli ID dei fusi differiscono a seconda del sistema operativo nelle versioni più vecchie di .NET ("Europe/Paris" su Linux, "Romance Standard Time" su Windows), mentre .NET 6 e successivi accettano entrambi.

DateOnly e TimeOnly (.NET 6 e successivi)

Molti valori sono una data senza ora (un compleanno, una scadenza) o un'ora senza data (gli orari di apertura). .NET 6 ha aggiunto due tipi per loro:

// .NET 6 and later
DateOnly birthday = new DateOnly(1990, 9, 24);
DateOnly due = DateOnly.FromDateTime(DateTime.Today).AddDays(14);
int daysLeft = due.DayNumber - DateOnly.FromDateTime(DateTime.Today).DayNumber;

TimeOnly opens = new TimeOnly(9, 0);
TimeOnly closes = new TimeOnly(17, 30);
bool isOpen = TimeOnly.FromDateTime(DateTime.Now).IsBetween(opens, closes);

Eliminano una categoria di bug in cui un'ora o un fuso orario di troppo sposta una data di un giorno. Il codice più vecchio, e quello per .NET Framework o Unity, usa DateTime con l'ora lasciata a mezzanotte.

Errori comuni

Scartare il risultato di AddDays. DateTime è immutabile; assegna il valore restituito.
Usare Hours invece di TotalHours. Componenti contro durata totale.
Memorizzare DateTime.Now. Memorizza in UTC e converti per la visualizzazione.
Chiamare ToString() senza formato in log, file o test, dove l'output dipende dalla cultura della macchina.
Analizzare dati generati da macchine con DateTime.Parse. Usa ParseExact e la cultura invariante.
Confondere mm e MM nelle stringhe di formato (minuti e mesi). Vedi il formato DateTime.

Domande frequenti

Che differenza c'è tra DateTime.Now e DateTime.UtcNow?

DateTime.Now è l'ora corrente nel fuso orario locale del computer, con Kind impostato a Local. DateTime.UtcNow è l'ora corrente in UTC, con Kind impostato a Utc, ed è anche più veloce perché salta la conversione di fuso orario. Memorizza e confronta i timestamp in UTC, e converti in ora locale solo per la visualizzazione.

Come ottengo la differenza tra due date in C#?

Sottraile: TimeSpan gap = end - start;. Poi leggi gap.TotalDays, gap.TotalHours o gap.TotalMinutes per l'intera durata come double, oppure gap.Days per la parte in giorni interi. Per mesi o anni di calendario non esiste una proprietà predefinita, perché i mesi hanno lunghezze diverse; confronta tu i campi anno e mese.

Che differenza c'è tra TimeSpan.Hours e TotalHours?

Hours è solo la componente delle ore, da 0 a 23, dopo aver tolto i giorni interi. TotalHours è l'intera durata espressa in ore, come double. Per un intervallo di 1 giorno e 3 ore, Hours vale 3 e TotalHours vale 27. Usare Hours dove serviva TotalHours è un bug molto comune.

Come analizzo una stringa di data in C#?

Quando conosci il formato, usa DateTime.ParseExact(text, "yyyy-MM-dd", CultureInfo.InvariantCulture), oppure DateTime.TryParseExact per ottenere false invece di una FormatException con un input non valido. DateTime.Parse indovina il formato dalla cultura corrente, quindi 03/04/2026 significa 4 marzo negli Stati Uniti e 3 aprile nel Regno Unito.

Perché AddDays non modifica il mio DateTime?

DateTime è un tipo valore immutabile. AddDays, AddHours e gli altri metodi restituiscono un nuovo DateTime e lasciano invariato l'originale, quindi devi assegnare il risultato: due = due.AddDays(7);.

Quando usare DateTimeOffset invece di DateTime?

Usa DateTimeOffset per i timestamp che devono identificare un momento esatto, come quando è stato fatto un ordine o scritta una voce di log, soprattutto se i dati passano tra server e fusi orari diversi. Memorizza l'offset da UTC insieme al valore. DateTime va bene per i timestamp solo in UTC e per le date senza un fuso orario significativo.

Concetti correlati