C# Academy · Pelajaran

TimeSpan dan Durasi

Ukur rentang waktu.

TimeSpan dan Durasi adalah pelajaran C# Academy gratis di CoddyKit. Ini adalah pelajaran 3 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar C# Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus C# Academy mencakup 4 pelajaran total.

Apa Itu TimeSpan

Sementara DateTime adalah titik waktu, TimeSpan merepresentasikan durasi waktu, seperti 2 jam atau 90 menit.

TimeSpan merupakan durasi tanpa kalender yang terkait. Anda menggunakannya untuk hasil pengukur waktu, batas waktu, dan selisih antara dua tanggal.

Membuat TimeSpan

Salah satu konstruktor menerima jam, menit, dan detik: new TimeSpan(hours, minutes, seconds).

Jadi, new TimeSpan(1, 30, 0) berarti satu jam dan tiga puluh menit. Nilai tersebut ditampilkan dalam tata letak h:mm:ss yang jelas.

using System;

class Program
{
    static void Main()
    {
        TimeSpan span = new TimeSpan(1, 30, 0);
        Console.WriteLine(span);
    }
}

Metode Pabrik

Sering kali, penggunaan metode pabrik membuat kode lebih mudah dibaca. TimeSpan.FromMinutes(90) membuat durasi selama 90 menit.

Ada juga pembantu yang sesuai: FromHours, FromSeconds, FromDays, dan FromMilliseconds.

using System;

class Program
{
    static void Main()
    {
        TimeSpan span = TimeSpan.FromMinutes(90);
        Console.WriteLine(span);
    }
}

Nilai Total dan Komponen

TimeSpan memiliki dua kelompok properti. Hours, Minutes, dan Seconds adalah komponen-komponen yang diuraikan.

Versi Total..., seperti TotalMinutes, menyatakan seluruh durasi dalam satu satuan, sebagai angka desimal.

using System;

class Program
{
    static void Main()
    {
        TimeSpan span = TimeSpan.FromMinutes(90);
        Console.WriteLine(span.Hours);
        Console.WriteLine(span.TotalMinutes);
    }
}

Penjelasan Komponen dan Total

Untuk 90 menit, Hours bernilai 1 dan Minutes bernilai 30 karena durasinya terdiri dari 1 jam dan 30 menit.

Namun, TotalHours bernilai 1.5 dan TotalMinutes bernilai 90 karena keduanya menghitung seluruh durasi dalam satu satuan.

using System;

class Program
{
    static void Main()
    {
        TimeSpan span = TimeSpan.FromMinutes(90);
        Console.WriteLine(span.TotalHours);
    }
}

Mengurangkan Dua Tanggal

Saat Anda mengurangkan satu DateTime dari DateTime lain, hasilnya adalah TimeSpan.

Ini adalah cara umum untuk mengetahui berapa lama waktu berlalu antara dua momen, misalnya durasi sebuah acara.

using System;

class Program
{
    static void Main()
    {
        DateTime start = new DateTime(2024, 3, 5, 9, 0, 0);
        DateTime end = new DateTime(2024, 3, 5, 11, 30, 0);
        TimeSpan diff = end - start;
        Console.WriteLine(diff.TotalHours);
    }
}

Menambahkan TimeSpan

Anda dapat menambahkan atau mengurangkan nilai TimeSpan dengan operator + dan - biasa.

Menggabungkan dua durasi menghasilkan durasi yang lebih panjang, yang berguna untuk menjumlahkan beberapa interval.

using System;

class Program
{
    static void Main()
    {
        TimeSpan a = TimeSpan.FromMinutes(45);
        TimeSpan b = TimeSpan.FromMinutes(15);
        Console.WriteLine((a + b).TotalMinutes);
    }
}

Durasi Negatif

TimeSpan dapat bernilai negatif jika waktu akhir mendahului waktu mulai, atau setelah pengurangan.

Metode Duration mengembalikan nilai absolut, sedangkan Negate membalik tandanya. Keduanya membantu ketika Anda hanya memperhatikan besar durasinya.

using System;

class Program
{
    static void Main()
    {
        TimeSpan span = TimeSpan.FromHours(-3);
        Console.WriteLine(span.Duration().TotalHours);
    }
}

Membandingkan Durasi

Nilai TimeSpan dapat dibandingkan dengan <, >, dan ==, sama seperti angka.

Dengan begitu, Anda dapat memeriksa apakah satu durasi lebih panjang daripada durasi lainnya, misalnya untuk menerapkan batas waktu maksimum yang diizinkan.

using System;

class Program
{
    static void Main()
    {
        TimeSpan limit = TimeSpan.FromHours(2);
        TimeSpan used = TimeSpan.FromMinutes(150);
        Console.WriteLine(used > limit);
    }
}

Nol dan Konstanta

TimeSpan.Zero menyatakan bahwa tidak ada waktu yang berlalu dan berguna sebagai nilai awal untuk penjumlahan.

Ada juga TimeSpan.MinValue dan TimeSpan.MaxValue untuk batas ekstrem sebuah durasi.

using System;

class Program
{
    static void Main()
    {
        TimeSpan total = TimeSpan.Zero;
        total += TimeSpan.FromMinutes(10);
        Console.WriteLine(total.TotalMinutes);
    }
}

Memformat TimeSpan

Anda dapat memformat TimeSpan dengan string khusus. Misalnya, @"hh\:mm" menampilkan jam dan menit.

Garis miring terbalik membuat titik dua diperlakukan sebagai karakter literal. Untuk keluaran cepat, ToString bawaan biasanya sudah cukup.

using System;

class Program
{
    static void Main()
    {
        TimeSpan span = new TimeSpan(2, 5, 0);
        Console.WriteLine(span.ToString(@"hh\:mm"));
    }
}

Pemeriksaan Cepat

Anda memiliki TimeSpan selama 90 menit. Properti mana yang mengembalikan nilai 1.5?

Ringkasan

TimeSpan adalah durasi. Buat dengan new TimeSpan(...) atau metode pabrik seperti FromMinutes.

Properti komponen (Hours) berbeda dari properti Total.... Mengurangkan dua DateTime menghasilkan TimeSpan, dan Anda dapat menambahkan, membandingkan, serta memformat durasi.

Pertanyaan yang Sering Diajukan

Apakah pelajaran “TimeSpan dan Durasi” gratis?

Ya — teks lengkap “TimeSpan dan Durasi” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus C# Academy, upgrade ke CoddyKit PRO. Kursus C# Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “TimeSpan dan Durasi”?

Ukur rentang waktu. Kamu berlatih C# Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai C# Academy?

Tidak diperlukan pengalaman sebelumnya. C# Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 3 dari 4.

Berapa lama pelajaran “TimeSpan dan Durasi” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran C# Academy ini?

Ya. Setiap pelajaran C# Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

← Kembali ke C# Academy