Festivals

import { getDailyPanchang } from 'panchang-ts';

const loc = { latitude: 25.3176, longitude: 82.9739 };   // Varanasi
const r = getDailyPanchang(new Date('2026-11-08T12:00:00Z'), loc, { timezone: 330 })!;

for (const f of r.festivals) {
  // key: stable id. type: major | minor | ekadashi | smarta_ekadashi
  //      | vaishnava_ekadashi | pradosha | sankranti | eclipse
  console.log(f.key, f.name, f.type, f.description);
}
// narak_chaturdashi Narak Chaturdashi major Purnimanta: Kartika Krishna Paksha
// diwali Diwali major Purnimanta: Kartika Krishna Paksha

// name is localized, so match on key.
console.log(r.festivals.some(f => f.key === 'diwali'));   // true

package main

import (
	"fmt"
	"time"

	"github.com/ishankgupta95/panchang/source/go/v5/panchang"
	"github.com/ishankgupta95/panchang/source/go/v5/types"
)

func main() {
	s := panchang.New()
	loc := types.GeoLocation{Latitude: 25.3176, Longitude: 82.9739} // Varanasi
	date := time.Date(2026, 11, 8, 12, 0, 0, 0, time.UTC)

	r, ok, err := s.GetDailyPanchang(date, loc, types.PanchangOptions{
		Timezone: panchang.OffsetMinutes(330),
	})
	if err != nil {
		panic(err)
	}
	if !ok {
		return // no sunrise that day
	}

	for _, f := range r.Festivals {
		// Key: stable id. Type: major | minor | ekadashi | smarta_ekadashi
		//      | vaishnava_ekadashi | pradosha | sankranti | eclipse
		fmt.Println(f.Key, f.Name, f.Type, f.Description)
	}
	// narak_chaturdashi Narak Chaturdashi major Purnimanta: Kartika Krishna Paksha
	// diwali Diwali major Purnimanta: Kartika Krishna Paksha

	hasDiwali := false
	for _, f := range r.Festivals {
		if f.Key == "diwali" { // Name is localized; match on Key
			hasDiwali = true
		}
	}
	fmt.Println(hasDiwali) // true
}

import { computeFestivalsInRange, formatInZone } from 'panchang-ts';

const varanasi = { latitude: 25.3176, longitude: 82.9739 };
const show = (a: string, b: string) =>
  computeFestivalsInRange(new Date(a), new Date(b), varanasi, { timezone: 330 })
    .filter(d => d.festival.type.includes('ekadashi'))
    .forEach(d => console.log(formatInZone(d.date, 330).slice(0, 10), d.festival.type));

show('2027-10-25', '2027-10-26');   // Dashami-viddha  (Indira Ekadashi)
show('2026-08-23', '2026-08-24');   // vriddha Dwadashi (Shravana Putrada)
show('2030-03-15', '2030-03-16');   // vriddha Ekadashi, kshaya Dwadashi (Amalaki)
show('2027-07-29', '2027-07-30');   // kshaya          (Yogini)
show('2026-07-10', '2026-07-11');   // trisprisha      (Apara Ekadashi)
// 2027-10-25 smarta_ekadashi / 2027-10-25 ekadashi / 2027-10-26 vaishnava_ekadashi
// 2026-08-23 smarta_ekadashi / 2026-08-23 ekadashi / 2026-08-24 vaishnava_ekadashi
// 2030-03-15 smarta_ekadashi / 2030-03-15 ekadashi / 2030-03-16 vaishnava_ekadashi
// 2027-07-29 smarta_ekadashi / 2027-07-29 ekadashi / 2027-07-30 vaishnava_ekadashi
// 2026-07-10 smarta_ekadashi / 2026-07-10 ekadashi / 2026-07-11 vaishnava_ekadashi

s := panchang.New()
varanasi := types.GeoLocation{Latitude: 25.3176, Longitude: 82.9739}

show := func(y, m, d1, d2 int) {
	days, _ := s.ComputeFestivalsInRange(
		time.Date(y, time.Month(m), d1, 0, 0, 0, 0, time.UTC),
		time.Date(y, time.Month(m), d2, 0, 0, 0, 0, time.UTC),
		varanasi, types.YearlyListingOptions{Timezone: panchang.OffsetMinutes(330)})
	for _, d := range days {
		if strings.Contains(string(d.Festival.Type), "ekadashi") {
			fmt.Println(panchang.FormatInZone(time.UnixMilli(d.Date.Ms()), 330)[:10], d.Festival.Type)
		}
	}
}

show(2027, 10, 25, 26) // Dashami-viddha  (Indira Ekadashi)
show(2026, 8, 23, 24)  // vriddha Dwadashi (Shravana Putrada)
show(2030, 3, 15, 16)  // vriddha Ekadashi, kshaya Dwadashi (Amalaki)
show(2027, 7, 29, 30)  // kshaya          (Yogini)
show(2026, 7, 10, 11)  // trisprisha      (Apara Ekadashi)
// 2027-10-25 smarta_ekadashi / 2027-10-25 ekadashi / 2027-10-26 vaishnava_ekadashi
// 2026-08-23 smarta_ekadashi / 2026-08-23 ekadashi / 2026-08-24 vaishnava_ekadashi
// 2030-03-15 smarta_ekadashi / 2030-03-15 ekadashi / 2030-03-16 vaishnava_ekadashi
// 2027-07-29 smarta_ekadashi / 2027-07-29 ekadashi / 2027-07-30 vaishnava_ekadashi
// 2026-07-10 smarta_ekadashi / 2026-07-10 ekadashi / 2026-07-11 vaishnava_ekadashi

import { computeFestivalsInRange, formatInZone } from 'panchang-ts';

const varanasi = { latitude: 25.3176, longitude: 82.9739 };
const days = computeFestivalsInRange(
  new Date('2026-03-01T00:00:00Z'),
  new Date('2026-03-31T00:00:00Z'),
  varanasi,
  { timezone: 330 },
);
console.log(days.length);   // 23  (one entry per festival, not per day)

for (const d of days.filter(d => d.festival.type === 'major')) {
  console.log(formatInZone(d.date, 330).slice(0, 10), d.festival.key);
}
// 2026-03-03 holika_dahan
// 2026-03-04 holi
// 2026-03-06 sankashti_chaturthi
// 2026-03-19 ugadi
// 2026-03-19 gudi_padwa
// 2026-03-21 gangaur
// 2026-03-26 rama_navami

s := panchang.New()
varanasi := types.GeoLocation{Latitude: 25.3176, Longitude: 82.9739}

days, err := s.ComputeFestivalsInRange(
	time.Date(2026, 3, 1, 0, 0, 0, 0, time.UTC),
	time.Date(2026, 3, 31, 0, 0, 0, 0, time.UTC),
	varanasi,
	types.YearlyListingOptions{Timezone: panchang.OffsetMinutes(330)},
)
if err != nil {
	panic(err)
}
fmt.Println(len(days)) // 23 (one entry per festival, not per day)

for _, d := range days {
	if d.Festival.Type == "major" {
		fmt.Println(panchang.FormatInZone(time.UnixMilli(d.Date.Ms()), 330)[:10], d.Festival.Key)
	}
}
// 2026-03-03 holika_dahan
// 2026-03-04 holi
// 2026-03-06 sankashti_chaturthi
// 2026-03-19 ugadi
// 2026-03-19 gudi_padwa
// 2026-03-21 gangaur
// 2026-03-26 rama_navami

const chennai  = { latitude: 13.0827, longitude: 80.2707 };
const amritsar = { latitude: 31.6340, longitude: 74.8723 };
const jan14 = new Date('2025-01-14T12:00:00Z');
const jan13 = new Date('2025-01-13T12:00:00Z');
const names = (r: DailyPanchangResult) => r.festivals.map(f => f.name);

// All regional variants (default):
names(getDailyPanchang(jan14, chennai, { timezone: 330 })!);
// → ["Sankranti","Makar Sankranti","Pongal","Uttarayan","Magh Bihu","Ayyappa Makara Jyothi"]

// Tamil Nadu only:
names(getDailyPanchang(jan14, chennai, { timezone: 330, region: 'tamil-nadu' })!);
// → ["Sankranti","Makar Sankranti","Pongal"]

// Lohri fires on the Hindu day before the Makara transit, in Punjab scope:
getDailyPanchang(jan13, amritsar, { timezone: 330, region: 'punjab' })!
  .festivals.some(f => f.key === 'lohri');   // true

func names(r types.DailyPanchangResult) []string {
	out := []string{}
	for _, f := range r.Festivals {
		out = append(out, f.Name)
	}
	return out
}

s := panchang.New()
chennai := types.GeoLocation{Latitude: 13.0827, Longitude: 80.2707}
amritsar := types.GeoLocation{Latitude: 31.6340, Longitude: 74.8723}
jan14 := time.Date(2025, 1, 14, 12, 0, 0, 0, time.UTC)
jan13 := time.Date(2025, 1, 13, 12, 0, 0, 0, time.UTC)
ist := panchang.OffsetMinutes(330)

// err/ok checks omitted for brevity.
all, _, _ := s.GetDailyPanchang(jan14, chennai, types.PanchangOptions{Timezone: ist})
fmt.Println(names(all))
// [Sankranti Makar Sankranti Pongal Uttarayan Magh Bihu Ayyappa Makara Jyothi]

tn, _, _ := s.GetDailyPanchang(jan14, chennai, types.PanchangOptions{
	Timezone:               ist,
	InstantPanchangOptions: types.InstantPanchangOptions{Region: types.RegionTamilNadu},
})
fmt.Println(names(tn))
// [Sankranti Makar Sankranti Pongal]

pb, _, _ := s.GetDailyPanchang(jan13, amritsar, types.PanchangOptions{
	Timezone:               ist,
	InstantPanchangOptions: types.InstantPanchangOptions{Region: types.RegionPunjab},
})
lohri := false
for _, f := range pb.Festivals {
	if f.Key == "lohri" {
		lohri = true
	}
}
fmt.Println(lohri) // true

import { buildFestivalsTable } from 'panchang-ts';            // uses the engine

// Build at your build time, or on first launch in the background.
const table = buildFestivalsTable({
  location: { latitude: 25.3176, longitude: 82.9739 },   // Varanasi
  timezoneOffsetMinutes: 330,    // IST; -300 = US Eastern, 0 = UK
  startYear: 2024,
  endYear: 2031,
  languages: ['en', 'hi'],       // drop 'hi' for ~15% less, not half
  referenceLocation: 'Varanasi',
});
// …persist `table` as JSON (disk / MMKV / your bundler's asset pipeline).

s := panchang.New()

opts := types.BuildFestivalsTableOptions{
	Location:              types.GeoLocation{Latitude: 25.3176, Longitude: 82.9739},
	TimezoneOffsetMinutes: 330,
	StartYear:             2024,
	EndYear:               2031,
	Languages:             []types.FestivalsTableLanguage{types.TableLangEn, types.TableLangHi},
	ReferenceLocation:     "Varanasi",
}

table, err := s.BuildFestivalsTable(opts)
if err != nil {
	panic(err)
}

blob, _ := json.Marshal(table)
os.WriteFile("festivals.json", blob, 0o644) // …or MMKV, or your asset pipeline

import {
  readFestivalsForYear,
  readFestivalsForDate,
  readFestivalsYearRange,
} from 'panchang-ts/festivals';                                // engine-free

// Reads are lookups — no engine, no ephemeris.
readFestivalsYearRange(table);                    // { start: 2024, end: 2031 }
readFestivalsForYear(table, 2026)!.length;        // 146 festival days
const diwali = readFestivalsForYear(table, 2026)!
  .find(d => d.festivals.some(f => f.key === 'diwali'))!.date;   // '2026-11-08'
readFestivalsForDate(table, diwali).map(f => f.name);
// → ["Narak Chaturdashi","Diwali"]
readFestivalsForDate(table, diwali, 'hi').map(f => f.name);
// → ["नरक चतुर्दशी","दिवाली"]

blob, err := os.ReadFile("festivals.json")
if err != nil {
	panic(err)
}
var table types.AnyFestivalsFile // decodes a v1 (4.x) table too
if err := json.Unmarshal(blob, &table); err != nil {
	panic(err)
}

// Reads are lookups: no Session, no ephemeris.
fmt.Println(panchang.ReadFestivalsYearRange(table)) // {2024 2031}
days, _ := panchang.ReadFestivalsForYear(table, 2026, types.TableLangEn)
fmt.Println(len(days)) // 146 festival days

diwali := ""
for _, d := range days {
	for _, f := range d.Festivals {
		if f.Key == "diwali" {
			diwali = d.Date // "2026-11-08"
		}
	}
}
names := func(lang types.FestivalsTableLanguage) (out []string) {
	for _, f := range panchang.ReadFestivalsForDateKey(table, diwali, lang) {
		out = append(out, f.Name)
	}
	return out
}
fmt.Printf("%q\n", names(types.TableLangEn)) // ["Narak Chaturdashi" "Diwali"]
fmt.Printf("%q\n", names(types.TableLangHi)) // ["नरक चतुर्दशी" "दिवाली"]

import { computeFestivalsForYear, formatInZone } from 'panchang-ts';

const delhi = { latitude: 28.6139, longitude: 77.2090 };
const mondays = (opts: { masaSystem?: 'amanta'; region?: 'nepal' } = {}) =>
  computeFestivalsForYear(2025, delhi, { timezone: 330, ...opts })
    .filter(d => d.festival.key === 'shravan_somvar')
    .map(d => formatInZone(d.date, 330).slice(0, 10));

mondays();                          // purnimanta, the default
// → ["2025-07-14","2025-07-21","2025-07-28","2025-08-04"]
mondays({ masaSystem: 'amanta' });
// → ["2025-07-28","2025-08-04","2025-08-11","2025-08-18"]
mondays({ region: 'nepal' });       // the solar month
// → ["2025-07-21","2025-07-28","2025-08-04","2025-08-11"]

s := panchang.New()
delhi := types.GeoLocation{Latitude: 28.6139, Longitude: 77.2090}

mondays := func(opts types.YearlyListingOptions) []string {
	opts.Timezone = panchang.OffsetMinutes(330)
	days, _ := s.ComputeFestivalsForYear(2025, delhi, opts)
	out := []string{}
	for _, d := range days {
		if d.Festival.Key == "shravan_somvar" {
			out = append(out, panchang.FormatInZone(time.UnixMilli(d.Date.Ms()), 330)[:10])
		}
	}
	return out
}

fmt.Println(mondays(types.YearlyListingOptions{})) // purnimanta, the default
// [2025-07-14 2025-07-21 2025-07-28 2025-08-04]
fmt.Println(mondays(types.YearlyListingOptions{MasaSystem: types.Amanta}))
// [2025-07-28 2025-08-04 2025-08-11 2025-08-18]
fmt.Println(mondays(types.YearlyListingOptions{Region: types.RegionNepal})) // the solar month
// [2025-07-21 2025-07-28 2025-08-04 2025-08-11]