@magmacomputing/tempo-plugin-astro

This is a Community plugin for the Tempo library that provides precise astronomical events (Equinoxes and Solstices) and maps them to traditional season names based on hemisphere.

👉 View the full documentation on our GitHub Pages

Installation

npm install @magmacomputing/tempo-plugin-astro

Usage

import { Tempo } from '@magmacomputing/tempo';
import { AstroTerm } from '@magmacomputing/tempo-plugin-astro';

// Pass the plugin to `Tempo.init` to register it into the runtime.
Tempo.init({ 
  extends: [AstroTerm] 
});

const t = new Tempo('2026-03-20');

// Get the Astronomical Event mapping
console.log(t.term.astro);
// Output: 'Vernal'

Response Payload

When resolving the term, the plugin intelligently returns the correct astronomical event and its corresponding traditional season based on your configured hemisphere (sphere):

{
  key: 'Vernal',     // Flips to 'Autumnal' if sphere is set to 'south'
  season: 'Spring',  // Flips to 'Autumn' if sphere is set to 'south'
  sphere: 'north',   // Flips to 'south' if sphere is set to 'south'
  event: 'Equinox',
  group: 'astronomy',
  year: 2026,
  month: 3,
  // ...
}

Did you know? t.term.astronomy.season returns the Astronomical season calculated by the precise timing of solstices and equinoxes. This will often differ from t.term.season in the core library, which uses standard Meteorological/Civil calendar boundaries (e.g., 1st of the month).

Documentation

For full API reference, advanced configuration, and detailed explanations of the astronomical calculations, please visit the official Astro Plugin Documentation ↗.

Licensing

This is a Community plugin. It is completely free and open-source for personal and commercial use. No license token is required.