date-fns-hijri/.github/wiki/api/functions/addHijriMonths.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

39 lines
807 B
Markdown

[**date-fns-hijri v1.0.1**](../README.md)
***
[date-fns-hijri](../README.md) / addHijriMonths
# Function: addHijriMonths()
> **addHijriMonths**(`date`, `months`, `options?`): `Date`
Defined in: [src/index.ts:267](https://github.com/acamarata/date-fns-hijri/blob/a86df7dc09266326214c15cbd459de48d21cea29/src/index.ts#L267)
Add a number of Hijri months to a Gregorian date.
Handles year rollover automatically. Month addition wraps at month 12 and
increments the year. If the result's month has fewer days than the original
day, the day is clamped to the last day of the new month.
## Parameters
### date
`Date`
### months
`number`
### options?
[`ConversionOptions`](../interfaces/ConversionOptions.md)
## Returns
`Date`
## Throws
If the resulting Hijri date is outside the supported range.