🇹🇷 tr-time-date

Utilities for Turkey date/time, public holidays, and business day calculations.

Ramadan and Eid al-Adha (religious) holiday dates are loaded from annual JSON files in itemburada/religious/, while fixed national holidays are automatically generated.

Features

• Turkey local date/time helpers (nowTR, formatTR)
• Official holidays (official + religious)
• Religious holidays loaded from annual JSON files (e.g., 2026.json)
• Business day checks and business day counts for date ranges
• Includes TypeScript declarations

Installation

npm install tr-time-date

Quick Usage (CommonJS)

const {
  nowTR,
  formatTR,
  getHolidays,
  isHoliday,
  isWorkingDay,
  getWorkingDays
} = require("tr-time-date");

console.log(nowTR());
console.log(formatTR());

const holidays = getHolidays(2026);
console.log(holidays);

console.log(isHoliday("2026-10-29")); // true
console.log(isWorkingDay("2026-05-04")); // true/false

console.log(getWorkingDays("2026-05-01", "2026-05-31"));

API

• nowTR(): Date — returns current Date object in Turkey timezone (Europe/Istanbul).
• formatTR(date?: Date): string — returns a formatted Turkish locale string.
• getHolidays(year?: number): { year, fixed, religious, warning } — returns fixed and religious holidays for the year. warning is set when the religious JSON file is missing.
• isHoliday(date: string): boolean — check if an ISO date (YYYY-MM-DD) is a holiday.
• isWorkingDay(date: string): boolean — returns false for weekends and holidays.
• getWorkingDays(startDate: string, endDate: string): number — counts working days in an inclusive range.

Religious holiday JSON format

Files are located in itemburada/religious/ and use this shape:

{
  "ramazan": ["2026-03-19", "2026-03-20"],
  "kurban": ["2026-05-26", "2026-05-27"]
}

If a year file is missing, the library logs a warning such as:

[tr-time-date] 2027 religious holiday data not found. (itemburada/religious/2027.json)

TypeScript

Type definitions are included. Example:

import { getHolidays, isWorkingDay } from "tr-time-date";

Author

itemburadacomtr

License

MIT