Функция MOONPHASE
Функция MOONPHASE возвращает дробное числовое значение, соответствующее фазе Луны на указанную дату. Значение показывает положение Луны в лунном цикле, также называемом циклом лунации, и позволяет отличить растущую Луну от убывающей.
Формат:
- MOONPHASE(Date)
где Date — дата, при необходимости с указанием времени. В зависимости от того, где используется формула, это может быть:
- в отчете — столбец с датой, например D;
- в вычисляемом поле задачи — переменная поля даты, например {{Task.Creation date}};
- строка с датой, например "11-09-2026 07:02" в формате MM-DD-YYYY HH:mm.
Входное значение интерпретируется в часовом поясе пользователя с учетом правил перехода на летнее время, действующих на указанную дату. Если время не указано, используется полночь — 00:00.
Возвращаемое значение
Функция возвращает число больше −4 и меньше или равное 4. Основные опорные значения:
| Значение | Фаза Луны |
|---|---|
| 0 | Новолуние |
| 1 | Серп растущей Луны |
| 2 | Первая четверть |
| 3 | Выпуклая растущая Луна |
| 4 | Полнолуние |
| −3 | Выпуклая убывающая Луна |
| −2 | Последняя четверть — также называется третьей четвертью |
| −1 | Серп убывающей Луны |
Между этими опорными значениями функция возвращает дробные значения. Например, 1.5 соответствует положению между серпом растущей Луны и первой четвертью.
Чтобы определить состояние Луны:
- 0 — момент новолуния;
- больше 0 и меньше 4 — растущая Луна;
- 4 — момент полнолуния;
- меньше 0 — убывающая Луна.
Знак меняется в момент полнолуния. Непосредственно перед ним значение приближается к 4. В полнолуние оно равно 4. Сразу после этого значение становится близким к −4, а затем увеличивается по мере приближения следующего новолуния.
Числовое представление используется по соглашению Planfix. Возвращаемое значение показывает положение в лунном цикле, а не процент освещенной поверхности Луны.
Точность расчета
Для дат с 2000 по 2050 год включительно расчет использует табличные значения времени новолуний, первых четвертей, полнолуний и последних четвертей из таблиц NASA. Табличные значения округлены до ближайшей минуты.
Значения между соседними основными фазами рассчитываются методом линейной интерполяции. Поэтому промежуточные значения являются приблизительными.
Для дат до 2000 года и после 2050 года функция использует приблизительный расчет на основе средней продолжительности синодического месяца.
Если строку с датой не удается распознать, функция возвращает 0.
Примеры
В отчете
Вернуть фазу Луны для даты в столбце D:
MOONPHASE(D)
Здесь D — столбец отчета с датой. Замените D на идентификатор своего столбца.
В вычисляемом поле задачи
Вернуть фазу Луны на момент создания задачи:
MOONPHASE({{Task.Creation date}})
Вернуть то же значение, округленное до двух знаков после запятой:
ROUND(MOONPHASE({{Task.Creation date}}); 2)
Вместо даты создания можно использовать любую переменную поля даты задачи. Вставьте переменную с помощью селектора переменных в настройках вычисляемого поля.
При проверке новолуния, полнолуния или состояния растущей/убывающей Луны используйте значение до округления. Округление может превратить значение, близкое к 0 или 4, в соответствующее целое число.
Использование строки с датой
MOONPHASE("11-09-2026 07:02")
Это дата 9 ноября 2026 года. Если часовой пояс пользователя — UTC, результат равен 0 — новолуние. В другом часовом поясе та же строка соответствует другому моменту времени, поэтому результат будет отличаться.