6f165b79ad
- Add @typescript-eslint/parser and @typescript-eslint/eslint-plugin as direct devDependencies (were only transitive, not linked in node_modules) - Add files pattern and parserOptions.project to eslint.config.mjs so ESLint finds and type-checks src/**/*.ts files correctly - Run prettier --write to fix formatting across all src files |
||
|---|---|---|
| .github | ||
| src | ||
| .editorconfig | ||
| .gitignore | ||
| .npmrc | ||
| .nvmrc | ||
| CHANGELOG.md | ||
| eslint.config.mjs | ||
| LICENSE | ||
| package.json | ||
| pnpm-lock.yaml | ||
| pnpm-workspace.yaml | ||
| README.md | ||
| test-cjs.cjs | ||
| test.mjs | ||
| tsconfig.json | ||
| tsup.config.ts | ||
| typedoc.json | ||
pray-calc
Islamic prayer times for any location and date. The primary method uses a physics-grounded dynamic twilight angle algorithm that adjusts Fajr and Isha angles for latitude, season, Earth-Sun distance, and atmospheric conditions. Fourteen traditional fixed-angle methods are included for comparison. Single runtime dependency: nrel-spa.
Installation
npm install pray-calc
Quick Start
import { calcTimes } from 'pray-calc';
const times = calcTimes(
new Date('2024-06-21'),
40.7128, // New York latitude
-74.0060, // longitude
-4, // UTC offset (hours)
);
console.log(times.Fajr); // "03:51:24"
console.log(times.Sunrise); // "05:25:08"
console.log(times.Dhuhr); // "13:01:17"
console.log(times.Asr); // "17:02:43"
console.log(times.Maghrib); // "20:31:17"
console.log(times.Isha); // "22:07:43"
CommonJS:
const { calcTimes } = require('pray-calc');
Use calcTimesAll to get all 14 traditional method times alongside the dynamic result.
TypeScript
import type {
PrayerTimes,
FormattedPrayerTimes,
PrayerTimesAll,
MethodDefinition,
} from 'pray-calc';
Documentation
Full API reference, dynamic algorithm details, traditional method table, and high-latitude handling: GitHub Wiki
Related
- nrel-spa: NREL Solar Position Algorithm (the solar foundation)
- luxon-hijri: Hijri/Gregorian calendar
- moon-sighting: Crescent visibility calculations
Acknowledgments
Solar position calculations use nrel-spa, a port of the NREL SPA by Ibrahim Reda and Afshin Andreas. The seasonal twilight model builds on the work of Khalid Shaukat (Moonsighting Committee Worldwide).
License
MIT. Copyright (c) 2023-2026 Aric Camarata.