Şablon:Tarih

24 Mart 2023

Şablon belgelemesi[gör] [değiştir] [geçmiş] [temizle]

Bu şablon herhangi bir tarihi Vikipedi'de kullanılan standart tarih biçimlerinden birine dönüştürmeye yaramakta olup yalnızca dahili olarak diğer şablonlarda kullanılmalıdır. Eğer bir tabloda kullanmak için sıralanabilir tarihler elde edilmek isteniyorsa bunun yerine {{sıralanabilir tablo için tarih}} kullanılmalıdır.

Kullanımı[kaynağı değiştir]

Şablon, ikisi de isteğe bağlı olan iki parametre içermektedir:

{{tarih|<biçimlendirilecek tarih>|<tarih biçimi>}}

<biçimlendirilecek tarih> (isteğe bağlı) biçimlendirme işlemi uygulanacak olan tarihtir.
Tarih belirtilmemişse şablon geçerli tarihi verir.
Örneğin {{tarih}} kullanımı 24 Mart 2023 çıktısını verir. Hiçbir parametre belirtilmeden kullanıldığında güncel tarihin görünmesi istenmiyorsa {{btarih}} şablonu kullanılmalıdır.

Çoğu tarih biçimi Vikipedi'de tanımlı olsa da tanımlanamayan bir tarih girilecek olursa girilen metin olduğu gibi gösterilir. Girilecek tarihler için Türkçe ve İngilizce ay adları geçerli olup aynı zamanda ay adlarının İngilizce kısaltmaları da şablona tanımlıdır ve isteğe bağlı olarak kullanılabilir. Aynı zamanda günlerde "2nd", "55th" gibi İngilizce sıra sayıları da işlenebilmektedir.
Notlar:
- Bazı tarihler gerçek tarih olmasa bile dönüştürülürken bazı tarihler ise gerçek tarih olsa da dönüştürülmez. Detay için aşağıdaki bilinen sorunlar kısmına bakın.
- Yalnızca 1 Ocak 1000 ve 31 Aralık 9999 aralığındaki tarihler desteklenir. İki basamaklı yıllara ait tarihlerse 1970 ilâ 2069 arasındaysa desteklenir. 1000-9999 aralığı dışında bir tarih girilecek olunursa şablon tarafından yok sayılacaktır.
- Sayısal ay adları kullanılırken AA/GG/YYYY, GG-AA-YYYY, GG.AA.YYYY, YYYY/AA/GG, YYYY-AA-GG, AA/GG/YY, YY-AA-GG, GG.AA.YY formatları geçerli olup GG/AA/YYYY, AA-GG-YYYY, AA.GG.YY, YYYY.AA.GG, AA.GG.YYYY, GG-AA-YY, YY/AA/GG, GG/AA/YY, YY.AA.GG formatları geçersizdir.
<tarih biçimi> hangi tarih formatında çıktı verileceğine dair komuttur. Bu ikinci parametre için tanınmış değerler şunlardır:
- DMY g aaaa yyyy şeklinde çıktı verir (Örneğin: 31 Mayıs 2007). Varsayılan formattır.
- MDY aaaa g, yyyy şeklinde çıktı verir (Örneğin: Mayıs 31, 2007)
- YMD yyyy aaaa g şeklinde çıktı verir (Örneğin: 2007 Mayıs 31)
- ISO yyyy-aa-gg şeklinde ISO 8601 uyumlu çıktı verir (Örneğin: 2007-05-31)
- none hiçbir şekilde biçimlendirme uygulamaz
Notlar:
- Her ne kadar MediaWiki'nin otomatik tarih biçimlendirme mekanizması tarafından bu formatlar desteklense de Vikipedi'nin biçem kılavuzuna göre yalnızca DMY biçimi kullanılmaktadır.
- Vikipedi sayfaların geçerli sürümünü önbelleğe aldığından bazı durumlarda geçerli tarih yerine sayfanın önbelleğe alındığı tarih görüntülenebilir.

Örnekler[kaynağı değiştir]

Geçerli değerlerle[kaynağı değiştir]

Format	Girdi	Çıktı
belirtilmemiş	`{{tarih\|2006-08-04}}`	4 Ağustos 2006
	`{{tarih\|Aug 4, 2006}}`	4 Ağustos 2006
	`{{tarih\|4 Ağustos 2006}}`	4 Ağustos 2006
	`{{tarih\|4 Ağustos}}`	4 Ağustos
	`{{tarih\|Aug 4}}`	4 Ağustos
	`{{tarih\|}}`	24 Mart (eksik yıl)
	`{{tarih}}`	24 Mart 2023
	`{{tarih\|2=}}`	24 Mart 2023
DMY formatı	`{{tarih\|2006-08-04\|DMY}}`	4 Ağustos 2006
	`{{tarih\|Aug 4, 2006\|DMY}}`	4 Ağustos 2006
	`{{tarih\|4 Ağustos 2006\|DMY}}`	4 Ağustos 2006
	`{{tarih\|4 Ağustos\|DMY}}`	4 Ağustos
	`{{tarih\|Aug 4\|DMY}}`	4 Ağustos
	`{{tarih\|\|DMY}}`	24 Mart (eksik yıl)
	`{{tarih\|2=DMY}}`	24 Mart 2023
	`{{tarih\|{{tarih}}\|DMY}}`	25 Mart
MDY formatı	`{{tarih\|2006-08-04\|MDY}}`	Ağustos 4, 2006
	`{{tarih\|Aug 4, 2006\|MDY}}`	Ağustos 4, 2006
	`{{tarih\|4 Ağustos 2006\|MDY}}`	4 Ağustos 2006
	`{{tarih\|4 Ağustos\|MDY}}`	4 Ağustos
	`{{tarih\|Aug 4\|MDY}}`	Ağustos 4
	`{{tarih\|\|MDY}}`	Mart 24 (eksik yıl)
	`{{tarih\|2=MDY}}`	Mart 24, 2023
	`{{tarih\|{{tarih}}\|MDY}}`	Mart 25
YMD formatı	`{{tarih\|2006-08-04\|YMD}}`	2006 Ağustos 4
	`{{tarih\|Aug 4, 2006\|YMD}}`	2006 Ağustos 4
	`{{tarih\|4 Ağustos 2006\|YMD}}`	4 Ağustos 2006
	`{{tarih\|4 Ağustos\|YMD}}`	4 Ağustos
	`{{tarih\|Aug 4\|YMD}}`	Ağustos 4
	`{{tarih\|\|YMD}}`	Mart 24 (eksik yıl)
	`{{tarih\|2=YMD}}`	2023 Mart 24
	`{{tarih\|{{tarih}}\|YMD}}`	Mart 25
ISO formatı	`{{tarih\|2006-08-04\|ISO}}`	2006-08-04
	`{{tarih\|Aug 4, 2006\|ISO}}`	2006-08-04
	`{{tarih\|4 Ağustos 2006\|ISO}}`	4 Ağustos 2006
	`{{tarih\|4 Ağustos\|ISO}}`	--08-04
	`{{tarih\|Aug 4\|ISO}}`	--08-04
	`{{tarih\|{{#time: --m-d}}\|ISO}}`	--03-24 (eksik yıl)
	`{{tarih\|2=ISO}}`	2023-03-24
	`{{tarih\|{{tarih}}\|ISO}}`	Mart 25
none formatı	`{{tarih\|2006-08-04\|none}}`	2006-08-04
	`{{tarih\|Aug 4, 2006\|none}}`	Aug 4, 2006
	`{{tarih\|4 Ağustos 2006\|none}}`	4 Ağustos 2006
	`{{tarih\|4 Ağustos\|none}}`	4 Ağustos
	`{{tarih\|Aug 4\|none}}`	Aug 4
	`{{tarih\|\|none}}`	(boş)
	`{{tarih\|2=none}}`	(boş)
	`{{tarih\|{{tarih}}\|none}}`	24 Mart 2023

Diğer geçerli girişler[kaynağı değiştir]

Şablon, çok çeşitli giriş formatlarını doğru bir şekilde işleme yeteneğine sahiptir:

Girdi	Çıktı
`{{tarih\|1st December 2014}}` (sırasal 'st')	1 Aralık 2014
`{{tarih\|June 24 2006}}` (eksik virgüllü)	24 Haziran 2006
`{{tarih\|24 şubat 2006}}` (baş harfi küçük ay adı)	24 şubat 2006
`{{tarih\|24 jun}}` (İngilizce kısa ay adı)	24 Haziran
`{{tarih\|June 2006}}`	Haziran 2006
`{{tarih\|2006 June}}`	1 Haziran 2006
`{{tarih\|05/31/2012}}`	31 Mayıs 2012
`{{tarih\|31-05-2012}}`	31 Mayıs 2012

Geçersiz girişler[kaynağı değiştir]

Şablonun biçimlendiremeyeceği girdiler hiç değiştirilmeden görüntülenir. Bu durum köşeli parantez gibi karakterleri içeren girişlerde yaşanmaktadır:

Girdi	Çıktı
`{{tarih\|23007-031-24}}`	23007-031-24
`{{tarih\|[[1 Aralık]] [[2014]]\|YMD}}`	1 Aralık 2014
`{{tarih\|1 Aralık [[2014'te sinema\|2014]]\|MDY}}`	1 Aralık 2014
`{{tarih\|2014 Aralık 1\|DMY}}`	2014 Aralık 1 (olması gereken: 1 Aralık 2014)
`{{tarih\|2014 Aralık 1\|MDY}}`	2014 Aralık 1 (olması gereken: Aralık 1, 2014)
`{{tarih\|2014 Aralık 1\|ISO}}`	2014 Aralık 1 (olması gereken: 2014-12-01)
`{{tarih\|June 2006\|ISO}}`	Haziran 2006 (eksik gün, olması gereken: 2006-06--)
`{{tarih\|--08-24}}`	--08-24
`{{tarih\|-08-24}}`	24 Mart 2023
`{{tarih\|08-24}}`	08-24
`{{tarih\|2006-08--}}`	2006-08--
`{{tarih\|2006-08-}}`	2006-08-
`{{tarih\|32 Aug}}`	32 Aug
`{{tarih\|932 Aug}}`	932 Aug
`{{tarih\|0932 Aug}}`	0932 Aug
`{{tarih\|Aug 32}}`	Aug 32
`{{tarih\|Aug 932}}`	Aug 932
`{{tarih\|Aug 0932}}`	Aug 0932
`{{tarih\|31/05/2012}}`	31/05/2012 (olması gereken: 31 Mayıs 2012)
`{{tarih\|05-31-2012}}`	05-31-2012 (olması gereken: 31 Mayıs 2012)

Bilinen sorunlar[kaynağı değiştir]

Miladi olmayan tarihler miladi olarak kabul ediliyor

Şablonun oluşturduğu PHP kütüphanesi, bağlamdan bağımsız olarak tüm tarihlerin miladi takvim tarihleri olduğunu varsayıyor. Sonuç olarak:
- miladi olmayan bağlamda geçerli olması gereken bazı tarihler miladi olarak değerlendiriliyor ve bir sonraki güne dönüştürülüyor. Örneğin {{tarih|30 Şubat 1712}} girişi 30 Şubat 1712 sonucunu veriyor zira İsveç takviminde 30 Şubat 1712 geçerli bir tarih olmasına rağmen miladi takvimde şubat yalnızca 29 gün çektiğinden şablon tarihin yanlış yazıldığını varsayarak bir sonraki güne atıyor.
- İsveç takvimindeki 30 Şubat 1712 örneği ile aynı sebepten ötürü on tarih biçimlendirilemiyor. Bunlar 1000, 1100, 1300, 1400, 1500 yıllarının 29 Şubat ve 1 Mart tarihleri.
- geçerli olmaması gereken bazı tarihler sanki doğruymuş gibi dönüştürülüyor. Örneğin miladide geçerli olan 29 Şubat 1912 ya da 1 Şubat 1918 tarihleri Rus takviminde geçerli olmamasına rağmen geçerliymiş gibi işlem görüyor.

ISO 8601 formatı 1583 öncesi yıllar için uygun değil

ISO 8601 standardı, 1583 yılından daha önceki yılları kullanacak tarih formatları ile arasında karşılıklı anlaşırlık gerektiriyor. Bu format bu yıllar için ya da miladi takvimde olmayan herhangi bir tarih için kullanılmamalıdır.

Yıl bilgisi eksik olsa da ISO formatında tarih çıktısı veriliyor

ISO 8601'in mevcut 2004 sürümü yılın boş bırakılmasına izin vermiyor ancak şablon yıl eksik olsa bile ISO çıktısı veriyor.

Mikroformatlar desteklenmiyor

Bu şablon hCalendar ve hCard mikroformatlarını desteklemediğinden girilen tarih bilgileri bilgisayar programları tarafından okunması için ayrıştırılamıyor. Mikroformatları kullanabilmek için bilgi kutularında {{başlangıç tarihi}}, {{bitiş tarihi}}, {{doğum tarihi}} ya da türevi şablonlardan birini kullanılmalı.

Ayrıca bakınız[kaynağı değiştir]

Birden çok zaman birimi[kaynağı değiştir]


Tür	Ayarlanabilir	Güncel	Önceki	Sonraki
tarih ve zaman	{{zaman}}	{{güncel tarih}} (MDY) {{şu an-sade}} (DMY) {{şu an}} (tam cümle ile DMY)
yalnız tarih	{{yalnız tarih}} {{günlü tarih}} (haftanın günüyle)	{{tarih}} {{TARİH}} (tarihle ön ekli=) {{BUGÜN}} (DMY)	{{dün}} {{bugün-1}}	{{yarın}} {{bugün+1}}
yalnız zaman	{{yalnız zaman}}	{{GÜNCELZAMAN}} (12 saat formatında) {{GÜNCELZAMAN24}} (24 saat formatında)
bildirim		{{tam şu an}} (Madde sayısı ile mavi arka planlı saat ve tarih) {{tam şu an (kullanıcı iletisi)}} (Madde sayısı ile turuncu arka planlı saat ve tarih)
zaman damgası		{{zaman damgası}} (YYYYAAGGsasaddss formatı)

Tek zaman birimi[kaynağı değiştir]


Zaman birimi	Ayarlanabilir	Güncel	Önceki	Sonraki
SANİYE		{{CURRENTSECOND}}
DAKİKA		{{CURRENTMINUTE}}
SAAT		{{güncelsaat}}	{{saat-1}}	{{saat+1}}
HAFTA		{{GÜNCELHAFTANINGÜNÜ}} {{GÜNCELAYINGÜNÜ}}
Haftanın günü	{{haftanın günü}}	{{GÜNCELHAFTANINGÜNÜADI}} {{GÜNCELHAFTANINGÜNÜKISAADI}} {{GÜNCELHAFTANINGÜNÜ}}	{{GEÇENHAFTANINGÜNÜADI}} {{GEÇENHAFTANINGÜNÜKISAADI}}	{{GELECEKHAFTANINGÜNÜADI}} {{GELECEKHAFTANINGÜNÜKISAADI}}
AY	{{AYADI}} {{AYKISAADI}} {{AYSAYISI}} {{AY}} (sıfırla doldurulmuş)	{{güncel ay}} {{GÜNCELAYKISAADI}} {{GÜNCELAYSAYISI}} {{GÜNCELAYGÜNSAYISI}}	{{GEÇENAY}} (sıfırla doldurulamaz) {{GEÇENAYADI}} {{GEÇENAYKISAADI}}	{{GELECEKAY}} (sıfırla doldurulamaz) {{GELECEKAYADI}} {{GELECEKAYKISAADI}}
Ayın günü		{{güncel gün}}
YIL		{{GÜNCELYILYY}} {{GÜNCELYILOY}} {{GÜNCELISOYILI}} {{GÜNCELYIL}}	{{GEÇENYIL}}	{{GELECEKYIL}}
Yılın günü		{{GÜNCELYILINGÜNÜ}}
ONYIL	{{ONYIL}}	{{GÜNCELONYIL}}	{{GEÇENONYIL}}	{{GELECEKONYIL}}
YÜZYIL	{{YÜZYIL}}	{{GÜNCELYÜZYIL}}	{{GEÇENYÜZYIL}}	{{GELECEKYÜZYIL}}
BİNYIL	{{BİNYIL}}	{{GÜNCELBİNYIL}}

Yerine koyma işlemi için kullanılan şablonlar[kaynağı değiştir]

Ay:
{{Geçen ay}} girdisi "Şablon:Geçen ay" çıktısını verir
{{Gelecek ay}} girdisi "Şablon:Gelecek ay" çıktısını verir

Tekil şablonlar[kaynağı değiştir]

Şablon kategorileri[kaynağı değiştir]

Açıklama yok.

[Şablon veriyi değiştir]
Şablon parametreleri
Parametre		Açıklama	Tür	Durum
tarih	`1`	Biçimlendirilecek tarih Örnek 1 Ocak 2007	Tarih	önerilen
format	`2`	çıkan tarih biçimini kontrol eder Örnek MDY	Dize	önerilen

Yukarıdaki belgeleme içeriği Şablon:Tarih/belge sayfasından yansıtılmaktadır.
Kullanıcılar denemelerini bu şablonun deneme tahtası ve test senaryosu sayfalarında yapabilirler.
Lütfen kategorileri /belge alt sayfasına ekleyin. Bu şablon ile ilgili alt sayfalar için buraya tıklayınız.