+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| File | ++ | Statements | ++ | Branches | ++ | Functions | ++ | Lines | ++ |
|---|---|---|---|---|---|---|---|---|---|
| index.ts | +
+
+ |
+ 92.68% | +152/164 | +58.06% | +18/31 | +100% | +9/9 | +92.68% | +152/164 | +
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +81 +82 +83 +84 +85 +86 +87 +88 +89 +90 +91 +92 +93 +94 +95 +96 +97 +98 +99 +100 +101 +102 +103 +104 +105 +106 +107 +108 +109 +110 +111 +112 +113 +114 +115 +116 +117 +118 +119 +120 +121 +122 +123 +124 +125 +126 +127 +128 +129 +130 +131 +132 +133 +134 +135 +136 +137 +138 +139 +140 +141 +142 +143 +144 +145 +146 +147 +148 +149 +150 +151 +152 +153 +154 +155 +156 +157 +158 +159 +160 +161 +162 +163 +164 +165 | 1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +7x +7x +7x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +12x +12x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +5x +5x +5x +5x +5x +5x +5x +5x +7x +7x +2x +7x + +7x +1x +1x +1x +7x + + +7x +1x +7x + +7x +1x +7x + +7x +1x +1x +1x +7x + + +7x + + +7x +7x +7x +1x +7x + +7x +5x +5x +5x +1x +1x +1x +1x +1x +3x +3x +3x +3x +3x +3x +3x +3x +3x + + +3x +1x +1x +2x +2x +2x +3x +1x +1x +1x +1x +1x + | import moment from 'moment';
+import type { Moment as MomentInstance } from 'moment';
+import { toHijri, toGregorian, hmLong, hmMedium, hwLong, hwShort, hwNumeric } from 'hijri-core';
+import type { HijriDate, ConversionOptions } from './types';
+
+declare module 'moment' {
+ interface MomentStatic {
+ /**
+ * Construct a moment from a Hijri date.
+ * Throws if the date is invalid or outside the supported range.
+ * Call installHijri(moment) before use.
+ */
+ fromHijri(hy: number, hm: number, hd: number, options?: ConversionOptions): MomentInstance;
+ }
+
+ interface Moment {
+ /**
+ * Convert this moment to a Hijri date.
+ * Returns null if the date falls outside the supported calendar range.
+ */
+ toHijri(options?: ConversionOptions): HijriDate | null;
+
+ /** Return the Hijri year, or null if out of range. */
+ hijriYear(options?: ConversionOptions): number | null;
+
+ /** Return the Hijri month (1-12), or null if out of range. */
+ hijriMonth(options?: ConversionOptions): number | null;
+
+ /** Return the Hijri day, or null if out of range. */
+ hijriDay(options?: ConversionOptions): number | null;
+
+ /** Return true if this moment falls within the supported Hijri range. */
+ isValidHijri(options?: ConversionOptions): boolean;
+
+ /**
+ * Format this moment using Hijri-aware format tokens.
+ *
+ * Hijri tokens: iYYYY iYY iMMMM iMMM iMM iM iDD iD iEEEE iEEE iE ioooo iooo
+ * All other tokens are passed through to moment's own format().
+ *
+ * Returns an empty string if the date is outside the Hijri range.
+ */
+ formatHijri(formatStr: string, options?: ConversionOptions): string;
+ }
+}
+
+// Regex matching all Hijri format tokens. Ordered longest-first so iYYYY is
+// matched before iYY, iMMMM before iMMM, iDD before iD, iEEEE before iEEE.
+const HIJRI_TOKEN_RE = /iYYYY|iYY|iMMMM|iMMM|iMM|iM|iDD|iD|iEEEE|iEEE|iE|ioooo|iooo/g;
+
+/**
+ * Escape a literal string so moment.format() treats it as literal text.
+ * Wraps the value in square brackets, escaping any ] characters within.
+ */
+function escapeLiteral(value: string): string {
+ return '[' + value.replace(/]/g, '][]') + ']';
+}
+
+/**
+ * Install the Hijri plugin into the provided moment instance.
+ *
+ * @example
+ * import moment from 'moment';
+ * import installHijri from 'moment-hijri-plus';
+ * installHijri(moment);
+ */
+function install(momentInstance: typeof moment): void {
+ momentInstance.fn.toHijri = function (opts?: ConversionOptions): HijriDate | null {
+ return toHijri(this.toDate(), opts);
+ };
+
+ momentInstance.fn.hijriYear = function (opts?: ConversionOptions): number | null {
+ return this.toHijri(opts)?.hy ?? null;
+ };
+
+ momentInstance.fn.hijriMonth = function (opts?: ConversionOptions): number | null {
+ return this.toHijri(opts)?.hm ?? null;
+ };
+
+ momentInstance.fn.hijriDay = function (opts?: ConversionOptions): number | null {
+ return this.toHijri(opts)?.hd ?? null;
+ };
+
+ momentInstance.fn.isValidHijri = function (opts?: ConversionOptions): boolean {
+ return this.toHijri(opts) !== null;
+ };
+
+ momentInstance.fn.formatHijri = function (formatStr: string, opts?: ConversionOptions): string {
+ const hijri = this.toHijri(opts);
+ if (!hijri) return '';
+ const dow = this.day();
+ // Replace Hijri tokens with escaped literals, then pass the residual string
+ // to moment.format() so all standard tokens (YYYY, MMM, etc.) resolve correctly.
+ // Escaping is required because values like "Ramadan" would otherwise be
+ // interpreted by moment as format tokens (R, a, m, etc.).
+ const residual = formatStr.replace(HIJRI_TOKEN_RE, (token: string): string => {
+ switch (token) {
+ case 'iYYYY':
+ return escapeLiteral(String(hijri.hy).padStart(4, '0'));
+ case 'iYY':
+ return escapeLiteral(String(hijri.hy % 100).padStart(2, '0'));
+ case 'iMMMM':
+ // Non-null: hijri.hm is 1-12; hm-1 is always 0-11, within hmLong bounds.
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ return escapeLiteral(hmLong[hijri.hm - 1]!);
+ case 'iMMM':
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ return escapeLiteral(hmMedium[hijri.hm - 1]!);
+ case 'iMM':
+ return escapeLiteral(String(hijri.hm).padStart(2, '0'));
+ case 'iM':
+ return escapeLiteral(String(hijri.hm));
+ case 'iDD':
+ return escapeLiteral(String(hijri.hd).padStart(2, '0'));
+ case 'iD':
+ return escapeLiteral(String(hijri.hd));
+ case 'iEEEE':
+ // Non-null: dow is always 0-6 (day of week), within hwLong bounds.
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ return escapeLiteral(hwLong[dow]!);
+ case 'iEEE':
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ return escapeLiteral(hwShort[dow]!);
+ case 'iE':
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ return escapeLiteral(String(hwNumeric[dow]!));
+ // Era tokens: both iooo and ioooo map to the common abbreviation.
+ case 'iooo':
+ case 'ioooo':
+ return escapeLiteral('AH');
+ default:
+ return token;
+ }
+ });
+ return this.format(residual);
+ };
+
+ // Attach fromHijri as a property on the constructor. We use bracket notation and a type
+ // assertion because MomentStatic augmentation produces a DTS visibility error with some
+ // TypeScript configurations; attaching at runtime is equivalent and safe.
+ (momentInstance as unknown as Record<string, unknown>)['fromHijri'] = function (
+ hy: number,
+ hm: number,
+ hd: number,
+ opts?: ConversionOptions,
+ ): moment.Moment {
+ let greg: Date | null;
+ try {
+ greg = toGregorian(hy, hm, hd, opts);
+ } catch {
+ throw new Error(`Invalid or out-of-range Hijri date: ${hy}/${hm}/${hd}`);
+ }
+ if (!greg) {
+ throw new Error(`Invalid or out-of-range Hijri date: ${hy}/${hm}/${hd}`);
+ }
+ // Construct from explicit year/month/day to avoid UTC-to-local timezone
+ // shift when the Date object represents midnight UTC.
+ return momentInstance([greg.getUTCFullYear(), greg.getUTCMonth(), greg.getUTCDate()]);
+ };
+}
+
+export default install;
+export type { HijriDate, ConversionOptions, CalendarEngine } from 'hijri-core';
+export { registerCalendar, getCalendar, listCalendars } from 'hijri-core';
+ |