Tutorial

JavaScript Intl.DateTimeFormat: Dil ve Saat Dilimi Rehberi

Mehmet Fatih Ünal
8 Kasım 2026
7 dk okuma
#JavaScript#Intl#DateTimeFormat#Yerelleştirme#Saat Dilimi
JavaScript Intl.DateTimeFormat: Dil ve Saat Dilimi Rehberi

Intl.DateTimeFormat ne yapar?

Intl.DateTimeFormat, bir tarih veya zaman değerini seçilen dil ve biçim seçenekleriyle gösterir. Verinin hangi anı temsil ettiğini değiştirmez. MDN DateTimeFormat başvurusu, yerelleştirilmiş gösterim için kullanılan bu yerleşik API'yi açıklar.

Bir etkinlik kaydında birbirinden ayrı üç karar vardır: saklanan an, gösterimin dili ve gösterimde kullanılan saat dilimi. Türkçe seçilmesi otomatik olarak İstanbul saatinin, İngilizce seçilmesi de Londra saatinin istendiği anlamına gelmez. Bu kararları aynı değişkene yüklemek, uluslararası bir arayüzde tarihlerin beklenmedik biçimde değişmesine yol açar.

Dil ile saat dilimi nasıl ayrılır?

Locale ay ve gün adlarını, alan sırasını ve benzeri gösterim tercihlerini belirler. timeZone ise anın hangi bölgenin duvar saatiyle gösterileceğini seçer. Kurucu seçenekleri, bu iki girdiyi ayrı ayrı tanımlar:

const instant = new Date('2026-11-08T22:30:00Z');
const options = {
  dateStyle: 'long',
  timeStyle: 'short',
  timeZone: 'Europe/Istanbul'
};

const tr = new Intl.DateTimeFormat('tr-TR', options);
const en = new Intl.DateTimeFormat('en-GB', options);
console.log(tr.format(instant));
console.log(en.format(instant));

Her iki çıktı da İstanbul'da 9 Kasım günündeki 01:30 anını anlatır. Ayın adı ve alanların sunumu değişir; saklanan zaman değişmez. Z ile biten giriş, UTC'ye göre açık bir an belirtir. Aynı anı UTC saat dilimiyle gösterirseniz 8 Kasım 22:30 görürsünüz.

Sunucu ve tarayıcı farklı varsayılan saat dilimlerinde çalışabilir. Kullanıcıya belirli bir bölgeye göre gösterim sunuyorsanız timeZone değerini açıkça vermek, bu ortam farkını ortadan kaldırmanın bir parçasıdır. Kullanıcının kendi saat dilimi isteniyorsa da bu, ürünün bilinçli bir tercihi olmalıdır.

Tekrarlanan gösterimler için nasıl yardımcı yazılır?

Aynı seçeneklerle çok sayıda kayıt gösterirken biçimleyiciyi tekrar kullanabilirsiniz. Aşağıdaki yardımcı Date nesnesi bekler; metin çözümleme ve kullanıcı girdisi doğrulama sorumluluğu taşımaz:

const formatters = {
  tr: new Intl.DateTimeFormat('tr-TR', {
    dateStyle: 'long', timeStyle: 'short', timeZone: 'Europe/Istanbul'
  }),
  en: new Intl.DateTimeFormat('en-GB', {
    dateStyle: 'long', timeStyle: 'short', timeZone: 'Europe/Istanbul'
  })
};

function formatEventTime(value, locale = 'tr') {
  if (!(value instanceof Date) || Number.isNaN(value.getTime())) {
    throw new RangeError('A valid Date is required');
  }
  const formatter = locale === 'en' ? formatters.en : formatters.tr;
  return formatter.format(value);
}

console.log(formatEventTime(new Date('2026-11-08T22:30:00Z'), 'en'));

Bu kod yanlış ay veya gün içeren her metni takvim kurallarına göre doğrulamaz. Date oluşturmadan önce gelen verinin sözleşmesini denetlemek ayrı bir adımdır. Özellikle yerelleştirilmiş bir gösterim metnini sonradan yeniden Date'e çevirmeyi veri aktarım yöntemi yapmayın.

Sadece tarih içeren değer neden önceki güne kayabilir?

Takvim tarihi ile zaman çizelgesindeki an farklı veri türleridir. Doğum günü veya teslimat günü gibi bir alan, tek başına saat dilimi içermeyen bir takvim günü olabilir. Date.parse açıklaması, standart yalnızca-tarih biçiminin UTC olarak yorumlandığını belirtir:

const dateOnly = new Date('2026-11-08');
const inLosAngeles = new Intl.DateTimeFormat('en-US', {
  year: 'numeric', month: '2-digit', day: '2-digit',
  timeZone: 'America/Los_Angeles'
});
console.log(inLosAngeles.format(dateOnly));

Bu örnekte UTC gece yarısı Los Angeles'ta 7 Kasım'a denk gelir. Veri başlangıçta bir takvim günü ise bunu bir ana dönüştürüp başka bölgeye çevirmek istenen davranış olmayabilir. Önce alanın anlamını belirleyin; ardından uygun ayrıştırma ve gösterim politikasını seçin. Gün kaymasını saat sayısı ekleyerek rastgele telafi etmeyin.

formatToParts ne zaman kullanılır?

formatToParts, gösterimi gün, ay, yıl ve ayırıcı gibi türlendirilmiş parçalara ayırır. Yöntem başvurusu, parçaların anlamını açıklar. Tam gösterim metnini eğik çizgiye göre bölmek yerine ihtiyacınız olan bileşeni okuyabilirsiniz:

const formatter = new Intl.DateTimeFormat('en-GB', {
  year: 'numeric', month: '2-digit', day: '2-digit',
  calendar: 'gregory', numberingSystem: 'latn',
  timeZone: 'Europe/Istanbul'
});
const parts = formatter.formatToParts(new Date('2026-11-08T22:30:00Z'));
const fields = Object.fromEntries(
  parts.filter(part => part.type !== 'literal')
    .map(part => [part.type, part.value])
);
console.log(fields.year, fields.month, fields.day);

Bu örnekte alanlar 2026, 11 ve 09 değerlerini taşır. Bir parçayı görsel olarak vurgulayacaksanız, diğer parçaları ve locale'in belirlediği sırayı koruyun. Sonuçta çıkan kullanıcı metni API için genel amaçlı bir tarih serileştirme biçimi değildir.

Tarih gösterimi nasıl test edilir?

Gece yarısına yakın bir anı, en az iki saat dilimini ve TR/EN seçimini birlikte deneyin. Invalid Date girdisinin kontrollü biçimde reddedildiğini de doğrulayın. Tam metnin noktalaması farklı çalışma zamanı ve yerel veri sürümleri arasında değişebileceği için iş kuralını yalnızca belirli bir virgüle bağlamayın.

Testte önemli olan hangi günün ve saatin gösterildiğini bilmektir. URLSearchParams rehberindeki filtreler gibi, tarih filtrelerinin saklanan değeri ile kullanıcıya görünen etiketi de ayrı tutulmalıdır.

Sık sorulan sorular

en-GB seçmek Londra saatini seçer mi? Hayır. Saat dilimini timeZone belirler; verilmezse çalışma zamanının varsayılanı kullanılır.

Intl.DateTimeFormat tarih metinlerini ayrıştırır mı? Hayır. Bu yazıdaki yardımcı, önceden oluşturulmuş geçerli Date nesnelerini gösterir.

Tüm tarihleri saat dilimine çevirmek gerekir mi? Hayır. Sadece takvim günü taşıyan alanların anlamı, belirli bir anı taşıyan alanlardan farklıdır.

Daha Fazla İçerik

Blog sayfasında diğer yazılarımı keşfedin

Tüm Yazılar