Sayfa yükleniyor

Destek Müşteri Girişi Sepet (0)

Ders 73 – Zaman damgası ve format

PHP'de zaman damgaları, strtotime ve date format karakterleri ile tarih ve saat işlemlerini adım adım öğrenin. Örnek kodlar, sık yapılan hatalar ve ipuçlarıyla kapsamlı bir rehber.

Ders 73 – Zaman damgası ve format

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, strtotime ve date beklenmedik sonuçlar üretebilir. Özellikle UTC tabanlı API'lerle çalışırken UTC kullanmak en güvenli yaklaşımdır.
  • Geçersiz format: strtotime bazı tarih biçimlerini tanımaz (örnek: 31/12/2026). Bu durumda DateTime::createFromFormat() tercih edilmelidir.
  • 32‑bit PHP ortamı: 2038 yılı sorunu, 32‑bit sistemlerde time() değerinin int sınırını aşmasıyla ortaya çıkar. 64‑bit ortamlar ve DateTime sınıfları bu sorunu ortadan kaldırır.
  • Mutable vs Immutable: DateTime nesneleri değiştirilebilir (mutable) olduğundan, birden fazla yerde aynı nesne kullanıldığında istenmeyen yan etkiler oluşabilir. DateTimeImmutable tercih 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 strtotime yerine DateTime::createFromFormat() ile doğruladınız mı?
  • 32‑bit ortamda 2038 sonrası tarihleri test ettiniz mi?
  • Mutable DateTime nesneleri yerine DateTimeImmutable kullandı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 strtotime beklenmedik 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 int sınırı nedeniyle sorun yaşanır. Bu durum için DateTime nesneleri 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.
Paylaş

Yorumlar

Henüz onaylanmış yorum yok. İlk yorumu siz yazın.

Yorum yaz

Yorumunuz yönetici onayından sonra yayınlanır.

İlgili yazılar

Ders 100 – İleri yol haritası

PHP serisinin son dersinde ileri seviye konular, framework seçimi, Composer ekosistemi, mikro pro…

Ders 99 – Güvenli yapılandırma kontrol listesi

Üretim ortamı için PHP yapılandırma ayarlarını adım adım kontrol eden, hatasız ve güvenli bir yap…

Ders 98 – OpCache ve performans ipuçları

OpCache'ın çalışma prensibi, yapılandırma adımları ve gerçek dünyada performans artırmak için pra…

Ders 97 – Fibers’a kısa bakış (PHP 8.1)

PHP 8.1 ile gelen Fibers özelliğini adım adım öğrenin, kooperatif concurrency kavramını kavrayın …

Demo
Büyütülmüş Görsel