Obliczenia i pomocnicze klasy do dat i czasu

1. Podstawowe zadania przy pracy z datą i czasem

Praca z datami i czasem często wywołuje lekką (a czasem wcale nielekką) panikę nawet u doświadczonych devów. Trzeba porównywać daty, liczyć interwały, dodawać lub odejmować dni/miesiące/lata, liczyć wiek, określać dzień tygodnia i dużo więcej.

To wszystko — typowe zadania dla trackerów zadań i kalendarzy, obsługi abonamentów czy subskrypcji, rozliczeń finansowych, raportów statystycznych i oczywiście na rozmowach rekrutacyjnych (np. "policz liczbę dni roboczych między dwiema datami").

W C# i .NET do tych zadań są wbudowane klasy i metody. Najważniejsze — większość obliczeń robi się przez obiektowy, maksymalnie bezpieczny i czytelny API.

2. Struktura TimeSpan — mierzymy interwały czasu

Wszystko zaczyna się od struktury TimeSpan. To taki "kawałek" czasu: np. 5 dni, 3 godziny, 7 minut i 21 sekund.

Jak stworzyć TimeSpan?

Możesz "odjąć" dwie daty, możesz stworzyć jawnie:

// Różnica między dwiema datami to zawsze TimeSpan!
DateTime start = new DateTime(2025, 5, 1, 7, 0, 0);
DateTime end = new DateTime(2025, 5, 2, 11, 30, 0);

TimeSpan duration = end - start; // Pełna magia!
Console.WriteLine(duration); // 1.04:30:00 (1 dzień, 4 godziny, 30 minut)

Możesz jawnie stworzyć TimeSpan przez parametry konstruktora:

TimeSpan span = new TimeSpan(2, 14, 18, 0); // 2 dni, 14 godzin, 18 minut, 0 sekund
Console.WriteLine(span); // 2.14:18:00

Alternatywny sposób tworzenia — przez statyczne metody, które często są czytelniejsze:

TimeSpan fiveMinutes = TimeSpan.FromMinutes(5);
TimeSpan twoHours = TimeSpan.FromHours(2);
TimeSpan oneWeek = TimeSpan.FromDays(7);

Jakie właściwości ma TimeSpan?

Days

Hours

Minutes

Seconds

TotalDays

TotalHours

TotalMinutes

TotalSeconds

Console.WriteLine($"Dni: {duration.Days}, Wszystkich godzin: {duration.TotalHours}");

Jak dodać/odjąć TimeSpan od daty?

DateTime now = DateTime.Now;
DateTime future = now.Add(duration); // Dodaliśmy duration do now
DateTime past = now.Subtract(TimeSpan.FromDays(10)); // Minus 10 dni

Console.WriteLine(future);
Console.WriteLine(past);

3. Kalkulator dat: liczymy różnicę między datami

Skill, który przyda się praktycznie zawsze. Na przykład ktoś chce wiedzieć, ile zostało do urlopu, a ktoś inny — kiedy kończy się darmowy okres.

DateTime today = DateTime.Today;
DateTime vacation = new DateTime(2025, 8, 1);
TimeSpan untilVacation = vacation - today;

Console.WriteLine($"Do urlopu zostało {untilVacation.Days} dni!");

Zwróć uwagę: jeśli w odejmowaniu biorą udział tylko "daty" bez czasu (przez DateTime.Date albo DateTime.Today), wynik to zawsze całkowita liczba dni. A jeśli choć jedna data ma czas, różnica — z ułamkiem.

int days = (vacation - today).TotalDays; // Błąd kompilacji! TotalDays — double

Jeśli potrzebujesz liczby całkowitej — użyj .Days albo rzutuj na int przez (int)TotalDays.

4. Dodawanie i odejmowanie czasu: metody AddDays, AddMonths, AddHours, ...

C# nie wymaga ręcznego liczenia dni w każdym miesiącu, lat przestępnych i innych bóli. Po prostu używasz:

DateTime orderDate = new DateTime(2024, 4, 20);
DateTime deliveryDate = orderDate.AddDays(14); // Za 2 tygodnie

Console.WriteLine($"Towar będzie dostarczony {deliveryDate.ToShortDateString()}");

AddDays(double)

AddMonths(int)

AddYears(int)

AddHours(double)

AddMinutes(double)

AddSeconds(double)

DateTime birthday = new DateTime(2000, 2, 29);
DateTime nextYear = birthday.AddYears(1); // 2001-02-28 (nie 29, bo 2001 nie jest przestępny)
Console.WriteLine(nextYear.ToShortDateString()); // 28.02.2001

Pamiętaj: wszystkie metody zwracają nową instancję daty, oryginalna data się nie zmienia!

var dt = DateTime.Now;
dt.AddDays(5); // To NIE zmieni dt!
dt = dt.AddDays(5); // Teraz się zmieni

5. Pomocnicze metody do obliczeń

Obliczanie dnia tygodnia

W większości przypadków możesz użyć właściwości .DayOfWeek:

DateTime examDate = new DateTime(2025, 6, 19);
DayOfWeek day = examDate.DayOfWeek;
Console.WriteLine(day); // Wednesday

Możesz rzutować na liczbę całkowitą:

int number = (int)day; // Sunday == 0, Monday == 1, itd.

Sprawdzanie "dzisiaj", "wczoraj", "jutro"

Najprostsze porównania:

DateTime date = new DateTime(2025, 6, 18);

if (date.Date == DateTime.Today)
    Console.WriteLine("Dzisiaj!");
else if (date.Date == DateTime.Today.AddDays(-1))
    Console.WriteLine("Wczoraj!");
else if (date.Date == DateTime.Today.AddDays(1))
    Console.WriteLine("Jutro!");

Obliczanie wieku

Jedno z najczęstszych zadań — poprawne liczenie wieku człowieka. Proste odejmowanie lat nie zawsze działa dobrze:

public static int CalculateAge(DateTime birthDate, DateTime currentDate)
{
    int age = currentDate.Year - birthDate.Year;
    
    // Jeśli urodziny jeszcze nie były w tym roku
    if (currentDate.Month < birthDate.Month || 
        (currentDate.Month == birthDate.Month && currentDate.Day < birthDate.Day))
    {
        age--;
    }
    
    return age;
}

// Użycie
DateTime birth = new DateTime(1990, 8, 15);
DateTime today = DateTime.Today;
int age = CalculateAge(birth, today);
Console.WriteLine($"Wiek: {age} lat");

Praca z dniami roboczymi

Często trzeba policzyć liczbę dni roboczych między datami, pomijając weekendy:

public static int CountWorkingDays(DateTime startDate, DateTime endDate)
{
    int workingDays = 0;
    DateTime current = startDate;
    
    while (current <= endDate)
    {
        if (current.DayOfWeek != DayOfWeek.Saturday && 
            current.DayOfWeek != DayOfWeek.Sunday)
        {
            workingDays++;
        }
        current = current.AddDays(1);
    }
    
    return workingDays;
}

6. Jak powiązane są główne klasy

graph TD
    A(DateTime) --odejmowanie--> B(TimeSpan)
    A2(DateTime) --AddDays, AddMonths--> A
    A --ToLocalTime/ToUniversalTime--> C(DateTimeOffset)
    D(DateOnly) --ToDateTime--> A
    E(TimeOnly) --ToTimeSpan--> B
    A --DayOfWeek, Day, Month, Year--> F(Właściwości liczbowe)
    B(TimeSpan) --TotalDays, TotalHours, ...--> G(Właściwości długości)

7. Szybki "ściągacz": co zrobić jeśli...

TimeSpan duration = d2 - d1

(d2 - d1).Days

date.AddDays(14)

date.AddDays(14)

.Year

DateOnly

DateOnly.FromDateTime(DateTime.Now)

TimeOnly

TimeOnly.FromDateTime(DateTime.Now)

<

>

==

.CompareTo()

if (d1 < d2) ...

DateTimeOffset + ToOffset

dto.ToOffset(TimeSpan.FromHours(3))

Calendar.GetWeekOfYear()

date.DayOfWeek

DayOfWeek

1

Ankieta/quiz

Praca z datami, poziom 15, lekcja 4

Niedostępny

Praca z datami

Praca z datami, czasem i strefami czasowymi

Otwórz