bg-name-days

Bulgarian name days calendar library. Pure JavaScript, zero dependencies. 800+ names with variants, diminutives, Latin transliteration, and moveable Orthodox feast date computation.

Installation

npm install bg-name-days

Usage

import {
  getNameDay,
  getNamesByDate,
  isNameDay,
  getTodayNames,
  searchNames,
  getNamesByHoliday,
  getUpcomingNameDays,
  getAllNameDays,
  transliterate,
  orthodoxEaster,
} from 'bg-name-days';

Find name day by name

getNameDay('Георги');
// {
//   name: 'Георги', month: 5, day: 6,
//   holiday: 'Гергьовден', holidayLatin: 'Gergyovden',
//   tradition: 'orthodox', variants: ['Георгина', 'Гергана', ...],
//   isMoveable: false
// }

getNameDay('Georgi');  // Latin input works too
getNameDay('гошо');    // Case-insensitive, finds via variants → Георги

getNameDay('Стефан');
// Returns array — Стефан has multiple name days (Jan 9 + Dec 27)

getNameDay('Непознато');
// null

Get names by date

getNamesByDate('05-06');
// ['Георги', 'Георгина', 'Гергана', 'Гошо', 'Жоро', ...]

getNamesByDate(new Date(2026, 0, 1));
// ['Васил', 'Василка', 'Василена', ...]

Check if today is someone's name day

isNameDay('Георги', new Date('2026-05-06'));  // true
isNameDay('Георги', new Date('2026-05-07'));  // false
isNameDay('Цветан', new Date('2026-04-05')); // true (Цветница 2026)

Get today's celebrating names

getTodayNames();
// ['Валентин', 'Валентина', 'Трифон', ...] (on Feb 14)

Search names by prefix

searchNames('Гео');
// [{ name: 'Георги', date: '05-06', holiday: 'Гергьовден' }]

searchNames('Geo');  // Latin prefix search works too

Get names by holiday

getNamesByHoliday('Гергьовден');
// ['Георги', 'Георгина', 'Гергана', 'Гошо', 'Жоро', ...]

getNamesByHoliday('Цветница');
// 100+ flower-related names (Цветан, Роза, Виолета, Маргарита, ...)

Upcoming name days

getUpcomingNameDays(7);
// [
//   { month: 2, day: 14, holiday: 'Трифон Зарезан', names: ['Трифон', ...] },
//   { month: 2, day: 17, holiday: '...', names: [...] },
//   ...
// ]

getUpcomingNameDays(7, new Date('2026-05-01'));  // Custom start date

Transliterate

transliterate('Георги');   // 'Georgi'
transliterate('Yordan');   // 'Йордан'
transliterate('Щерьо');    // 'Shteryo'

Orthodox Easter

orthodoxEaster(2026);  // Date: April 12, 2026
orthodoxEaster(2027);  // Date: May 2, 2027

Get all name days

const all = getAllNameDays(2026);
// Array of 263 NameDayResult objects (fixed + resolved moveable for the year)

API Reference

Function	Parameters	Returns	Description
`getNameDay(name, year?)`	`string, number?`	`NameDayResult \| NameDayResult[] \| null`	Find name day by name (Cyrillic or Latin)
`getNamesByDate(date, year?)`	`string \| Date, number?`	`string[]`	Get all celebrating names for a date
`isNameDay(name, date)`	`string, Date`	`boolean`	Check if a name celebrates on a date
`getTodayNames()`	-	`string[]`	Get names celebrating today
`searchNames(prefix, year?)`	`string, number?`	`SearchResult[]`	Search names by prefix
`getNamesByHoliday(name, year?)`	`string, number?`	`string[]`	Get all names for a holiday
`getUpcomingNameDays(days, start?)`	`number, Date?`	`UpcomingNameDay[]`	Get upcoming name days
`getAllNameDays(year?)`	`number?`	`NameDayResult[]`	Get full dataset
`transliterate(text)`	`string`	`string`	Auto-detect and transliterate (CYR↔LAT)
`orthodoxEaster(year)`	`number`	`Date`	Calculate Orthodox Easter date

Moveable Feasts

Seven Bulgarian name days are tied to moveable Orthodox feasts (based on Easter):

Holiday	Offset	Example names
Тодоровден	Easter − 43	Тодор, Теодор, Дора, Божидар
Лазаровден	Easter − 8	Лазар, Лъчезар
Цветница	Easter − 7	Цветан, Роза, Виолета, Маргарита, 100+
Великден	Easter	Велика, Велико, Паскал
Спасовден	Easter + 39	Спас, Спасена
Петдесетница	Easter + 49	Трайко, Траян
Духов ден	Easter + 50	Пламен

The library automatically computes the correct dates for any year using the Gauss algorithm for Orthodox Easter.

Transliteration

Follows the official Bulgarian transliteration law (2009):

А	Б	В	Г	Д	Е	Ж	З	И	Й	К	Л	М	Н	О
A	B	V	G	D	E	Zh	Z	I	Y	K	L	M	N	O

П	Р	С	Т	У	Ф	Х	Ц	Ч	Ш	Щ	Ъ	Ь	Ю	Я
P	R	S	T	U	F	H	Ts	Ch	Sh	Sht	A	Y	Yu	Ya

Data Sources

Bulgarian Orthodox Church calendar
imeniden.com — comprehensive Bulgarian name day reference
Wikipedia: Именни дни в България
bg-patriarshia.bg — Patriarch's official calendar

Contributing Names

Know a Bulgarian name that's missing? PRs welcome!

Find the correct month file in src/data/ (e.g., may.js for May names)
Add your entry following the format in existing files
Run npm test to verify data integrity
Submit PR with source reference

License

MIT