İş Günü Hesaplama: API ve MCP

İş Günü Hesaplama için REST ve MCP başvurusu: girdi alanları, sınırlar, çıktılar, örnek istek ve gerçek yanıt. Ücretsiz, kayıt yok.

Kimlik: time.working-days.tr
Sürüm: 1.0.0
Erişim: Ücretsiz
Araç sayfası: İş Günü Hesaplama
Şema: GET /api/v1/tools/time.working-days.tr

Girdiler

Alan	Tür	Sınırlar	Varsayılan	Açıklama
`mode`	string	between \| add	between	Ne hesaplansın?
`start` (zorunlu)	string			Başlangıç tarihi · İki tarih arasında bu gün de sayılır. İş günü eklerken sayım ertesi gün başlar.
`end`	string			Bitiş tarihi · Bu gün de sayılır.
`days`	integer	≥ 1, ≤ 1.000		Eklenecek iş günü (iş günü)
`saturday`	string	no \| yes	no	Cumartesi iş günü mü?
`halfDays`	string	half \| working \| off	half	Arefe ve 28 Ekim yarım günleri
`administrativeLeave`	string	no \| yes	no	İdari izin günleri · Genelgeyle kamu personeline verilen izin günleri. Resmî tatil değildir.

Çıktılar

Alan	Tür	Açıklama
`endDate`	string	Son iş gününün tarihi
`workingDays`	number	İş günü (gün)
`calendarDays`	number	Takvim günü (gün)
`restDays`	number	Hafta sonu (gün)
`holidayDays`	number	Resmî tatil (iş gününe denk gelen) (gün)
`halfHolidays`	number	İş gününe denk gelen yarım gün tatil (gün)
`leaveDays`	number	İdari izin (iş gününe denk gelen) (gün)
`days`	array	İş gününden düşülen günler

Örnek istek

curl -X POST https://hesaplayici.com/api/v1/tools/time.working-days.tr/execute \
  -H 'Content-Type: application/json' \
  -d '{"input":{"mode":"between","start":"2026-01-01","end":"2026-12-31","saturday":"no","halfDays":"half","administrativeLeave":"no"},"locale":"tr"}'

Örnek yanıt

{
  "output": {
    "workingDays": 249.5,
    "calendarDays": 365,
    "restDays": 104,
    "holidayDays": 11.5,
    "halfHolidays": 3,
    "days": [
      {
        "day": "2026-01-01",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-03-19",
        "holiday": 0.5,
        "leave": 0
      },
      {
        "day": "2026-03-20",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-04-23",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-05-01",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-05-19",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-05-26",
        "holiday": 0.5,
        "leave": 0
      },
      {
        "day": "2026-05-27",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-05-28",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-05-29",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-07-15",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-10-28",
        "holiday": 0.5,
        "leave": 0
      },
      {
        "day": "2026-10-29",
        "holiday": 1,
        "leave": 0
      }
    ]
  },
  "steps": [
    {
      "id": "calendarDays",
      "formula": "takvim günü = bitiş − başlangıç + 1",
      "substitution": "takvim günü = 31.12.2026 − 01.01.2026 + 1",
      "value": 365,
      "unit": "gün"
    },
    {
      "id": "restDays",
      "formula": "hafta sonu = cumartesi + pazar",
      "substitution": "hafta sonu = 52 + 52",
      "value": 104,
      "unit": "gün"
    },
    {
      "id": "holidayDays",
      "formula": "resmî tatil = tam gün + yarım gün × 0,5",
      "substitution": "resmî tatil = 10 + 3 × 0,5",
      "value": 11.5,
      "unit": "gün"
    },
    {
      "id": "workingDays",
      "formula": "iş günü = takvim günü − hafta sonu − resmî tatil",
      "substitution": "iş günü = 365 − 104 − 11,5",
      "value": 249.5,
      "unit": "gün"
    }
  ],
  "notes": [
    {
      "kind": "difference",
      "code": "administrative_leave_in_range",
      "values": {
        "days": 1.5
      },
      "text": "Bu aralıkta kamu personeline 1,5 gün idari izin verildi; sonuç bu günleri iş günü saydı. Kamu personeliyseniz idari izin seçeneğini açın."
    }
  ],
  "meta": {
    "toolVersion": "1.0.0",
    "dataVersion": "2026-01-01",
    "locale": "tr"
  },
  "citation": {
    "url": "https://hesaplayici.com/zaman/is-gunu-hesaplama",
    "title": "İş Günü Hesaplama"
  }
}