PHP date(): Mengambil, Memformat, dan Menghitung Tanggal

date('Y-m-d') mengembalikan tanggal hari ini sebagai string, misalnya 2026-03-14. Argumen pertama adalah string format, dan setiap hurufnya mewakili bagian dari tanggal (Y tahun, m bulan, d hari, H:i:s jam), sedangkan argumen kedua yang opsional adalah Unix timestamp yang diformat sebagai ganti waktu saat ini.

<?php
echo date('Y-m-d'), "\n";          // today's date
echo date('H:i:s'), "\n";          // current time, 24-hour clock
echo date('Y-m-d H:i:s'), "\n";    // both, the format databases use
echo date('l, F jS, Y'), "\n";     // long form, e.g. Saturday, March 14th, 2026
echo time(), "\n";                 // seconds since 1970-01-01 00:00:00 UTC

Output-nya berubah setiap kali kamu menekan Jalankan, karena isinya tanggal dan jam saat ini dalam UTC. Setiap huruf string format, dan cara menaruh teks biasa di antaranya, ada di halaman format tanggal PHP.

Timestamp: time(), mktime(), dan strtotime()

Unix timestamp adalah jumlah detik sejak 1 Januari 1970 tengah malam UTC. time() mengembalikan timestamp saat ini, mktime(hour, minute, second, month, day, year) membuatnya dari bagian-bagian tanggal, dan strtotime() membaca tanggal yang ditulis dalam bahasa Inggris ('2026-03-14', '+1 week', 'next monday'). Berikan timestamp apa pun sebagai argumen kedua date(). Argumen kedua strtotime() adalah titik waktu yang menjadi acuan frasa relatif; tanpa argumen itu, hitungannya dimulai dari sekarang.

<?php
$ts = mktime(9, 30, 0, 3, 14, 2026);   // 2026-03-14 09:30:00
echo $ts, "\n";
echo date('D, d M Y H:i', $ts), "\n";

// mktime() rolls over: month 13 of 2026 is January 2027
echo date('Y-m-d', mktime(0, 0, 0, 13, 1, 2026)), "\n\n";

$phrases = ['tomorrow', '+1 week', 'next monday', 'last day of this month', 'first monday of next month'];
foreach ($phrases as $phrase) {
    echo str_pad($phrase, 28), date('D Y-m-d', strtotime($phrase, $ts)), "\n";
}

var_dump(strtotime('not a date'));   // false: check before you use it

Output:

1773480600
Sat, 14 Mar 2026 09:30
2027-01-01

tomorrow                    Sun 2026-03-15
+1 week                     Sat 2026-03-21
next monday                 Mon 2026-03-16
last day of this month      Tue 2026-03-31
first monday of next month  Mon 2026-04-06
bool(false)

Perilaku melimpah di mktime() ini berguna: hari ke-0 dari suatu bulan adalah hari terakhir bulan sebelumnya, jadi mktime(0, 0, 0, 3, 0, 2026) adalah 28 Februari. Selalu bandingkan hasilnya dengan false sebelum dipakai lebih lanjut: date('Y-m-d', false) diam-diam mencetak 1970-01-01, tanggal yang tidak dimaksud siapa pun.

Menambah hari pada tanggal

Untuk apa pun selain sekadar mencetak, pakai DateTimeImmutable. Method modify()-nya menerima frasa yang sama dengan strtotime() dan mengembalikan tanggal baru, sedangkan add() menerima DateInterval seperti P7D (periode 7 hari) atau PT90M (90 menit).

<?php
$date = new DateTimeImmutable('2026-03-14 09:30');

echo $date->modify('+7 days')->format('Y-m-d'), "\n";
echo $date->modify('-1 day')->format('Y-m-d'), "\n";
echo $date->add(new DateInterval('P1M'))->format('Y-m-d'), "\n";
echo $date->add(new DateInterval('PT90M'))->format('H:i'), "\n";
echo $date->sub(new DateInterval('P1Y'))->format('Y-m-d'), "\n";

// Adding a month to January 31 overflows into March
$jan31 = new DateTimeImmutable('2026-01-31');
echo $jan31->modify('+1 month')->format('Y-m-d'), "\n";
echo $jan31->modify('last day of next month')->format('Y-m-d'), "\n";

Output:

2026-03-21
2026-03-13
2026-04-14
11:00
2025-03-14
2026-03-03
2026-02-28

31 Februari tidak ada, jadi +1 month pada 31 Januari jatuh di 3 Maret. Kalau yang kamu maksud "akhir bulan depan", tulis dengan jelas: last day of next month.

DateTime vs DateTimeImmutable

DateTime mengubah dirinya sendiri saat kamu memanggil modify(), add(), atau setDate(), lalu mengembalikan objek yang sama. Ini mengejutkan orang yang menyimpan tanggal aslinya di sebuah variabel:

<?php
$start = new DateTime('2026-03-14');
$end = $start->modify('+7 days');

echo $start->format('Y-m-d'), "\n";   // the start moved too
echo $end->format('Y-m-d'), "\n";
var_dump($start === $end);            // the same object

$start = new DateTimeImmutable('2026-03-14');
$end = $start->modify('+7 days');

echo $start->format('Y-m-d'), "\n";   // unchanged
echo $end->format('Y-m-d'), "\n";

Output:

2026-03-21
2026-03-21
bool(true)
2026-03-14
2026-03-21

Pilih DateTimeImmutable di kode baru. Kedua class punya method yang sama dan sama-sama mengimplementasikan DateTimeInterface, jadi sebuah fungsi bisa menerima keduanya.

Selisih dua tanggal

diff() mengembalikan DateInterval. Property days-nya adalah total jumlah hari di antara kedua tanggal, sedangkan y, m, dan d membagi jaraknya menjadi tahun, bulan, dan hari, persis yang dibutuhkan untuk menghitung umur. Ubah tanggalnya lalu jalankan lagi:

<?php
$birthday = new DateTimeImmutable('1990-07-20');
$today = new DateTimeImmutable('2026-03-14');

$age = $birthday->diff($today);
echo "Age: {$age->y}\n";
echo "Exactly: {$age->y} years, {$age->m} months, {$age->d} days\n";
echo "Days alive: {$age->days}\n";

$christmas = new DateTimeImmutable('2026-12-25');
$wait = $today->diff($christmas);
echo $wait->days, " days to go\n";
echo $wait->format('%m months and %d days'), "\n";

// Reversed order: invert is 1 and %R prints the sign
echo $christmas->diff($today)->format('%R%a days'), "\n";

Output:

Age: 35
Exactly: 35 years, 7 months, 22 days
Days alive: 13021
286 days to go
9 months and 11 days
-286 days

Di format(), %a adalah total hari dan %d hanya bagian harinya, jadi %a yang dipakai untuk "berapa hari lagi". Untuk membandingkan dua tanggal tanpa menghitung selisih, operator biasa bisa dipakai pada objek tanggal: $today < $christmas bernilai true.

Zona waktu

date() dan new DateTimeImmutable() memakai zona waktu bawaan, yang berasal dari date.timezone di php.ini (UTC kalau tidak diatur). Atur untuk seluruh script dengan date_default_timezone_set(), atau beri satu tanggal DateTimeZone-nya sendiri dan konversi dengan setTimezone():

<?php
$meeting = new DateTimeImmutable('2026-03-14 09:30', new DateTimeZone('UTC'));

foreach (['Asia/Tokyo', 'Europe/Berlin', 'America/New_York'] as $zone) {
    $local = $meeting->setTimezone(new DateTimeZone($zone));
    echo str_pad($zone, 18), $local->format('Y-m-d H:i T P'), "\n";
}

date_default_timezone_set('Asia/Tokyo');
echo date_default_timezone_get(), "\n";
echo date('Y-m-d H:i', $meeting->getTimestamp()), "\n";

Output:

Asia/Tokyo        2026-03-14 18:30 JST +09:00
Europe/Berlin     2026-03-14 10:30 CET +01:00
America/New_York  2026-03-14 05:30 EDT -04:00
Asia/Tokyo
2026-03-14 18:30

Timestamp adalah angka yang sama di mana pun; zona waktu hanya mengubah cara penulisannya. Karena itulah saran yang umum adalah menyimpan tanggal dalam UTC dan mengonversinya saat ditampilkan.

Menampilkan kalender di halaman web

Tanggal paling sering dicetak ke dalam HTML. Blok ini menggambar bulan saat ini sebagai kalender dan menandai hari ini. Jalankan, lalu klik Previous atau Next: script yang sama berjalan lagi dengan $_GET['m'] yang diisi dari link tersebut, misalnya ?m=2026-04.

<?php
$month = $_GET['m'] ?? date('Y-m');
$first = DateTimeImmutable::createFromFormat('!Y-m', $month)
    ?: new DateTimeImmutable('first day of this month midnight');

$prev = $first->modify('-1 month')->format('Y-m');
$next = $first->modify('+1 month')->format('Y-m');
$today = date('Y-m-d');
$days = (int) $first->format('t');   // days in this month
?>
<style>
    th, td { width: 2.4em; padding: 4px; text-align: center; }
    .today { background: #ffd54f; border-radius: 4px; }
</style>
<h3><?= $first->format('F Y') ?></h3>
<p><a href="?m=<?= $prev ?>">Previous</a> | <a href="?m=<?= $next ?>">Next</a></p>
<table>
    <tr><th>Mon</th><th>Tue</th><th>Wed</th><th>Thu</th><th>Fri</th><th>Sat</th><th>Sun</th></tr>
    <tr>
<?php
echo str_repeat('<td></td>', (int) $first->format('N') - 1);
for ($day = 1; $day <= $days; $day++) {
    $date = $first->modify('+' . ($day - 1) . ' days');
    $class = $date->format('Y-m-d') === $today ? ' class="today"' : '';
    echo "<td$class>$day</td>";
    if ($date->format('N') === '7' && $day < $days) {
        echo "</tr>\n<tr>";
    }
}
?>
    </tr>
</table>

format('N') memberi hari dalam minggu sebagai 1 (Senin) sampai 7 (Minggu), yang menentukan berapa sel kosong sebelum tanggal 1, dan format('t') memberi jumlah hari dalam bulan itu. Tanda ! di '!Y-m' mengatur ulang setiap field yang tidak disebut format, jadi harinya tanggal 1 dan jamnya tengah malam.

Kesalahan umum dengan date()

Argumen kedua date() harus berupa timestamp, bukan string tanggal. Baris ini:

<?php
echo date('d/m/Y', '2026-03-14');

menghentikan script dengan TypeError:

PHP Fatal error:  Uncaught TypeError: date(): Argument #2 ($timestamp) must be of type ?int, string given in /home/index.php:2

Konversi dulu string-nya, dengan strtotime() atau sebuah objek:

<?php
$input = '2026-03-14';

echo date('d/m/Y', strtotime($input)), "\n";
echo (new DateTimeImmutable($input))->format('d/m/Y'), "\n";

// Check that a date really exists before using it
var_dump(checkdate(2, 29, 2026));   // 2026 is not a leap year
var_dump(checkdate(2, 29, 2028));

Output:

14/03/2026
14/03/2026
bool(false)
bool(true)

Dua lagi yang perlu diwaspadai: m adalah bulan dan i adalah menit, jadi 'H:m' mencetak bulan di tempat yang seharusnya menit; dan new DateTimeImmutable('garbage') melempar exception alih-alih mengembalikan false, jadi bungkus input pengguna dengan try/catch atau parse dengan DateTimeImmutable::createFromFormat(), yang mengembalikan false kalau tidak cocok.