Web uygulamalarında tarih ve saat verileri çoğu zaman kritik bir rol oynar. Kullanıcıların kayıt tarihleri, sipariş zaman damgaları, log kayıtları ve zaman dilimi dönüşümleri gibi senaryolarda doğru ve tutarlı bir zaman yönetimi gerekir. PHP, tarih ve saat işlemleri için time(), date(), strtotime() ve nesne yönelimli DateTime sınıfları gibi güçlü araçlar sunar. Bu ders, zaman damgalarını anlamaktan başlayıp, strtotime ile metin tabanlı tarihleri çözümlemeye, date format karakterleriyle çıktıyı biçimlendirmeye ve daha karmaşık senaryolarda DateTimeImmutable ve DateInterval kullanımına kadar kapsamlı bir yol haritası çizer.
Temeller
PHP'de zaman damgası, 1 Ocak 1970 00:00:00 UTC (Unix epoch) itibarıyla geçen saniye sayısını temsil eder. Bu sayı, platform bağımsız bir biçimde saklanır ve int tipinde döndürülür. En basit haliyle şu fonksiyonla elde edilir:
echo time(); // 1700000000 gibi bir değer
Bu değer, date() fonksiyonuna aktarılarak okunabilir bir formata dönüştürülebilir. date() iki parametre alır: format dizgesi ve opsiyonel olarak zaman damgası. Eğer zaman damgası verilmezse, time() değeri otomatik olarak kullanılır.
Format karakterleri, PHP'nin resmi dokümantasyonunda detaylı bir şekilde açıklanmıştır. En sık kullanılan karakterlerden bazıları şunlardır:
Y– Dört haneli yıl (2026)m– İki haneli ay (01‑12)d– İki haneli gün (01‑31)H– 24 saat biçiminde saat (00‑23)i– Dakika (00‑59)s– Saniye (00‑59)
Adım adım: strtotime ile metin tarihleri
strtotime() fonksiyonu, insan tarafından okunabilir bir tarih‑zaman ifadesini Unix zaman damgasına çevirir. Bu sayede "yarın", "+2 weeks" gibi doğal dil ifadeleriyle tarih hesaplamaları yapabilirsiniz. Örnek:
$yarin = strtotime('tomorrow');
echo date('Y-m-d H:i:s', $yarin);
// 2026-12-01 00:00:00 gibi bir çıktı verir (bugünün tarihine göre)
Fonksiyon, ikinci bir parametre alarak referans zaman damgasını belirlemenize izin verir. Bu, geçmiş ya da gelecekteki bir tarihe göre göreceli hesaplamalar yapmayı mümkün kılar:
$referans = strtotime('2026-01-01');
$ikiAySonra = strtotime('+2 months', $referans);
echo date('Y-m-d', $ikiAySonra); // 2026-03-01
Bu özellik, rapor tarih aralıkları, abonelik son tarihleri ve takvim uygulamaları gibi senaryolarda büyük kolaylık sağlar.
Örnek kod: Basit tarih formatlama ve dönüşüm
Aşağıdaki örnek, bir formdan gelen tarih‑zaman girdisini alıp, UTC zaman damgasına çevirir ve ardından farklı bir formatta ekrana bastırır. Kod, hata kontrolü ve kullanıcı girdisi doğrulamasını da içerir.
<?php
// Ders73.php – Tarih dönüştürme örneği
// 1. Kullanıcıdan gelen tarih stringi (örnek: 2026-11-25 14:30)
$girdi = $_GET['tarih'] ?? '2026-11-25 14:30';
// 2. strtotime ile zaman damgasına çevir
$zamanDamgasi = strtotime($girdi);
if ($zamanDamgasi === false) {
die('Geçersiz tarih formatı. Lütfen YYYY-MM-DD HH:MM şeklinde girin.');
}
// 3. UTC'ye dönüştür (PHP varsayılan zaman dilimini kullanır, burada UTC ayarlıyoruz)
date_default_timezone_set('UTC');
// 4. Farklı formatlarda çıktıyı göster
echo 'Orijinal giriş: ' . htmlspecialchars($girdi) . '
';
echo 'Unix zaman damgası: ' . $zamanDamgasi . '
';
echo 'ISO 8601 formatı: ' . date('c', $zamanDamgasi) . '
';
echo 'Yalın tarih: ' . date('Y-m-d', $zamanDamgasi) . '
';
echo 'Yalın saat: ' . date('H:i:s', $zamanDamgasi) . '
';
?>
Bu örnek, gerçek bir projede kullanıcı girişlerini güvenli bir şekilde işlemek için temel bir şablon sunar. htmlspecialchars ile XSS önlenir, die() ile hatalı girişlerde erken çıkış yapılır.
Sık karşılaşılan hatalar ve ipuçları
- Zaman dilimi karışıklığı: Sunucu zaman dilimi
date_default_timezone_set()ile açıkça ayarlanmazsa,strtotimevedatebeklenmedik sonuçlar üretebilir. Özellikle UTC tabanlı API'lerle çalışırkenUTCkullanmak en güvenli yaklaşımdır. - Geçersiz format:
strtotimebazı tarih biçimlerini tanımaz (örnek:31/12/2026). Bu durumdaDateTime::createFromFormat()tercih edilmelidir. - 32‑bit PHP ortamı: 2038 yılı sorunu, 32‑bit sistemlerde
time()değerininintsınırını aşmasıyla ortaya çıkar. 64‑bit ortamlar veDateTimesınıfları bu sorunu ortadan kaldırır. - Mutable vs Immutable:
DateTimenesneleri değiştirilebilir (mutable) olduğundan, birden fazla yerde aynı nesne kullanıldığında istenmeyen yan etkiler oluşabilir.DateTimeImmutabletercih edilerek yan etkiler önlenir.
İleri seviye: DateTimeImmutable ve DateInterval
Basit strtotime ve date kullanımının ötesinde, tarih‑zaman mantığını nesne yönelimli bir yaklaşımla modellemek daha okunaklı ve bakımı kolay kodlar üretir. DateTimeImmutable nesnesi, oluşturulduktan sonra değiştirilemez; her değişiklik yeni bir nesne döndürür. Bu, özellikle zincirleme işlemlerde yan etkileri önler.
<?php
$dt = new DateTimeImmutable('2026-11-25 14:30:00', new DateTimeZone('Europe/Istanbul'));
// 10 gün ekleyelim
$dtPlus10 = $dt->add(new DateInterval('P10D'));
// 3 saat çıkartalım
$dtMinus3H = $dtPlus10->sub(new DateInterval('PT3H'));
echo $dtMinus3H->format('Y-m-d H:i:s T'); // 2026-12-05 11:30:00 +03
?>
Yukarıdaki örnek, P10D (10 gün) ve PT3H (3 saat) gibi ISO 8601 interval tanımlarını gösterir. DateInterval sınıfı, yıllar, aylar, günler, saatler, dakikalar ve saniyeler gibi birimlerin tüm kombinasyonlarını destekler.
Kontrol Listesi
- Sunucu zaman dilimini
date_default_timezone_set()ile netleştirdiniz mi? - Kullanıcıdan gelen tarih girdisini
strtotimeyerineDateTime::createFromFormat()ile doğruladınız mı? - 32‑bit ortamda 2038 sonrası tarihleri test ettiniz mi?
- Mutable
DateTimenesneleri yerineDateTimeImmutablekullandınız mı? - Hata mesajlarını kullanıcıya doğrudan göstermiyor, log dosyasına kaydediyor musunuz?
Özet
Bu derste, PHP'de tarih ve saat işlemlerinin temellerinden başlayarak time(), date(), strtotime() ve format karakterlerinin nasıl kullanılacağını, sık yapılan hataları ve bunların önüne geçmek için en iyi uygulamaları ele aldık. Daha karmaşık senaryolar için DateTimeImmutable ve DateInterval sınıflarının avantajlarını gördük. Gerçek dünyada tarih‑zaman mantığını doğru bir şekilde modellemek, veri bütünlüğü, zaman dilimi uyumluluğu ve bakım kolaylığı açısından kritik bir adımdır.
Sık Sorulan Sorular
- strtotime() her zaman doğru mu çalışır? Hayır. Özellikle farklı tarih formatları ve yerel ayarlar söz konusu olduğunda
strtotimebeklenmedik sonuçlar verebilir.DateTime::createFromFormat()daha kesin bir çözüm sunar. - Unix zaman damgası 2038 sonrası kullanılabilir mi? 64‑bit PHP kurulumlarında evet, 32‑bit sistemlerde ise
intsınırı nedeniyle sorun yaşanır. Bu durum içinDateTimenesneleri tercih edilmelidir. - UTC dışında bir zaman diliminde çalışırken ne yapmalıyım? Uygulamanın başlangıcında
date_default_timezone_set('Europe/Istanbul')gibi bir ayar yapın ve tüm tarih‑zaman işlemlerini bu dilime göre yürütün. API'ler veya veri depoları için UTC'yi tercih edin, dönüşümleri UI katmanında yapın.
Yorumlar
Henüz onaylanmış yorum yok. İlk yorumu siz yazın.
Yorum yaz
Yorumunuz yönetici onayından sonra yayınlanır.