Carbon ile Laravel'de Tarih Yönetimi

Adını arkeolojik kazılarda, buluntuların yaşını/dönemini anlayabilmek için yapılan radyoaktif ¹⁴C (radyokarbon) izotopundan alan, Laravel'de kullanılan bir PHP uzantısı olan Carbon'dan bahsetmek istiyorum. Günümüz uygulamalarının tarihle ilgili bir şeyler yapmadığı bir senaryo yok gibi bir şey. Haliyle hem kullanıcı girişlerinden hem de hali hazırda üretilmiş olan tarhilere göre tutarlı hesaplama yapmak oldukça hayati bir işlem olabilir. Kullanım süresi dolan ürünler, teslimat tarileri ya da en basitinden kullanıcının doğum günün kutlama... Buna benzer onlarca yüzlerce örnek yazılabilir.

İşte hal böyleyken, Laravel ekibi de kendi kütüphanalerini yazmaktansa doğrusunu yapıp bu işi gerçekten layıkıyla yapan Carbon'u Laravel'e dahil etmişler. Carbon ile tarih namına yapamayacağınız bir şey yok gibi. En azından benim aklımdan geçen her şeyin kütüphaneye eklendiğini gördüm. Rehber olması açısından bazı kullanım örneklerini de buraya eklemek istetim. Tamamını yazmak gibi bir şansımız yok gibi bir şey. Ne demek istediğimi Nestbot'un sayfasına bakarsanız anlayacağınızı düşünüyorum. Bir Blade sayfası içinde kullanabileceğiniz şekliyle örnekleri aşağıya ekliyorum.

@php
    use Carbon\Carbon;
    Carbon::setLocale('tr');

    $date1 = '2010-03-15 22:15:51';
    $date2 = '2020-07-22 13:45:18';
    $date3 = '2030-04-10 15:12:44';

    $month = '2'; //String
    $day = 9; //Integer
    $year = 1970; //Integer
    $tz = 'Europe/Istanbul';
@endphp

{{Carbon::now()}} // 2024-01-17 13:56:25
{{Carbon::now()->year}} // 2024
{{Carbon::now()->month}} // 1
{{Carbon::now()->day}} // 17
{{Carbon::now()->hour}} // 13
{{Carbon::now()->minute}} // 56
{{Carbon::now()->second}} // 25
{{Carbon::now()->dayOfWeek}} // 3 
{{Carbon::now()->dayOfYear}} // 17
{{Carbon::now()->weekOfMonth}} // 3 
{{Carbon::now()->daysInMonth}} // 31
{{Carbon::now()->daysInYear}} // 366

{{Carbon::today()}} // 2024-01-17 00:00:00
{{Carbon::yesterday()}} // 2024-01-16 00:00:00
{{Carbon::tomorrow()}} // 2024-01-18 00:00:00
{{Carbon::parse('last day of february 2025')}} // 2025-02-28 00:00:00
{{Carbon::createFromDate($year, $month, $day, $tz)}} // 1970-02-09 13:56:25

{{Carbon::parse($date1)}}  // 2010-03-15 22:15:51
{{Carbon::parse($date1)->format('d-m-Y')}}  // 15-03-2010
{{Carbon::parse($date1)->format('d-m-Y H:i:s')}}  // 15-03-2010 22:15:51
{{Carbon::parse($date1)->format('D, d M Y H:i:s')}}  // Mon, 15 Mar 2010 22:15:51
{{Carbon::parse($date1)->translatedFormat('D, d F Y H:i:s')}}  // Pts, 15 Mart 2010 22:15:51

{{Carbon::parse($date1)->diffInDays($date2)}}  // 3781
{{Carbon::parse($date1)->diffInMonths($date2)}}  // 124
{{Carbon::parse($date1)->diffInYears($date2)}}  // 10
{{Carbon::parse($date1)->diffForHumans($date2)}}  // 10 yıl önce

{{Carbon::now()->isBirthday()}}  // 1
{{Carbon::parse($date2)->isPast()}}  // 1
{{Carbon::parse($date3)->isFuture()}}  // 1
{{Carbon::parse($date3)->diffInDays(now())}}  // 2275

{{Carbon::parse($date1)->format('c')}} // 2010-03-15T22:15:51+02:00 //ISO 8601
{{Carbon::parse($date1)->format('e')}} // Europe/Istanbul

{{Carbon::parse($date1)->addMonths('3')}} // 2010-06-15 22:15:51
{{Carbon::parse($date1)->subMonths('3')}} // 2009-12-15 22:15:51
{{Carbon::parse($date1)->addYears('3')}} // 2013-03-15 22:15:51
{{Carbon::parse($date1)->subYears('3')}} // 2007-03-15 22:15:51

Burada dikkat çekmek istediğim bir nokta var. Laravel içinde varsayılan lokalizasyon, sizin uygulamanızın ayarlarından alınır. Ama duruma ya da sayfaya göre yerelleştirme yapmak istiyorsanız sayfa içinde yukarıda olduğu gibi setLocale değişkenini override etmeyi unutmayınız. Zaten örneklerde de görüldüğü üzere translatedFormat kullanımı ile varsayılan İngilizce dilinden Türkçeye çevirildiğini görürsünüz. Ben herhangi bir çeviri de yapmadım. Hali hazırda pakette gerekli çeviriler mevcut. Ayrıca formatla ilgili kısaltmaları da aşağıdaki listeden inceleyebilirsiniz. Tabloyu kaynağından aldım ve çevirmeye üşendim :)