ISO Hafta Numarasi (Yilin Kacinci Haftasi)

ISO hafta numarası, bir tarihin içinde bulunduğu yılın kaçıncı haftada yer aldığını gösterir. Bu bilgi, proje takvimleri, iş planları ve akademik programlar gibi tarih odaklı çalışmalar için kritik öneme sahiptir. Özellikle uluslararası standartlara uygun rapor hazırlayan kişiler bu aracı sıkça kullanır.

Hangi formül kullanılıyor?

İlk adımda, girilen tarih JavaScript’in Date nesnesine dönüştürülür ve geçerli bir tarih olup olmadığı kontrol edilir. Ardından haftanın günü (Pazartesi=0) elde edilir; bu değer, haftanın ISO tanımına uygun şekilde yeniden düzenlenir. Tarih, haftanın ortası olan Perşembe’ye kaydırılarak referans noktası oluşturulur ve bu noktanın zaman damgası (ft) kaydedilir.

Sonraki aşamada, yılın ilk gününe (1 Ocak) aynı yıl içinde yeni bir Date nesnesi atanır. Bu tarih Perşembe değilse, en yakın Perşembe’ye kaydırılır; böylece ISO haftalarının başlangıç günü kesinleşir. Haftalar arasındaki fark, milisaniye cinsinden hesaplanır, bir haftanın milisaniyesi (7 × 86 400 000) ile bölünür ve yukarı yuvarlama yapılır. Sonuç bir artı bir eklenerek ISO hafta numarası elde edilir.

Elde edilen hafta numarası, kullanıcıya “X. hafta” şeklinde okunabilir bir formatta sunulur. Ek olarak, tam tarih, ISO hafta ve yıl bilgileri detaylı bir nesne içinde geri döndürülür; bu sayede farklı gösterimler ve veri işleme ihtiyaçları için esnek bir yapı sağlanır.

• v: Fonksiyonun parametresi, içinde date alanı bulunan bir nesnedir.
• date: Kullanıcı tarafından girilen tarih (YYYY-AA-GG formatında).
• d: Girilen tarihin Date nesnesi hâli, geçerlilik kontrolü burada yapılır.
• t: Haftanın Perşembe gününe ayarlanmış tarih nesnesi, hafta hesabı için referans olur.
• day: Haftanın günü (Pazartesi=0) olarak yeniden kodlanmış değerdir.

Örnek hesaplama

Aşağıdaki örnek, 9 Haziran 2026 tarihinin ISO haftasını nasıl bulduğunu adım adım gösterir.

• Girilen tarih “2026-06-09” Date nesnesine dönüştürülür; bu tarih Salı günüdür ve geçerli bir tarih olduğu doğrulanır.
• Haftanın günü (day) değeri (2+6)%7 = 1 olarak hesaplanır; bu, Salı’nın ISO haftası içinde Perşembe’ye doğru kaydırılması için kullanılır.
• t nesnesi, girilen tarihten 1 gün çıkarılıp 3 gün eklenerek 11 Haziran 2026 Perşembe tarihine ayarlanır; ft bu tarihin zaman damgasıdır.
• Yılın ilk günü 1 Ocak 2026 bir Date nesnesine atanır; bu tarih zaten Perşembe olduğundan ek bir kaydırma yapılmaz ve t referans noktası olur.
• Hafta numarası w = 1 + Math.ceil((ft – t) / (7 × 86 400 000)) formülüyle hesaplanır; sonuç 24 olarak bulunur ve “24. hafta” biçiminde gösterilir.

Kimler kullanır?

Kimler kullanır? Bu araç, proje yöneticileri, akademisyenler ve uluslararası iş takibi yapan profesyoneller için idealdir. ISO haftası, farklı ülkeler arasında tarih eşleşmesi gerektiğinde tutarlı bir referans sağlar ve raporlamada tarih tutarlılığını korur.

Ayrıca, yazılım geliştiricileri ve veri analistleri, tarihsel verileri ISO haftalarına göre gruplamak istediklerinde bu hesaplayıcıyı hızlı bir kontrol noktası olarak tercih eder. Haftalık istatistiklerin hazırlanması, satış raporları ve zaman çizelgeleri gibi uygulamalarda doğru hafta numarası kritik bir veri unsurudur.

Dikkat edilmesi gerekenler

Dikkat edilmesi gerekenler arasında, tarih girişinin ISO 8601 formatında (YYYY-AA-GG) olması ve geçerli bir takvim tarihine karşılık gelmesi bulunur. Geçersiz bir tarih girildiğinde fonksiyon null döndürür; bu durumda kullanıcı girişi yeniden kontrol etmelidir. Ayrıca, haftanın Perşembe gününe kaydırılması, ISO standardının haftanın başlangıç gününü (Pazartesi) ve ilk haftanın tanımını doğru şekilde yansıtmak için zorunludur.

Bir yıl içinde 52 ya da 53 ISO haftası bulunabilir; bu durum yılın ilk ve son günlerinin haftanın hangi gününe denk geldiğine göre değişir. Özellikle yılbaşı günleri Perşembe civarında olduğunda 53. hafta oluşabilir. Hesaplama sırasında kullanılan sabit milisaniye değeri (86 400 000) bir günün tam uzunluğunu temsil eder ve bu değer tüm yıllar için aynıdır.

• Tarih formatına dikkat edin; eksik ya da hatalı ay/gün değerleri hesaplamayı bozabilir.
• ISO haftası 1’den başlar; sonuç “0. hafta” gibi bir değer asla elde edilmez.
• Hafta numarası, yılın ilk Perşembe gününden itibaren sayılır; bu, uluslararası standartlarla uyumluluğu garantiler.