Функция ФАЗАЛУНЫ
Функция ФАЗАЛУНЫ возвращает дробное числовое значение фазы Луны на указанную дату. Значение позволяет определить положение в лунном цикле и отличить растущую Луну от убывающей.
Формат:
- ФАЗАЛУНЫ(Дата)
- MOONPHASE(Date)
где Дата — дата, при необходимости со временем. В зависимости от того, где используется формула, это:
- в отчете — обозначение столбца с датой, например D;
- в вычисляемом поле — переменная поля с датой, например {{Задача.Дата создания}};
- строка с датой, например "09-11-2026 07:02".
Входная дата считается местным временем пользователя. При расчете учитываются его часовой пояс и действовавшее на эту дату летнее время. Если время не указано, используется начало суток — 00:00.
Возвращаемое значение
Функция возвращает число больше −4 и меньше либо равное 4. Основные ориентиры шкалы:
| Значение | Фаза |
|---|---|
| 0 | Новолуние |
| 1 | Растущий серп |
| 2 | Первая четверть |
| 3 | Растущая выпуклая Луна |
| 4 | Полнолуние |
| −3 | Убывающая выпуклая Луна, рассеивающая фаза |
| −2 | Последняя четверть |
| −1 | Убывающий серп, бальзамическая фаза |
Между этими значениями функция возвращает дробные числа. Например, 1.5 означает положение между растущим серпом и первой четвертью.
Для определения состояния Луны:
- 0 — момент новолуния;
- больше 0 и меньше 4 — растущая Луна;
- 4 — момент полнолуния;
- меньше 0 — убывающая Луна.
При полнолунии знак меняется: непосредственно перед ним значение приближается к 4, в момент полнолуния равно 4, а сразу после переходит к значениям, близким к −4. Затем значение увеличивается до 0 к следующему новолунию.
Числовая кодировка является соглашением ПланФикса. Значение функции обозначает положение в лунном цикле, а не процент освещенности Луны.
Точность расчета
Для дат с 2000 по 2050 год включительно используются табличные моменты новолуний, первых четвертей, полнолуний и последних четвертей из таблиц NASA. Табличные моменты указаны с точностью до минуты.
Между соседними основными фазами значение рассчитывается линейно. Поэтому промежуточные значения являются приближенными.
Для дат до 2000 года и после 2050 года используется приближенный расчет по средней продолжительности лунного месяца.
Если строку не удалось распознать как дату, функция возвращает 0.
Примеры
В отчете
Получаем фазу Луны на дату из столбца D:
ФАЗАЛУНЫ(D)
Здесь D — столбец отчета с датой. Вместо D укажите обозначение своего столбца.
В вычисляемом поле задачи
Получаем фазу Луны на момент создания задачи:
ФАЗАЛУНЫ({{Задача.Дата создания}})
Получаем то же значение с округлением до двух знаков после запятой:
ОКРУГЛ(ФАЗАЛУНЫ({{Задача.Дата создания}}); 2)
Вместо даты создания можно использовать переменную любого поля задачи с датой. Переменную удобнее вставлять из списка переменных в настройках вычисляемого поля.
Для проверок на новолуние, полнолуние и направление изменения фазы используйте значение без предварительного округления: округление может превратить близкое к 0 или 4 число в целое.
Для даты, заданной строкой
ФАЗАЛУНЫ("09-11-2026 07:02")
При часовом поясе пользователя UTC результат равен 0 — новолуние. В другом часовом поясе эта строка обозначает другой момент времени, поэтому результат будет отличаться.