PHP date(): Tarih Alma, Biçimlendirme ve Hesaplama

date('Y-m-d') bugünün tarihini 2026-03-14 gibi bir dizge olarak döndürür. İlk argüman, her harfin tarihin bir parçasını temsil ettiği bir biçim dizgesidir (Y yıl, m ay, d gün, H:i:s saat); isteğe bağlı ikinci argüman ise şu an yerine biçimlendirilecek bir Unix zaman damgasıdır.

<?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

Çıktı Run düğmesine her bastığınızda değişir, çünkü UTC'deki güncel tarih ve saattir. Biçim dizgesinin her harfi ve aralarına düz metnin nasıl konulacağı PHP tarih biçimi sayfasında.

Zaman damgaları: time(), mktime() ve strtotime()

Unix zaman damgası 1 Ocak 1970 gece yarısı UTC'den beri geçen saniye sayısıdır. time() güncel olanı döndürür, mktime(hour, minute, second, month, day, year) parçalardan bir tane oluşturur ve strtotime() İngilizce yazılmış bir tarihi okur ('2026-03-14', '+1 week', 'next monday'). Herhangi bir zaman damgasını date() fonksiyonunun ikinci argümanı olarak verin. strtotime() fonksiyonunun ikinci argümanı göreli bir ifadenin saymaya başladığı andır; o olmadan şu andan sayar.

<?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

Çıktı:

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)

mktime() içindeki taşma kullanışlıdır: bir ayın 0. günü önceki ayın son günüdür, bu yüzden mktime(0, 0, 0, 3, 0, 2026) 28 Şubat olur. Sonucu başka yere vermeden önce her zaman false ile karşılaştırın: date('Y-m-d', false) sessizce kimsenin kastetmediği 1970-01-01 tarihini yazdırır.

Bir tarihe gün ekleme

Yazdırmanın ötesindeki her şey için DateTimeImmutable kullanın. modify() metodu strtotime() ile aynı ifadeleri alır ve yeni bir tarih döndürür; add() ise P7D (7 günlük bir süre) veya PT90M (90 dakika) gibi bir DateInterval alır.

<?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";

Çıktı:

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

31 Şubat yoktur, bu yüzden 31 Ocak üzerinde +1 month 3 Mart'a düşer. "Gelecek ayın sonu"nu kastettiğinizde bunu last day of next month ile söyleyin.

DateTime ile DateTimeImmutable

DateTime, modify(), add() veya setDate() çağırdığınızda kendini değiştirir ve aynı nesneyi döndürür. Bu, orijinal tarihi bir değişkende tutanları şaşırtır:

<?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";

Çıktı:

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

Yeni kodda DateTimeImmutable tercih edin. İki sınıfın da aynı metotları vardır ve ikisi de DateTimeInterface arayüzünü uygular, bu yüzden bir fonksiyon ikisini de kabul edebilir.

İki tarih arasındaki fark

diff() bir DateInterval döndürür. Onun days özelliği iki tarih arasındaki toplam gün sayısıdır; y, m ve d ise aralığı yıllara, aylara ve günlere böler, bir yaş hesaplamasının tam olarak ihtiyaç duyduğu budur. Tarihleri değiştirin ve tekrar çalıştırın:

<?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";

Çıktı:

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

format() içinde %a toplam gün, %d ise yalnızca gün kısmıdır, bu yüzden "kaç gün kaldı" için kullanılacak olan %a olur. Bir fark almadan iki tarihi karşılaştırmak için sıradan operatörler tarih nesnelerinde çalışır: $today < $christmas true olur.

Saat dilimleri

date() ve new DateTimeImmutable() php.ini içindeki date.timezone ayarından gelen varsayılan saat dilimini kullanır (ayarlanmamışsa UTC). Onu bütün betik için date_default_timezone_set() ile ayarlayın ya da tek bir tarihe kendi DateTimeZone nesnesini verip setTimezone() ile dönüştürün:

<?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";

Çıktı:

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

Bir zaman damgası her yerde aynı sayıdır; saat dilimi yalnızca nasıl yazıldığını değiştirir. Tarihleri UTC'de saklayıp gösterirken dönüştürme tavsiyesinin olağan olmasının nedeni budur.

Bir web sayfasında takvim gösterme

Tarihler çoğu zaman HTML'e yazdırılır. Bu blok mevcut ayı bir takvim olarak çizer ve bugünü vurgular. Çalıştırın, sonra Previous veya Next düğmesine tıklayın: aynı betik bağlantıdan gelen $_GET['m'] değeriyle, örneğin ?m=2026-04, yeniden çalışır.

<?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') haftanın gününü 1 (Pazartesi) ile 7 (Pazar) arasında verir; ayın 1'inden önce kaç boş hücre geleceği budur. format('t') ise aydaki gün sayısını verir. '!Y-m' içindeki ! biçimin belirtmediği her alanı sıfırlar, bu yüzden gün 1, saat ise gece yarısı olur.

date() ile sık yapılan hatalar

date() fonksiyonunun ikinci argümanı bir tarih dizgesi değil bir zaman damgası olmalıdır. Bu satır:

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

betiği bir TypeError ile durdurur:

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

Dizgeyi önce strtotime() veya bir nesneyle dönüştürün:

<?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));

Çıktı:

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

Dikkat edilmesi gereken iki şey daha: m ay, i dakikadır, bu yüzden 'H:m' dakika istediğiniz yere ayı yazdırır; ve new DateTimeImmutable('garbage') false döndürmek yerine bir istisna fırlatır, bu yüzden kullanıcı girdisini try/catch ile sarın ya da uyuşmazlıkta false döndüren DateTimeImmutable::createFromFormat() ile ayrıştırın.