DateTime dan TimeSpan C#: Now, UtcNow, Add, Subtract, Compare, dan Parse

System.DateTime mewakili sebuah tanggal dan waktu dalam sehari, dari tahun 1 sampai tahun 9999, dengan presisi 100 nanodetik (satu "tick"). System.TimeSpan mewakili sebuah durasi: selisih antara dua nilai DateTime. Keduanya adalah tipe value yang immutable (struct), jadi setiap operasi mengembalikan nilai baru.

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

Setiap contoh di halaman ini mencetak tanggal dengan format string yang eksplisit. ToString() default mengikuti culture saat ini (9/24/2026 2:30:00 PM di AS, 24.09.2026 14:30:00 di Jerman), jadi output-nya bergantung pada mesin. Kode format-nya ada di format DateTime.

Tanggal yang tidak valid melempar exception: new DateTime(2026, 2, 30) memunculkan ArgumentOutOfRangeException, begitu juga bulan 13 atau jam 24.

Now, UtcNow, dan Today

Tiga property static membaca jam:

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}");
    }
}

Contoh output:

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

Di contoh ini, zona waktu lokalnya dua jam lebih cepat dari UTC, jadi dua baris pertama berselisih dua jam; di mesin yang diatur ke UTC, keduanya sama. Property Kind mencatat apakah sebuah nilai Local, Utc, atau Unspecified (default untuk tanggal yang kamu buat sendiri). Pakai DateTime.UtcNow untuk apa pun yang kamu simpan, catat di log, bandingkan, atau kirim ke sistem lain: nilainya tidak melompat saat daylight saving time dimulai atau berakhir, dan artinya sama, momen yang sama, di setiap server. Konversi ke waktu lokal hanya saat menampilkan nilai ke manusia.

Untuk mengukur berapa lama kode berjalan, pakai System.Diagnostics.Stopwatch alih-alih mengurangkan dua nilai DateTime.Now; resolusinya jauh lebih halus dan tidak terpengaruh penyesuaian jam.

Menambah dan mengurangi waktu

AddDays, AddHours, AddMinutes, AddSeconds, AddMonths, dan AddYears mengembalikan DateTime baru. Berikan angka negatif untuk mundur. Karena DateTime immutable, hasilnya harus di-assign:

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 menyesuaikan ke hari terakhir bulan itu saat tanggalnya tidak ada: 31 Januari ditambah satu bulan adalah 28 Februari (atau 29 di tahun kabisat), bukan 3 Maret. Karena itu, menambah satu bulan dua kali dan menambah dua bulan sekaligus bisa menghasilkan tanggal yang berbeda.

Mengurangkan tanggal: TimeSpan

Mengurangkan satu DateTime dari yang lain menghasilkan 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

Inilah bagian API yang paling sering salah dipahami. Days, Hours, Minutes, dan Seconds adalah komponen dari rentangnya (3 hari, 20 jam, 30 menit). TotalDays, TotalHours, dan TotalMinutes adalah seluruh durasi dalam satu satuan, sebagai double. "Berapa jam tamu itu menginap?" dijawab dengan TotalHours (92,5), bukan Hours (20).

Baris terakhir menunjukkan hal yang berkaitan: 3,85 hari telah berlalu, tetapi tamu itu menginap 4 malam. Membandingkan bagian .Date menghitung hari kalender, dan biasanya itulah yang dibutuhkan untuk penagihan dan tampilan "berapa hari lagi".

Membuat dan memformat nilai 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 mendukung +, -, perbandingan, Duration() (nilai mutlak), dan Negate(). Format custom seperti @"hh\:mm" butuh backslash sebelum karakter literal, dan hh di sana hanya menampilkan komponen jam (0 sampai 23), jadi untuk durasi lebih dari sehari, susun teksnya dari TotalHours seperti di baris kedua dari terakhir.

Membandingkan tanggal

DateTime mendukung ==, !=, <, >, <=, dan >=, ditambah CompareTo dan DateTime.Compare. Untuk membandingkan tanggalnya saja dan mengabaikan waktunya, bandingkan property .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

Untuk "apakah timestamp ini masih di tanggal 30 September?", bandingkan dengan awal hari berikutnya memakai <, seperti di atas. Menulis check <= end akan mengecualikan semua yang lewat dari tengah malam di hari terakhir, karena end adalah 2026-09-30 00:00:00.

Perbandingan hanya melihat tick-nya, bukan Kind: nilai Local dan nilai Utc yang tercetak sama dianggap sama, meskipun keduanya momen yang berbeda. Satu alasan lagi untuk menyimpan waktu dalam UTC.

Hari dalam seminggu dan awal minggu

DayOfWeek adalah enum dari Sunday (0) sampai Saturday (6). Aritmetika padanya bisa dipakai untuk mencari hari kerja dan batas minggu:

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

Nama hari yang dicetak oleh DayOfWeek.ToString() selalu dalam bahasa Inggris. Untuk nama yang dilokalkan, format tanggalnya dengan "dddd" dan sebuah culture.

Parsing tanggal dari string

Kalau kamu tahu format input-nya, pakai ParseExact atau TryParseExact dengan CultureInfo.InvariantCulture. Format string-nya memakai kode yang sama dengan saat memformat:

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) tanpa format mencoba menebak dengan culture saat ini. "03/04/2026" adalah 4 Maret di mesin AS dan 3 April di mesin Inggris, dan tanggal yang berhasil di-parse di laptopmu bisa melempar FormatException di server. Simpan Parse untuk input yang diketik pengguna lokal; pakai ParseExact dengan invariant culture untuk file, API, dan database. ParseExact melempar FormatException saat teksnya tidak cocok; TryParseExact mengembalikan false sebagai gantinya.

Menghitung umur

Mengurangkan tanggal lahir lalu membaginya dengan 365 itu salah di sekitar hari ulang tahun dan tahun kabisat. Bandingkan tahunnya, lalu koreksi kalau ulang tahun tahun ini belum terjadi:

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

DateTime tidak mencatat zona waktunya selain lewat flag Kind yang samar. DateTimeOffset menyimpan nilainya bersama offset dari UTC, jadi selalu menunjukkan satu momen yang tepat:

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

Pakai DateTimeOffset (atau nilai DateTime dalam UTC) untuk timestamp: kapan sebuah pesanan dibuat, kapan sebuah pesan dikirim. Database dan serializer JSON menanganinya dengan baik. Untuk mengonversi antarzona waktu bernama dengan aturan daylight saving, pakai TimeZoneInfo.ConvertTime; ID zonanya berbeda per sistem operasi di versi .NET yang lebih lama ("Europe/Paris" di Linux, "Romance Standard Time" di Windows), dan .NET 6 ke atas menerima keduanya.

DateOnly dan TimeOnly (.NET 6 ke atas)

Banyak nilai berupa tanggal tanpa waktu (ulang tahun, tanggal jatuh tempo) atau waktu tanpa tanggal (jam buka). .NET 6 menambahkan dua tipe untuk itu:

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

Kedua tipe ini menghilangkan sekelompok bug, saat waktu atau zona waktu yang nyasar menggeser tanggal sebanyak satu hari. Kode lama, dan kode yang menargetkan .NET Framework atau Unity, memakai DateTime dengan waktu yang dibiarkan di tengah malam.

Kesalahan umum

• Membuang hasil dari AddDays. DateTime immutable; assign nilai yang dikembalikan.
• Memakai Hours alih-alih TotalHours. Komponen versus seluruh durasi.
• Menyimpan DateTime.Now. Simpan UTC dan konversi untuk ditampilkan.
• Memanggil ToString() tanpa format di log, file, atau test, saat output-nya bergantung pada culture mesin.
• Mem-parse data mesin dengan DateTime.Parse. Pakai ParseExact dan invariant culture.
• Tertukar antara mm dan MM di format string (menit dan bulan). Lihat format DateTime.