moon-sighting/.github/wiki/api/functions/getMoonPhase.md
Aric Camarata 2992dcee21 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

40 lines
993 B
Markdown

[**moon-sighting v1.1.1**](../README.md)
***
[moon-sighting](../README.md) / getMoonPhase
# Function: getMoonPhase()
> **getMoonPhase**(`date?`): [`MoonPhaseResult`](../interfaces/MoonPhaseResult.md)
Defined in: [api/index.ts:487](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/api/index.ts#L487)
Compute the Moon's current phase, illumination, and next phase times.
Works WITHOUT a kernel (uses Meeus approximation).
## Parameters
### date?
`Date` = `...`
Date to compute phase for (default: now)
## Returns
[`MoonPhaseResult`](../interfaces/MoonPhaseResult.md)
MoonPhaseResult with illumination, phase name, age, and next events
## Example
```ts
const phase = getMoonPhase(new Date())
console.log(phase.phase) // 'waxing-crescent'
console.log(phase.phaseName) // 'Waxing Crescent'
console.log(phase.phaseSymbol) // '🌒'
console.log(phase.illumination)// 14.3 (percent)
console.log(phase.nextFullMoon)// Date object
```