Sayfa yükleniyor

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

Ders 72 – Tarih ve saat: DateTimeImmutable

DateTimeImmutable sınıfı ile değiştirilemez tarih nesneleri oluşturun, formatlama, zaman dilimi ve fark hesaplamalarını adım adım öğrenin.

Ders 72 – Tarih ve saat: DateTimeImmutable

Web uygulamalarında tarih ve saat işlemleri, veri tutarlılığı, raporlama ve zaman tabanlı iş mantıkları açısından kritik bir rol oynar. PHP'nin klasik DateTime sınıfı mutable (değiştirilebilir) bir yapı sunarken, DateTimeImmutable nesneleri aynı işlemleri yan etki yaratmadan, her adımda yeni bir kopya oluşturarak gerçekleştirir. Bu yaklaşım, özellikle paralel isteklerde, testlerde ve fonksiyonel programlama tarzında kodun güvenilirliğini artırır. Bu dersimizde DateTimeImmutable sınıfının temellerini, createFromFormat, modify, diff ve zaman dilimi yönetimini ayrıntılı olarak inceleyecek, örnek kodlarla pekiştireceğiz.

Temeller

DateTimeImmutable nesnesi, new DateTimeImmutable($time, $timezone) şeklinde oluşturulur. $time parametresi bir tarih‑zaman dizesi, $timezone ise DateTimeZone nesnesi olmalıdır. Nesne oluşturulduktan sonra modify, add, sub gibi metodlar çağrıldığında orijinal nesne değişmez; bunun yerine yeni bir DateTimeImmutable nesnesi döner. Bu davranış, yan etkileri önleyerek kodun tahmin edilebilirliğini sağlar.

Aşağıdaki tablo, DateTimeImmutable ve DateTime arasındaki temel farkları özetler:

  • Değiştirilebilirlik: DateTime aynı nesne üzerinde değişiklik yapar, DateTimeImmutable her değişiklikte yeni bir nesne üretir.
  • Thread‑safety: Immutable nesneler aynı anda birden fazla işlemde güvenle kullanılabilir.
  • Test Kolaylığı: Yan etkisiz olduğu için birim testlerde mock ve stub oluşturmak daha basittir.

Adım adım Kullanım

1. Zaman dilimini belirleyin. Türkiye için Europe/Istanbul en yaygın seçenektir. Zaman dilimi hataları, özellikle Daylight Saving Time geçişlerinde ciddi tutarsızlıklara yol açabilir.

2. Immutable nesne oluşturun. new DateTimeImmutable('now', new DateTimeZone('Europe/Istanbul')) ifadesi, mevcut anı belirtilen zaman diliminde temsil eder.

3. Özel formatlardan nesne üretin. createFromFormat metodu, Y-m-d H:i:s gibi bir format tanımlayarak stringi doğrudan nesneye dönüştürür. Hatalı formatta bir string verilirse false döner ve DateTime::getLastErrors() ile hatalar incelenebilir.

4. Zamanı değiştirmek. modify('+2 days')` gibi bir ifade, iki gün sonrasını temsil eden yeni bir nesne döndürür. Orijinal nesne aynı kalır.

5. İki tarih arasındaki fark. diff metodu DateInterval nesnesi üretir; bu nesne y, m, d, h, i, s gibi alanları içerir. format('%a gün') gibi bir formatla toplam gün sayısını alabilirsiniz.

6. Zaman dilimini değiştirmek. setTimezone(new DateTimeZone('UTC')) metodu, aynı anı UTC zaman diliminde temsil eden yeni bir nesne döndürür. Bu işlem, veri tabanı kayıtları ve API entegrasyonları için standart bir adım olabilir.

Örnek Kod

Aşağıdaki örnek, bir tarih stringini DateTimeImmutable nesnesine dönüştürür, iki gün ekler, UTC'ye çevirir ve farkı hesaplar.

format('Y-m-d H:i:s')."\n";

// 3. createFromFormat ile özel bir tarih oluştur
$custom = DateTimeImmutable::createFromFormat('Y-m-d H:i', '2024-12-31 23:30', $tz);
if ($custom === false) {
    print_r(DateTimeImmutable::getLastErrors());
    exit;
}

echo "Özel tarih: ".$custom->format('Y-m-d H:i:s')."\n";

// 4. 2 gün ekle (immutable olduğu için yeni nesne)
$future = $custom->modify('+2 days');

echo "2 gün sonrası: ".$future->format('Y-m-d H:i:s')."\n";

// 5. UTC'ye çevir
$utc = $future->setTimezone(new DateTimeZone('UTC'));

echo "UTC zamanı: ".$utc->format('Y-m-d H:i:s')."\n";

// 6. Şu an ile 2 gün sonrası arasındaki farkı bul
$diff = $now->diff($future);

echo "Fark: ".$diff->format('%a gün %h saat %i dakika')."\n";
?>

Bu kodu ders72.php adıyla kaydedip yerel sunucunuzda çalıştırdığınızda, her adımda yeni bir nesne üretildiği için $now, $custom ve $future değişkenlerinin birbirini etkilemediğini göreceksiniz.

Sık Karşılaşılan Hatalar

  • Yanlış zaman dilimi: Zaman dilimi belirtilmezse PHP, date_default_timezone_set ile ayarlanan varsayılanı kullanır. Bu, özellikle sunucular farklı coğrafi konumlarda olduğunda tutarsız sonuçlar doğurur.
  • createFromFormat hataları: Format ve veri uyumsuzsa false döner. Hata ayıklamak için DateTimeImmutable::getLastErrors() fonksiyonunu inceleyin.
  • Immutable nesneyi değiştirmeye çalışmak: $dt->setDate(...) gibi bir çağrı, yeni bir nesne döndürür; sonucu atamazsanız değişiklik gerçekleşmez.
  • Daylight Saving Time (DST) geçişleri: modify('+1 day') gibi bir ekleme, DST değişiminde 23 veya 25 saatlik bir gün oluşturabilir. DateInterval kullanarak daha kesin kontrol sağlayabilirsiniz.

Özet

DateTimeImmutable, modern PHP projelerinde tarih‑saat mantığını güvenli bir şekilde izole eder. Zaman dilimini açıkça belirtmek, createFromFormat ile doğrulama yapmak, modify ve diff metodlarını immutable akış içinde kullanmak, kodun okunabilirliğini ve bakımını büyük ölçüde artırır. Aşağıdaki kontrol listesi, bu dersin sonunda uygulamanız gereken adımları özetler.

  • Zaman dilimini her DateTimeImmutable oluştururken açıkça tanımladınız mı?
  • String → nesne dönüşümünde createFromFormat kullandınız ve hataları kontrol ettiniz mi?
  • Değişiklik yaptığınızda yeni bir nesne atadığınızdan emin oldunuz mu?
  • İki tarih arasındaki farkı diff ile doğru bir DateInterval elde ettiniz mi?
  • Üretim ortamında hataları kullanıcıya doğrudan göstermiyor, logluyor musunuz?

SSS

Soru 1: Immutable nesne neden daha güvenlidir? Yanıt: Çünkü aynı nesne üzerinde birden fazla yerde değişiklik yapılmaz; bu da yarış koşullarını, beklenmeyen yan etkileri ve test sırasında ortaya çıkan belirsizlikleri ortadan kaldırır.

Soru 2: UTC yerine yerel zaman dilimini mi tercih etmeliyim? Yanıt: Veri depolama ve dış sistem entegrasyonları için UTC önerilir. Kullanıcı arayüzünde ise yerel zaman dilimi DateTimeZone ile dönüştürülerek gösterilir.

Soru 3: Immutable nesne ile DateInterval nasıl birleştirilir? Yanıt: $new = $immutable->add(new DateInterval('P1D')); ifadesi, bir gün ekleyerek yeni bir immutable nesne üretir. sub de aynı mantıkla çalışır.

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