aric/dayjs-hijri-plus
1
0
Fork 0
mirror of https://github.com/acamarata/dayjs-hijri-plus.git synced 2026-06-30 18:54:26 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
dayjs-hijri-plus/.wiki/Home.md
Aric Camarata 96dd9c5688 feat: initial release of dayjs-hijri-plus v1.0.0 
Day.js plugin adding Hijri calendar support via hijri-core. Adds
toHijri(), fromHijri(), hijriYear/Month/Day(), isValidHijri(), and
formatHijri() to all Day.js instances. Supports UAQ and FCNA calendars
via ConversionOptions. Format token escaping wraps substituted values
in Day.js bracket syntax to prevent re-interpretation as format tokens.
14 ESM + 8 CJS tests passing. Dual CJS/ESM build.
2026-02-25 14:15:07 -05:00

937 B
Raw Blame History

dayjs-hijri-plus

A Day.js plugin for Hijri calendar conversion and formatting. All calendar logic is delegated to hijri-core, making this package a thin, well-typed adapter with no calendar arithmetic of its own.

Install

pnpm add dayjs dayjs-hijri-plus hijri-core

Quick Usage

import dayjs from 'dayjs';
import hijriPlugin from 'dayjs-hijri-plus';

dayjs.extend(hijriPlugin);

dayjs('2023-03-23').toHijri();
// => { hy: 1444, hm: 9, hd: 1 }

dayjs('2023-03-23').formatHijri('iD iMMMM iYYYY');
// => '1 Ramadan 1444'

dayjs.fromHijri(1444, 10, 1).format('YYYY-MM-DD');
// => '2023-04-21'

Contents

  • API Reference — all methods, parameters, return types
  • Architecture — design decisions, delegation model, format token resolution

Part of the acamarata JavaScript library collection.