Şablon:Tarih

Vikikaynak sitesinden
Gezinti kısmına atla Arama kısmına atla

8 Temmuz 2020

Şablon belgelemesi Belgeleme

Bu şablon herhangi bir tarihi Vikikaynak'ta 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ı

Ş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 Şablon:Kayma kullanımı 8 Temmuz 2020 çı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

Geçerli değerlerle

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|}} 8 Temmuz (eksik yıl)
{{tarih}} 8 Temmuz 2020
{{tarih|2=}} 8 Temmuz 2020
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}} 8 Temmuz (eksik yıl)
{{tarih|2=DMY}} 8 Temmuz 2020
{{tarih|{{tarih}}|DMY}} 8 Temmuz 2020
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}} Temmuz 8 (eksik yıl)
{{tarih|2=MDY}} Temmuz 8, 2020
{{tarih|{{tarih}}|MDY}} 8 Temmuz 2020
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}} Temmuz 8 (eksik yıl)
{{tarih|2=YMD}} 2020 Temmuz 8
{{tarih|{{tarih}}|YMD}} 8 Temmuz 2020
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}} --07-08 (eksik yıl)
{{tarih|2=ISO}} 2020-07-08
{{tarih|{{tarih}}|ISO}} 8 Temmuz 2020
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}} 8 Temmuz 2020

Diğer geçerli girişler

Ş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

Ş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}} 9 Temmuz 2020
{{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

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

Ayrıca bakınız

Şablon:Tarih ve zaman şablonları Şablon:Temel sayfadayken

Açıklama yok.

Şablon parametreleri

ParametreAçıklamaTürDurum
tarih1

Biçimlendirilecek tarih

Örnek
1 Ocak 2007
Tarihönerilen
format2

çıkan tarih biçimini kontrol eder

Örnek
MDY
Dizeönerilen