Ücretsiz üye ol

İş Günü Hesaplama API

Teslim, vade ve süre hesabı için: hafta sonu, resmî tatil ve bayramlar atlanarak iş günü.

Ücretsiz pakette var JSON · Türkçe3 uç Kaynak: Resmî Gazete / mevzuat, VeriApi.Pro hesaplaması

/v1/takvim/is-gunu/ekle bir tarihten N iş günü sonrasını (eksi değerle öncesini) verir; başlangıç günü sayılmaz. /v1/takvim/is-gunu/say iki tarih arasındaki iş günü, hafta sonu ve tatil sayısını, aradaki tatillerin listesiyle döndürür.

Arifeler ve 28 Ekim yarım gündür; varsayılan olarak iş günü sayılır, arife=tatil ile tatil sayılabilir. cumartesi=true altı günlük çalışma düzeni içindir. Dini bayram tarihleri girilmemiş bir yıla taşan hesapta yanıt uyari alanıyla bunu belirtir.

Hızlı başlangıç

Anahtarınızı X-API-Key başlığında gönderin (ücretsiz anahtar al). Anahtarı tarayıcı koduna koymayın; sunucunuzdan çağırıp sonucu önbelleğe alın.

<?php
$ch = curl_init('https://api.veriapi.pro/v1/takvim/is-gunu/ekle?tarih=2026-05-22&gun=5');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_HTTPHEADER => ['X-API-Key: va_ANAHTARINIZ'],
]);
$yanit = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($yanit['veri']);
const yanit = await fetch("https://api.veriapi.pro/v1/takvim/is-gunu/ekle?tarih=2026-05-22&gun=5", {
  headers: { "X-API-Key": "va_ANAHTARINIZ" },
});
const { veri, kaynak } = await yanit.json();
console.log(veri);
import requests

r = requests.get("https://api.veriapi.pro/v1/takvim/is-gunu/ekle?tarih=2026-05-22&gun=5",
                 headers={"X-API-Key": "va_ANAHTARINIZ"}, timeout=10)
print(r.json()["veri"])
curl -H "X-API-Key: va_ANAHTARINIZ" \
  "https://api.veriapi.pro/v1/takvim/is-gunu/ekle?tarih=2026-05-22&gun=5"

Örnek yanıt

GET https://api.veriapi.pro/v1/takvim/is-gunu/ekle?tarih=2026-05-22&gun=5 — gerçek veriyle; listeler kısaltıldı.

{
  "veri": {
    "baslangic": "2026-05-22",
    "is_gunu": 5,
    "sonuc": "2026-06-03",
    "sonuc_gun": "Çarşamba",
    "takvim_gunu": 12,
    "tatiller": [
      {
        "tarih": "2026-05-26",
        "gun": "Salı",
        "ad": "Kurban Bayramı arifesi",
        "yarim_gun": true,
        "is_gunu_sayildi": true
      },
      {
        "tarih": "2026-05-27",
        "gun": "Çarşamba",
        "ad": "Kurban Bayramı 1. gün",
        "yarim_gun": false,
        "is_gunu_sayildi": false
      },
      {
        "tarih": "2026-05-28",
        "gun": "Perşembe",
        "ad": "Kurban Bayramı 2. gün",
        "yarim_gun": false,
        "is_gunu_sayildi": false
      },
      "… 1 öğe daha"
    ],
    "uyari": null
  },
  "kaynak": [
    {
      "kod": "mevzuat",
      "ad": "Resmî Gazete / mevzuat",
      "lisans": "FSEK m.31 (yayımlanmış mevzuat)",
      "atif": "Kaynak: Resmî Gazete'de yayımlanan mevzuat (2429 sayılı Kanun, Gelir Vergisi Genel Tebliği, Asgari Ücret Tespit Komisyonu kararı vb.)",
      "url": "https://www.resmigazete.gov.tr/"
    },
    {
      "kod": "hesap",
      "ad": "VeriApi.Pro hesaplaması",
      "lisans": "VeriApi.Pro",
      "atif": "VeriApi.Pro tarafından hesaplanmıştır",
      "url": null
    }
  ],
  "guncelleme": null,
  "bayat": false
}

Uçlar ve parametreler

GET /v1/takvim/is-gunu/ekle ücretsiz pakette 1 birim

N iş günü sonrası: hafta sonu, resmî tatil ve bayramlar atlanır

ParametreTürAçıklama
gun* tam sayı İş günü sayısı; eksi değer geriye sayar
tarih metin Başlangıç (YYYY-AA-GG), varsayılan bugün; sayılmaz
cumartesi evet/hayır Cumartesi iş günü sayılsın mı (6 günlük çalışma) varsayılan: False
arife metin Yarım gün tatiller (arifeler, 28 Ekim): is_gunu (öğleden önce çalışılır) ya da tatil varsayılan: is_gunu
GET /v1/takvim/is-gunu/say ücretsiz pakette 1 birim

İki tarih arası iş günü sayısı ve aradaki tatiller

ParametreTürAçıklama
baslangic* metin YYYY-AA-GG
bitis* metin YYYY-AA-GG
cumartesi evet/hayır Cumartesi iş günü sayılsın mı (6 günlük çalışma) varsayılan: False
arife metin Yarım gün tatiller (arifeler, 28 Ekim): is_gunu (öğleden önce çalışılır) ya da tatil varsayılan: is_gunu
baslangic_dahil evet/hayır varsayılan: True
bitis_dahil evet/hayır varsayılan: True
GET /v1/takvim/gun ücretsiz pakette 1 birim

Gün bilgisi: hafta numarası, iş günü, tatil

ParametreTürAçıklama
tarih metin

Konum alan uçlarda konum (slug), il + ilce (ad, slug ya da plaka) ya da enlem + boylam kullanılabilir. Tüm parametreler: OpenAPI belgesi.

Nerelerde kullanılır?

  • ✓E-ticarette tahmini teslim tarihi
  • ✓Hukuk ve muhasebede süre / vade hesabı
  • ✓Bordro ve izin hesapları

Kaynak ve lisans

  • Resmî Gazete / mevzuat · FSEK m.31 (yayımlanmış mevzuat) · kaynak
    Atıf: Kaynak: Resmî Gazete'de yayımlanan mevzuat (2429 sayılı Kanun, Gelir Vergisi Genel Tebliği, Asgari Ücret Tespit Komisyonu kararı vb.)
  • VeriApi.Pro hesaplaması · VeriApi.Pro
    Atıf: VeriApi.Pro tarafından hesaplanmıştır

Her yanıtın kaynak alanı bu bilgiyi taşır; veriyi gösterdiğiniz yerde atıf metnini yazın.

Sık sorulan sorular

İş günü API'si ücretsiz mi?

Evet; her pakette açıktır, istek başına 1 birim.

Arife günü iş günü mü?

Arifeler öğleden sonra tatildir. Varsayılan hesap arifeyi iş günü sayar; arife=tatil ile tatil sayabilirsiniz.

Köprü (idari izin) günleri dahil mi?

Hayır; idari izin kamu personeli içindir ve yalnızca Cumhurbaşkanlığı kararı yayımlanınca eklenir.

Bu sayfa şu aramalar için de: iş günü hesaplama · kaç iş günü · 10 iş günü sonra hangi gün · resmi tatil hariç gün hesaplama