date-fns-hijri/.github/wiki/api/functions/formatHijriDate.md
Aric Camarata e8ade1f9c4 docs: add TypeDoc API generation (typedoc@0.28.19 + typedoc-plugin-markdown@4.11.0)
Add typedoc and typedoc-plugin-markdown as devDependencies. Add typedoc.json config
targeting src/index.ts with markdown output to .github/wiki/api. Add docs script to
package.json. Generate initial API reference pages.

Part of T-E8-03 — TypeDoc automation for all 12 JS/TS packages.
2026-05-30 16:41:59 -04:00

51 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

[**date-fns-hijri v1.0.1**](../README.md)
***
[date-fns-hijri](../README.md) / formatHijriDate
# Function: formatHijriDate()
> **formatHijriDate**(`date`, `formatStr`, `options?`): `string`
Defined in: [src/index.ts:185](https://github.com/acamarata/date-fns-hijri/blob/a86df7dc09266326214c15cbd459de48d21cea29/src/index.ts#L185)
Format a Gregorian date using Hijri calendar tokens.
Supported tokens:
| Token | Output | Example |
| ------- | -------------------------- | -------------- |
| iYYYY | 4-digit Hijri year | 1444 |
| iYY | 2-digit Hijri year | 44 |
| iMMMM | Long month name | Ramadan |
| iMMM | Medium month name | Ramadan |
| iMM | Zero-padded month (0112) | 09 |
| iM | Month (112) | 9 |
| iDD | Zero-padded day (0130) | 01 |
| iD | Day (130) | 1 |
| iEEEE | Long weekday name | Yawm al-Khamis |
| iEEE | Short weekday name | Kham |
| iE | Numeric weekday (1=Sun7=Sat)| 5 |
| ioooo | Long era | AH |
| iooo | Short era | AH |
Returns an empty string when the date falls outside the supported range.
## Parameters
### date
`Date`
### formatStr
`string`
### options?
[`ConversionOptions`](../interfaces/ConversionOptions.md)
## Returns
`string`