Dharma Time

Телеграм-бот Dharma Time создан с помощью Codex, ChatGPT & Google AI-assistant, и работает в тестовом режиме. Все баг-репорты и предложения по улучшению можно писать в комментариях к этой записи. Однако перед этим настоятельно рекомендуется прочитать данный трактат, особенно разделы о том как производятся расчеты и о пройденных тестах.

Дисклеймер

Разработчики бота не преследуют цели оскорбить чьи-либо религиозные чувства, а лишь стремятся максимально корректно представлять информацию в соответствии с письменными источниками и традициями.

Информация, содержащаяся в данном боте, включая описания событий, рекомендации и указания на благоприятность или неблагоприятность определенных дней, предоставляется исключительно в ознакомительных и образовательных целях. Сведения основаны на религиозных, культурных и астрологических традициях различных духовных школ и не являются руководством к действию, равно как и медицинской, финансовой, юридической или иной профессиональной консультацией.

Пользователь самостоятельно принимает решения относительно использования информации, полученной с помощью бота. Разработчики не несут ответственности за возможные последствия ее применения, интерпретации или неправильного понимания.

Рекомендации по использованию

Юзать бота надлежит следующим образом: после выбора языка (русский или английский) и города (важно для расчета событий некоторых календарных модулей), юзеру предлагают определиться: «Астрономия» или «Дхарма» (вообще-то можно подключить и то и другое, но в порядке очереди), после чего открывается чудесная возможность подписаться на произвольное количество событий (да хоть на все).

АСТРОНОМИЯ

Луна — оповещать будет каждый день о текущем состоянии Луны по западной классической системе.

Солнце — солнцестояния и равноденствия, а также переходы нашего дневного светила в знаки тропического зодиака.

Затмения — лунные и солнечные.

ДХАРМА

Если вы не знаете, что значит это слово, и вам не нужны календари Азии, то просто листайте вниз до пункта «Предупреждения».

Тхеравада:

Шри-Ланка — все полнолуния (Пойя) и ланкийский новый год.

Таиланд — все тайские упосатхи, несколько праздничных полнолуний и тайский новый год.

Бирма — все бирманские упосатхи, несколько праздничных полнолуний и бирманский новый год.

Между бирманскими и тайскими упосатхами бывает сдвиг на сутки, и это не баг, а фича! У данных стран разные алгоритмы расчета буддийских лунных календарей, подробнее об этом будет рассказано дальше по тексту. Ради избежания дублей не рекомендую одновременно включать календарные модули «Таиланд» и «Бирма».

Если вам нужны только упосатхи по вашей локации, подключайте модуль «Луна» в разделе «Астрономия». Уведомления о состоянии Луны будут приходить каждый день, но только на упосатхи в оповещениях есть картинки, так что очень удобно.

Махаяна:

Тибет — все крупные праздники вместе с регулярными священными лунными днями. Новолуния посвящены Будде Шакьямуни, полнолуния — Будде Амитабхе, 29-е лунные дни — Дхармапалам, 8-е — Таре и т.д. Не во всех тибетских школах это так, но что поделать, пришлось приводить бот к какому-то общему знаменателю.

Если юзер выбрал «Тибет» в разделе «Дхарма» то после главного меню попадет в меню выбора подмодулей где увидит кнопку «Пугпа» — ежедневный тибетский календарь со следующими параметрами: цеше жаг (лунный день), животное дня, мева (цвет указывается посредством эмодзи сердечко) и паркха. Ко всему этому прилагаются соответствующие описания.

Китай — только крупные праздники без регулярных священных дней (возможно последние будут добавлены позже).

Япония — только самые крупные буддийские праздники.

Индуизм:

Северная Индия — Шиваратри, Холи, Дивали, Наваратри, Кришна Джанмаштами и много других праздников. Был избран именно североиндийский индуизм потому что он самый популярный, в том числе и на Западе (в будущем добавим другие). Если юзер выбрал «Северная Индия» в разделе «Дхарма», то в меню подмодулей он увидит чекбокс-кнопки: Панчанга, Экадаши, Прадош Врат, Санкранти, Шани и Сомвати Амавасья.

Подмодуль «Панчанга» — это индийская ежедневная астрология со следующими параметрами: титхи (лунный день) и его описание, варга (группа титхи), девата (божество дня), элемент, начало и конец титхи, накшатра (созвездие), раши (знак) и ваш город (чтобы вы не забыли его сменить в случае переезда).

Если юзер выбрал «Экадаши», то снизу выплывают радио-кнопки: «Вайшнава» и «Смарта» с вайшнавским и классическим способом расчета соответственно. А также сверху сразу появляется текст о том, что всё это значит. Если вы не знаете что такое экадаши, то просто пропускайте. Да и вовсе, если заметили кнопку с непонятным словом — не трогайте ее, а то, оно вам надо?

Предупреждения

Дальше по нажатии «Готово» юзер попадает в панель выбора предупреждений с чекбокс-кнопками тех календарных модулей, которые он начекбоксил ранее. Здесь он может отметить календари о событиях которых он хочет получать предупреждения за день.

После нажатия очередного «Готово» диалоговое окно подписок закрывается и с этого момента бот будет оповещать о выбранных событиях в случае их наступления. Оповещения сейчас настроены на полночь (начало суток) по временной зоне того города, который юзер указал в самом начале, а предупреждения о завтрашних событиях — на 5 минут позже, в 00:05.

Календарь

По команде /calendar открывается текущий месяц со стрелочками в прошлое и будущее, а также списком всех событий этого месяца в соответствии с выбранными модулями. Все фазы Луны в календаре не отображаются, только полнолуния, новолуния и четверти, причем не словами, а посредством эмодзи:

— Новолуние.

— Первая четверть.

— Полнолуние.

— Последняя четверть.

Поскольку солнцестояния бывают только в июне и декабре, а равноденствия — марте и сентябре, спутать их с чем-то невозможно, поэтому для их обозначения был выбран эмодзи: ️ сразу после него указано в какой знак перешло Солнце:

️ Солнце в Овне — весеннее равноденствие.

️ Солнце в Раке — летнее солнцестояние.

️ Солнце в Весах — осеннее равноденствие.

️ Солнце в Козероге — зимнее солнцестояние.

Затмения отмечаются черным кружочком — ️, который идет сразу после значка Луны: солнечные после новолуния, лунные после полнолуния. Все эти эмодзи нужны чтобы не перегружать интерфейс, а также из эстетических соображений. Стрелочками можно переключаться на прошлые и будущие месяцы, а по тыку на центральную кнопку (между стрелочками) внизу открывается выбор месяца этого года и чуть ниже — выбор года.

Если вы указали язык и город, а также подписались на календарные модули, то чтобы получить оповещения о сегодняшних событиях отправьте ему команду /today и он насыплет вам этого добра как из рога изобилия, особенно если вы много начекбоксили. В остальных случаях пользоваться этой командой нет смысла, оповещения будут приходить каждую полночь, зачем вызывать их еще раз. Если город не указан, то ничего работать не будет. Ясно, что для некоторых календарных модулей локация не важна, но мы решили, что у нас все равны перед законом (правилами) ибо нам так проще.

ВАЖНО! КАК ПРОИЗВОДЯТСЯ РАСЧЕТЫ?

Если вы заметили расхождения между ботом и другими календарями, прочитайте текст ниже.

Главный принцип проекта: никаких override-правок! Все события рассчитываются алгоритмически. Override-правки — это когда программа берет информацию, например, даты, из сторонних источников и тупо вносит их в свой календарь. Мы такое не практикуем. Для каждого календарного модуля есть свой набор правил по которым бот определяет время событий.

Еще один принцип проекта состоит в том, что многодневные события отображаются в календаре только первым днем периода, чтобы не перегружать интерфейс. Оповещения о них тоже отправляются только в первый день.

Даты лунных событий могут отличаться от некоторых интернет-календарей из-за различий традиций, часовых поясов и методов вычисления лунного дня. Для астрономии мы юзаем библиотеку Swiss Ephemeris. Источники астрономических расчетов:

1) Swiss Ephemeris, документация и описание библиотеки:

https://www.astro.com/swisseph/swisseph.pdf

2) Swiss Ephemeris Programming Guide, где описаны функции для фаз, elongation и расчета восходов/закатов:

https://www.astro.com/swisseph/swephprg.pdf

3) Описание панчанг-логики:

https://www.mypanchang.com/2017pdfs/2017vancouverbc-nanda.pdf

Ежедневное: Луна, Панчанга и Пугпа

В случае подписки на модуль «Луна» юзер будет каждый день получать оповещение о фазе Луны, лунном дне и прочих параметрах естественного спутника нашей планеты. Пример оповещения:

ЛУННЫЙ ДЕНЬ: 15

Начало: 00:36 29 июня 2026

Конец: 02:56 30 июня 2026

Возраст Луны: 14.2 дней

Закат Луны: 04:04

Восход Луны: 21:50

Освещенность: 100%

Полнолуние (микролуние)

Знак: Стрелец

А если юзер подключил модули «Северная Индия» и «Тибет» с подмодулями «Панчанга» и «Пугпа» (индийский и тибетский ежедневные календари) то внизу увидит еще и что-то вроде этого:

Титхи: Пурнима (15)

Луна в пике своей силы. Сегодня особенно благоприятны масштабные проекты, свадьбы, крупные инвестиции, изготовление лекарств, пуджи, закладка фундаментов и большие религиозные церемонии. Нежелательны хирургические операции и бурные эмоциональные выяснения отношений.

Начало: 00:36 29 июня 2026

Конец: 02:56 30 июня 2026

Варга: Пурна (полнота и завершение)

Девата: Чандра (бог луны)

Элемент: Вайю (воздух)

Накшатра: Мула

Раши: Дхану (Стрелец)

Город: Винники

Цеше жаг: 15

Высшая точка накопления заслуг. Стрижка очень благоприятна: притягивает удачу и благие обстоятельства.

День Деревянного Дракона (5)

Сегодня энергетически сильный, масштабный день, полный амбиций. Подходит для запуска крупных бизнес-проектов, проведения больших мероприятий и рекламы. Нежелательно проявлять высокомерие и гордыню. Людям, рожденным в год Собаки, рекомендуется проявлять дополнительную осторожность.

🤍 Мева: 6 (Металл)

День порядка, закона, духовной силы и интуиции. Благоприятно обращаться к учителям, совершать религиозные ритуалы и наводить порядок в делах. Избегайте высокомерия и излишней жесткости к окружающим.

Паркха: Два (Озеро / Металл)

Общение, радость, западное направление. Отличный день для дружеских встреч, переговоров, коммерции и творчества. Не рекомендуется проявлять агрессию и вступать в открытые судебные споры.

Как вы уже, наверное, поняли блок «Лунный день» показывает информацию по западному стилю, «Титхи» — по индийскому лунному календарю (панчанга), а «Цеше жаг» — по тибетскому.

Лунный день — это 12 градусов лунной эклиптики (время, за которое Луна удаляется от Солнца на 12 градусов), всего их 30.

Возраст Луны — сколько солнечных суток прошло после новолуния (0 градусов на лунной эклиптике, момент между 1 и 30 лунным днем).

Орбита Луны эллиптическая, лунная эклиптика — круглая (эллипс проецируется на круг) и скорость движения Луны не постоянна, согласно второму закону Кеплера: в перигее (ближе к Земле) Луна движется быстрее, в апогее (дальше от Земли) — медленнее. Поэтому лунный день варьирует от 19 до 27 часов, и может не совпадать с возрастом Луны (например, в 16 лунный день естественному спутнику нашей планеты может быть 14 солнечных дней).

Графа «Знак» показывает в каком знаке тропического зодиака была Луна в 00:00 текущих суток. «Раши» отображает знак сидерического зодиака, на момент локального восхода Солнца в терминологии индийского лунного календаря, но с расшифровкой в скобках. «Накшатра» — в каком созвездии (по панчанге) находилась Луна в то же время (восход Солнца). Город указан, чтобы юзер помнил, что расчеты панчанги зависят от локации и в случае переезда надо не забыть сменить ее также и в боте. Если города в одном часовом поясе, но отличаются по долготе на 100-200 км и больше, разница в расчетах панчанги между ними может быть ощутимой.

Что до графы «Элемент», то в разных традициях мухурта-шастры варги (группы титхи: Нанда, Бхадра, Джая, Рикта и Пурна) соотносятся с первоэлементами (панча-махабхута). В данном боте используется одна из таких традиций, в которой Нанде соответствует огонь (Агни), Бхадре — земля (Бхуми), Джайе — пространство (Акаша), Рикте — вода (Джала), а Пурне — воздух (Вайю). Эти соответствия приводятся в ознакомительных целях и могут отличаться в различных школах и региональных традициях.

Графа «Лунный день» показывает какой лунный день начался в текущие сутки. Например, если полнолуние начнется сегодня в 23:55 по локальному времени, то сегодняшние сутки считаются днем полнолуния. Графа «Титхи» тоже показывает лунный день, только по панчанге (индийскому лунному календарю): какой лунный день продолжался на локальном восходе Солнца текущих суток. Например, даже если полнолуние заканчивается несколькими минутами после восхода Солнца эти сутки всё равно считаются днем полнолуния. Согласно панчанге, сутки начинаются на восходе Солнца и заканчиваются на восходе следующего дня.

Если полнолуние начинается, например, сегодня в 23:55 то по классической западной системе считается, что полнолуние сегодня, а по панчанге — завтра (полнолуние продолжается на восходе Солнца завтрашнего дня). А если новолуние начинается сегодня в 00:05 то сегодня — новолуние по обеим схемам расчета. То есть «западный лунный календарь» и панчанга иногда оказываются смещенными друг относительно друга на сутки, но не всегда. Подобным образом ситуация обстоит и с тибетский лунным календарем, однако, о нем расскажем подробнее дальше по тексту.

Фазы Луны привязаны к лунным дням:

1–7 → Растущий серп

8 → Первая четверть

9–14 → Растущая Луна

15 → Полнолуние

16–22 → Убывающая Луна

23 → Последняя четверть

24–29 → Убывающий серп

30 → Новолуние

Из-за некоторых особенностей расчета и того, что продолжительность лунного дня не стабильна (с 19 по 27 часов) в индийских и тибетских календарях, возможны такие забавные ситуации:

Вриддхи титхи — удлиненный лунный день, когда один и тот же титхи растягивается на две даты григорианского календаря. Например, сегодня 8-й лунный день (Аштами) и завтра тоже он. В тибетском календаре это называется лхаг цеше жаг (сдвоенный лунный день).

Кшая титхи — пропавший лунный день, например, сегодня 3-й титхи, а завтра — 5-й. В этом случае 4-й начался сразу после восхода Солнца и закончился до восхода следующего дня (пропал). В тибетском календаре: чад цеше жаг (пропущенный лунный день).

Это характерные особенности индийских и тибетских лунных календарей (не баг, а фича!).

Затмения

В календаре по команде /calendar затмения всегда отображаются в соответствии с западной традицией (в день их начала), поэтому могут быть смещены на сутки в будущее относительно полнолуния/новолуния. Например, полнолуние/новолуние началось вчера в 23:55, а затмение — сегодня. Используйте команду /eclipse чтобы получить список затмений на текущий год, и глобальную информацию по ним. А по команде /eclipse <год> — список затмений на выбранный год, например, /eclipse 2025 — расскажет о затмениях 2025 года.

Индия

Модуль «Северная Индия» использует систему лунных месяцев Пурниманта (Purnimanta) и традицию Смарта (для вайшнавов мы в следующем апгрейде добавим дополнительные модули: Гаудия, Мадхва и Шри). В Пурниманте месяц заканчивается полнолунием и начинается на следующий день. Месяцы (Чайтра, Вайшакха, Джйештха, Ашадха, Шравана и т.д.) сдвигаются относительно южноиндийской системы Аманта (Amanta) на 15 дней.

По титхи на восходе Солнца рассчитываются события в модуле «Северная Индия» и дополнительных индийских подмодулях за исключением:

1) Санкранти — переход Солнца из одного знака сидерического зодиака в другой.

2) Прадош Врат — Трайодаши в Прадош Каль (вечерних сумерках).

3) Дивали — Картика Амавасья в Прадош Каль.

4) Маха Шиваратри — Кришна Чатурдаши ночью, особенно в Нишита Каль (сакральный полуночный период).

5) Ганеша Чатуртхи — Шукла Чатуртхи в Мадхьяне (середине светового дня).

В различных регионах Индии «змеиный праздник» Нага Панчами отмечают в разные дни ибо общеиндийского метода расчета для него не существует. Поэтому для бота мы просто выбрали один из самых популярных вариантов: 5-й титхи светлой половины месяца Шравана.

Событие вычисляется по титхи (индийским лунным дням), если внизу оповещения находится что-то вроде:

Титхи: Шукла Панчами (5)

Начало: 14:23 16 августа 2026

Конец: 14:30 17 августа 2026

И т.д.

Дополнительные индийские модули

После тыка по Северной Индии юзеру открывается прекрасная возможность подписаться на индийские подмодули: Панчанга (ежедневный календарь, о котором было рассказано выше), Экадаши (Вайшнава или Смарта), Прадош Врат, Санкранти и Амавасьи (Шани и Сомвати). Далее обо всем этом подробнее.

Экадаши (Вайшнава & Смарта)

В боте есть индивидуальные описания для всех 26 Экадаши (12 Кришна Пакши, 12 Шукла Пакши и 2 Адхика-масы), 8 основных и 16 второстепенных Маха-Двадаши. В описаниях указаны особенности каждого из этих дней, рекомендации и запреты. О том что нельзя употреблять бобовые и зерновые упоминается только в одном описании, потому что это и так все знают. Индивидуальные картинки есть для всех кроме 16 второстепенных Маха-Двадаши — для них одна картинка. На индивидуальных картинках написано название Экадаши\Маха-Двадаши и персонаж из той легенды, с которой связано данное событие.

Вайшнава Экадаши — стоит по умолчанию и подходит большинству вайшнавских сампрадай. Рассчитывается в соответствии с алгоритмами, принятыми в ИСККОН: по правилам гаудия-вайшнавской традиции, основанным на Хари-бхакти-виласе и панчанге. В этой системе главное чтобы Экадаши титхи (11-й лунный день светлой или темной половины лунного месяца) присутствовал во время арунодая (утренних сумерков, которые в разных традициях вычисляются по-разному, у нас это 96 минут перед локальным восходом Солнца). Плюс арунодая не должна «загрязняться» Дашами титхи (10-м лунным днем). Другими словами, 11-й лунный день должен начаться ранее 96 минут до восхода Солнца.

Фактически, арунодая равна двум мухуртам (48*2=96) до рассвета, первая из которых — Брахма-мухурта (самое благоприятное время для духовной практики). Если во время арунодая продолжается Дашами (10-й лунный день), то это Дашами-виддха (загрязнение Дашами) даже если на восходе уже есть 11-й титхи.

Маха-Двадаши — это 12-й лунный день, на который переносится пост экадаши в случае наличия Дашами-виддхи. В гаудия-вайшнавской системе такие дни считаются особенно благоприятными для духовной практики. В боте производится полный расчет Маха-Двадаши, учитывающий титхи, арунодая, накшатры и дополнительные правила гаудия-вайшнавской панчанги.

Смарта Экадаши — данная опция подходит смарта-брахманам, последователям Шанкары, большинству шайвов и некоторым шактам. Рассчитывается по смарта-панчанге, в которой не бывает Маха-Двадаши. Если Экадаши титхи длится два дня тогда первый день считается Смарта Экадаши, а второй — Вайшнава. Собственно в этом и состоит ключевое отличие между Смарта и Вайшнава.

Парана — это время в которое можно закончить экадаши-пост на следующий день. Правильная Парана считается очень важной частью соблюдения Экадаши во всех индийских традициях. Расчет выполняется на основе локального восхода Солнца, длительности Двадаши титхи и правил конкретной календарной традиции.

Бот рассчитывает время Парана индивидуально для выбранного населенного пункта и помещает его в каждое оповещение об Экадаши и Маха-Двадаши. Между параной бота и других источников может быть разница в 1-3 минуты из-за разных способов округления, небольших различий в широте\долготе одного и того же часового пояса в разных источниках, разной высоты горизонта\рефракции (для восхода солнца могут использоваться разные параметры), разных эфемерид и аянамш (бот использует Лахири, то есть примерно 24 градуса).

ВНИМАНИЕ! Если бот написал, что не может произвести надежные расчеты времени выхода из поста, то забагрепортите это здесь в комментах, пожалуйста.

Прадош Врат (Трайодаши)

Прадош Врат (сумеречный пост) выпадает на дату, у которой есть максимальное пересечение Трайодаши титхи (13-го лунного дня светлой или темной половины месяца) и Прадош Каль (вечерних сумерек, которые в разных традициях рассчитываются по-разному). В нашем боте Прадош Каль — это первая 1/5 ночи (времени от местного заката до следующего восхода солнца), то есть 3 динамические мухурты.

В большинстве случаев Прадош Врат назначается на день, когда Трайодаши дольше всего присутствует в Прадош Каль. Однако иногда встречаются редкие ситуации, когда Трайодаши вообще не затрагивает Прадош Каль ни в один из соседних дней. В таких случаях дата Прадош Врат определяется по дню, на восходе которого продолжается Трайодаши титхи.

Прадош Врат часто путают с Трайодаши. Однако Трайодаши — это просто 13-й лунный день, рассчитанный по панчанге (захвативший восход Солнца), а Прадош Врат — аскеза во время сумерек или целый день григорианского календаря, в котором Трайодаши титхи выпадает на Прадош Каль или, в редких случаях, на восход. Таким образом, Трайодаши и Прадош Врат — не одно и то же, несмотря на то, что во многих источниках часто пишут «Трайодаши» вместо «Прадош Врат».

Бот оповещает обо всех 7 Прадош Вратах (Сома Прадош Врат, если этот пост выпадает на понедельник, Гуру Прадош Врат — если на четверг и т.д.), для них есть индивидуальные описания и картинки. В описаниях указаны особенности данного дня, рекомендации и запреты.

Амавасьи (Шани & Сомвати)

Шани Амавасья — это новолуние, рассчитанное по панчанге (титхи на восходе Солнца), которое приходится на субботу (день Шанидева).

Сомвати Амавасья — новолуние, рассчитанное по панчанге (титхи на восходе Солнца), которое приходится на понедельник (день Шивы).

Санкранти

Санкранти рассчитывается по айанамше Лахири (Читра Пакша) как момент перехода Солнца из одного сидерического знака зодиака в другой. То есть когда сидерическая долгота Солнца становится кратной 30 градусам: 0 градусов — Меша Санкранти (Овен), 30 градусов — Вришабха Санкранти (Телец), 60 градусов — Митхуна Санкранти (Близнецы) и так далее. Карка Санкранти (вхождение в знак Рака и начало Дакшинаяны) — особенный, если он случается до местного восхода Солнца, то относится к предыдущему календарному дню.

В боте оповещения о Макара Санкранти (переходе Солнца в знак Козерога) будут приходить после подписки на модуль «Северная Индия» потому что это самое важное санкранти в году. А обо всех остальных бот будет уведомлять только после активации дополнительного модуля «Санкранти» (становится доступным после подписки на «Северную Индию»). Также в боте есть индивидуальные описания и картинки для всех 12 санкранти. В описаниях указаны особенности данного дня, рекомендации и запреты.

Шри-Ланка

Буддийский календарь Шри-Ланки лунно-солнечный, и его главной единицей является синодический лунный месяц (примерно 29,53 суток). Каждый месяц связан с определенным полнолунием и имеет свое название: Дуруту, Навам, Медин, Бак, Весак, Посон, Эсала, Никини, Бинара, Вап, Иль и Ундувап. Есть годы в которых не 12 полнолуний, как обычно, а 13 — из-за 11-дневной разницы между лунным (~354 дня) и солнечным (~365 дней) годами. Ну так вот, в 13-полнолунные годы шри-ланкийцы просто добавляют месяц с префиксом Адхи (Адхи Эсала, Адхи Весак и т.д.).

В календаре Шри-Ланки дни Пойя определяются по Пурнима титхи (полнолунию) в Мадхьяхана (середине светового дня). Для этого используется принцип Вьяпти (перекрытия): если Пурнима «владеет» моментом Мадхьяхана, то день считается Пойя, а если начинается после Мадхьяхана, то Пойя переносится на завтра. Из-за этого Пойя иногда смещается на сутки от астрономического полнолуния.

Календарь с днями Пойя ежегодно публикуется правительством Шри-Ланки в официальной Gazette. И кстати там все Пойя являются государственными выходными, в которые запрещена продажа алкоголя и сырого мяса.

Таиланд

Тайский буддийский календарь — лунно-солнечный, основанный на лунных месяцах и синхронизированный с солнечным годом через вставки. Традиция восходит к индийской астрономии, но они не считают по панчанге! Полнолуние в тайском календаре не всегда тождественно астрономическому, там так и сказано: «15-й день растущей Луны может не совпадать с реальным астрономическим полнолунием».

Для интеркаляций (вставок) используются два механизма:

1) Вставной месяц (дополнительный 8-й), когда после обычного 8 месяца идет еще один и тоже 8 (аналог бирманского leap month), представляете?

2) Вставной день, когда 7 месяц получает дополнительные сутки.

Месяцы имеют санскритские названия, но на практике чаще используются номера. Длина года в тайском календаре — штука непостоянная, бывают года с 354, 355 и даже с 384 днями, что в общем-то лол. То есть, в расчетах одной только привязкой тайского праздника к полнолунию не обойтись. Там еще куча мудреных правил со вставными днями\месяцами и лунными днями, которые могут расходиться с астрономическими фазами Луны, если им так захочется.

Короче, в модуле «Таиланд» бот считает не по астрономическим фазам Луны, а по правилам арифметического тайского календаря Маханикая: от полнолуния Каттика (25 ноября 2015) фигачит взад-вперед в соответствии с тайскими правилами.

Бирма

Буддийский календарь Бирмы — лунно-солнечный, основанный на системе Myanmar Era (ME), традиционной индийской астрономии и циклах интеркаляции (watat years), а все вычисления выполняются через Julian Day Number (JDN). Каждый лунный месяц начинается с новолуния, содержит 29 или 30 солнечных суток и делится на две части: растущую (waxing) и убывающую Луну (waning). Полнолуние всегда приходится на 15-й день растущей Луны и является главным религиозным событием. В боте используется классический тхеравадинский паттерн упосатхи: Waxing 8, Full Moon (Waxing 15), Waning 8 и New Moon. Бирманцы юзают систему високосных лет (watat years) для синхронизации лунного календаря с солнечным. В високосные годы добавляют дополнительный месяц Second Waso, а в некоторых случаях — день в месяце Найон.

Бот будет оповещать об основных бирманских буддийских праздниках, большинство которых привязаны к фазами Луны. Однако Тингьян — не таков, он рассчитывается солнечным алгоритмом бирманского календаря, но не по этой вашей современной астрономии с ее тропическим зодиаком. В общем, бот использует алгоритмы бирманского календаря с учетом лунных месяцев, високосных циклов, системы Myanmar Era, Second Waso и официальных правил Тингьян.

Праздничные полнолуния «Бирмы» и «Таиланда» подавляют упосатхи своих модулей. Другими словами, если вам пришло оповещение о тайском или бирманском праздничном полнолунии, то о соответствующей упосатхе в этот день вас оповещать уже не будут, потому что хватит с вас.

Тибет

В боте используется тибетский календарь Men-Tsee-Khang Phugpa (Тибетского института медицины и астрологии Мен-ци-кханг, традиции Пугпа), то есть календарь Далай-ламы. Он подходит большинству последователей тибетского буддизма, особенно школам Гелуг, Ньингма и Сакья. Это глобальный нелокализуемый календарь, события которого рассчитываются по тибетскому лунному дню на рассвете. За момент рассвета принимается 23:00 предыдущих суток по UTC (например, по московскому времени тибетский рассвет наступает в 02:00). Часовой пояс пользователя влияет только на локальное время отправки уведомлений.

В модуле «Тибет» Swiss Ephemeris используется только как вспомогательный математический бэкенд там, где это необходимо для реализации формул Пугпа, но не как источник фаз Луны или система расчета тибетского календаря. Математическая модель календаря опирается на исследования Сванте Янсона. Кроме того, мы используем традиционные соответствия тибетского буддизма:

* 8-й лунный день — День Тары;

* 10-й лунный день — День Гуру Ринпоче;

* 15-й лунный день (полнолуние) — День Будды Амитабхи;

* 25-й лунный день — День Дакини;

* 29-й лунный день — День Дхармапал (защитников Дхармы);

* 30-й лунный день (новолуние) — День Будды Шакьямуни.

Следует учитывать, что некоторые тибетские лунные дни могут:

* повторяться два дня подряд (lhag);

* отсутствовать (chad).

Это не баг, а фича! В случае сдвоенных дней (lhag) событие отображается только в первый день. В случае пропущенных дней (chad) события переносятся на предыдущий день согласно описанию тибетского альманаха у Александра Берзина. Лосар считается исключением, в случае chad его ставят на следующий день после последнего дня 12-го месяца.

Некоторые даты могут отличаться от западных фаз Луны, китайского лунного календаря, календарей других тибетских традиций и даже просто других монастырей. Это связано с тем, что разные школы и линии передач используют различные астрономические системы и правила интеркаляции.

Событие рассчитывается по тибетскому буддийскому календарю, если внизу оповещения вы видите что-то вроде:

Год Деревянной Змеи (6)

Месяц Земляного Кролика (12)

День Огненной Мыши (1)

Цеше жаг: 29

Число в скобках после животного — это порядковый номер животного в цикле: 1 — Мышь, 2 — Бык, 3 — Тигр, 4 — Кролик, 5 — Дракон, 6 — Змея, 7 — Лошадь, 8 — Овца, 9 — Обезьяна, 10 — Птица, 11 — Собака, 12 — Свинья. Названия животных приведены в соответствии с тибетской традицией: Птица вместо Петуха и Овца вместо Козы. «День Огненной Мыши» обозначает астрологическое животное суток, а «Цеше жаг» — номер тибетского лунного дня.

Как уже упоминалось ранее, после подписки на модуль «Тибет» юзер может выбрать подмодуль «Пугпа» и получать ежедневную тибетскую астрологию о которой было рассказано выше.

Китай

Для Китая бот юзает китайский лунный календарь: в какие григорианские сутки попадает начало астрономического новолуния, то и считается первым днем месяца. А дальше каждой последующей дате просто присваивается номер: 2-й день, 3-й, 4-й… 15-й и т.д. Смена лунного дня происходит в полночь по местному времени, а не в момент смены фазы Луны.

Япония

После реформ Мейдзи Япония перешла на григорианский календарь и поскольку официально праздники больше не привязаны к фазам Луны, бот по ним и не считает. Однако по многим датам эта страна так и не достигла общего консенсуса, поэтому здесь не всё так однозначно:

1) Сэцубун у нас поставлен просто на 3 февраля, поэтому в те редкие годы когда он смещается на 2 или 4 февраля бот всё равно будет оповещать 3 февраля. Пока что так, в будущем возможно доделаем.

2) О-бон в боте только современный августовский (самый распространенный), без июльского и традиционного лунного. Если будут желающие на два других (пишите здесь в комменты), может со временем добавим и их (с возможностью выбора). А также, поскольку в современной Японии Уламбана-э (Урабон-э) фактически слился с О-бон, я не стала добавлять его в бот.

3) Дни Каннон (Авалокитешвары) не имеют единого общеяпонского алгоритма расчета, поэтому они тоже в бот не попали.

4) Дни Дзидзо в пролете по той же причине.

Локализация календарей

А теперь, дорогие друзья, очень важный момент. Не все традиционные календари локализуются (пересчитываются под юзера в соответствии с его населенным пунктом) поэтому в некоторых календарных модулях мы жестко вшили соответствующие города:

1) Коломбо (Шри-Ланка)

2) Бангкок (Таиланд)

3) Янгон (Бирма)

4) Лхаса (Тибет)

5) Шанхай (Китай)

Если в сообщении от бота вы видите какой-то из этих городов, значит описанное в нем событие по нему и рассчитывается (не локализуется, как и все остальные в этом модуле).

Локализуемые модули:

1) Все модули раздела «Астрономия».

2) «Северная Индия» и ее подмодули.

3) Модуль «Япония» локализуется, хотя в нем события рассчитываются по григорианскому календарю.

Пройденные тесты

Под катом скучные отчеты, сами решайте читать их или нет. Если вы желаете понять являются ли какие-то расхождения ошибкой, то читать рекомендуется, если же просто из праздного любопытства сюда пришли — то вряд ли вам будет сильно интересно.

Благодарности

Выражается сердечная благодарность специалисту по тибетской астрологии Александру Хосмо за консультации по вопросам, связанным с реализацией модулей «Тибет» и «Пугпа». А также не меньшая благодарность Бханте Девамитте за ценные материалы о буддийских календарях Бирмы, Таиланда и Шри-Ланки.

В знак благодарности авторам проектов GCAL, JR & Splendid Moons за публикацию открытого исходного кода, позволившего изучить и независимо реализовать используемые в Dharma Time алгоритмы, я с помощью Google AI-assistant сделала обзоры на них здесь:

https://vc.ru/id6021040

Вместо заключения

Если, скурив данный мануал, вы всё равно считаете, что в Dharma Time ошибка или просто видите расхождение с каким-то более аФтаритетным источником, то смело пишите в комменты, указывая:

1) Населенный пункт, выбранный вами в боте.

2) Багованный модуль (подмодуль или настройки, если есть).

3) Подробное описание ошибки со ссылкой на источник с которым не сходится, если таковой есть.

Апгрейды после первого релиза

1 — Больше информации. Каталог статей о событиях, на которые будет вести ссылка из оповещения. Пока планируется только для модулей раздела «Дхарма». Полагаю, статьи будут составляться с помощью ChatGPT и Google AI-ассистента ибо невозможно объять необъятное и впихнуть невпихуемое, но постараюсь приглашать прошаренных экспертов для редактуры.

2 — Интерактивный веб-календарь. Список дат в хронологическом порядке так как он сейчас реализован по команде /calendar не очень удобен, поэтому в далекой перспективе планируется интерактивный веб-календарь, который будет открываться по ссылке в боте. Задел под это уже есть в ядре, просто фронтэнд пока не разработан.

3 — Дальнейшее масштабирование. Во многие уже существующие модули будут добавляться новые события. В разделе «Астрономия» будут дополнительные модули: «Метеоры» (метеорные потоки), «Кометы» (только именованные с периодом обращения менее 200 лет), «Планеты» (оппозиции и соединения планет, элонгации Меркурия и Венеры) и «Земля» (афелий и перигелий).

Новые индийские подмодули: «Санкашти Чатуртхи», «Винаяка Чатуртхи», «Шиваратри Врат» и «Пурнима Врат». Плюс как минимум две дополнительные Амавасьи: «Мауни» и «Сарва Питру». Ну и конечно же подмодуль «Вайшнава» с радио-кнопками: «Гаудия», «Шри» и «Мадхва» для разных сампрадай. В разделе «Дхарма» появятся следующие календарные модули:

1) «Южная Индия» с возможностью переключения между Пурниманта и Аманта. Фактически, индийские модули претерпят серьезную реорганизацию, но в конечном итоге всё станет элегантно и максимально комфортно для самых разных конфессий индуизма, как южных так и северных. Ни для кого не секрет, что североиндийская и южноиндийская культуры — это, как говорят одесситы, две большие разницы, но мы попробуем их склеить.

2) «Юнгдрунг Бон» (тот, который с Тонпа Шенрабом).

3) «Индонезия» (балийский индуизм, Сака и Павукон).

4) «Непал» (неварский буддизм).

5) «Вьетнам» (дзен-буддизм).

Два новых раздела (под «Астрономия» и «Дхарма»):

1. «Дзен дня» со следующими модулями:

«Рубаи», «Хайку» и «Стихи» — поэзия (3-4 строки в сутки).

«Бздурки» — однострочные или двухстрочные шуточные высказывания на эзотерические\философские\духовные темы, у которых автор неизвестен или авторство мое.

«Медитации» — одна строка в день подобного типа: Пусть все обретут мудрость и достаток. За что ты благодарен сегодня? Замечай промежуток между вдохом и выдохом.

«Микро-притчи» — сжатые до абзаца притчи (рерайт): суфийские, даосские, индийские (Панчатантра, Хитопадеша), джатаки и коаны. Смысл в том, чтобы в кратчайшие сроки познакомить юзеров с этим срезом культурного наследия человечества. Например, сборник джатак довольно объемный, редкая птица долетит до его середины. Но тратить всего несколько секунд в день на чтение ужатой до абзаца джатаки — вполне реально. Вряд ли мы сможем микромизировать все притчи, но со многими такой фокус, думаю, пройдет.

«Цитаты» — короткие отрывки (не больше абзаца) с указанием источника, в основном древние тексты. С возможностью выбора конфессии: индуизм (Шакти, Шива, Вишну, йога), буддизм (махаяна, ваджраяна, тхеравада, дзен) и другое (стоицизм, даосизм, суфизм, юмор и т.д.). А то вряд ли шайвам сильно интересны вайшнавские первоисточники, и наоборот. Тут смысл такой же как и с притчами: ни дня без строчки из священных писаний! Ну или не священных, смотря что вы там себе выберете.

Подписаться можно на один, несколько или все модули одновременно. Сообщения раздела «Дзен дня» будут оформляться в одно оповещение и присылаться ежедневно в полночь (как и все остальные). Дзен-события не попадут в календарь по команде /calendar, и будут рассчитываться по системе случайностей, которые, как известно, не случайны: каждому юзеру — индивидуальный хайку, рубаи, цитата (или что он там начекбоксил) в соответствии рандомным алгоритмом и законом кармы.

Дабы не нагружать систему слишком сильно, мы решили не добавлять в нее защиту от повторной отправки недавно присылавшегося контента. Так что если вам третий раз за неделю приходит один и тот же хайку, медитация или бздурка — значит, это ваша карма! Возможно, таким образом Вселенная на что-то намекает. Стоит помедитировать над этим тщательнее, ведь неспроста же это, ой, неспроста… Короче, отсутствие защиты от повторов — не баг, а фича!

2. Раздел «Другое» с модулями григорианских календарей: «Христианство» (радио-кнопки: «Католицизм», «Православие» со своими радио-кнопками для старого и нового стилей), «Государственные» (радио-кнопки: «Россия», «Украина», потом постараемся и другие страны), «Международные», «Профессиональные», «Интересные даты». Изначально бот планировался как Дхарма-календарь, но я уже не могу остановиться.

4 — Фича в календарь. Чтобы не перегружать календарь по команде /calendar в случае выбора юзером нескольких модулей из разделов «Дхарма» и «Другое», будет добавлен радио-переключатель внизу календаря (над кнопками со стрелками): «Хинду», «Будда» и «Другое» (индуизм, буддизм и остальное). Астрономия будет во всех вкладках, ибо ее не так уж много.

5 — Всякая мелочь. Возможно добавлю подмодуль «Рокуё» к «Японии» (но это не точно), а также индивидуальные картинки 16 второстепенным Маха-Двадаши (очень редким). Однако, данный пункт обладает самым низким приоритетом и, фактически, пока под вопросом. По нему принимаются идеи и предложения.

Дорожная карта

1) Первый релиз — готово ️

2) Летний апгрейд — в работе

* Все новые модули раздела «Дхарма».

* Все новые модули раздела «Астрономия».

* Модуль «Христианство» в разделе «Другое».

* Раздел «Дзен дня» с базовым набором контента.

* Реорганизация интерфейса и структуры проекта.

3) Осенний апгрейд — на стадии сбора материала

* Остальные модули раздела «Другое».

* Расширение контента раздела «Дзен дня».

* Доработка модуля «Экадаши» (Шри и Мадхва).

* Больше событий в модуль «Планеты»

4) Предновогодний праздничный апгрейд

* Веб-календарь с кучей фич.

5) Дальнейшее развитие проекта

* Добавление стран в модуль «Государственные».

* Расширение контента раздела «Дзен дня».

* Больше праздников во все модули.

Разделение заслуг

В первую очередь бот создан чтобы поддержать последователей самых разных дхармических учений в их духовной практике. Пусть этот бот помогает духовным искателям постепенно улучшать дисциплину и поддерживать регулярную садхану ради блага всех живых существ. Пусть все кто прочитает это описание сорадуются тому что большое количество практикующих обретут поддержку на пути Дхармы и улучшат свою духовную практику. Пусть благая карма от создания этого бота будет разделена между всеми живыми существами.

Ссылка на бот: @dharma_time_bot

Или так: https://t.me/dharma_time_bot

Страничка проекта: https://tssrkt.github.io

ПС: Баги в первом релизе неизбежны, поэтому шлите ваши баг-репорты и предложения по улучшению.