easter_date
(PHP 4, PHP 5, PHP 7, PHP 8)
easter_date — Отримати мітку часу Unix, що відповідає півночі на Великдень у заданому році
Опис
easter_date(?int $year = null, int $mode = CAL_EASTER_DEFAULT): int
Повертає мітку часу Unix, що відповідає півночі на Великдень у заданому році.
Дата Великодня була встановлена на Першому Нікейському соборі у 325 році до н. е. на честь неділі, що прямував за повним місяцем, що настав у день або після весняного рівнодення. Вважалося, що День весняного рівнодення завжди настає 21 березня, тому розрахунок дня Великодня зводився до визначення дати повного місяця і наступної неділі. Використовуваний алгоритм введений Діонісієм Малим близько 532 року. У юліанському літочисленні (до 1753) для відстеження фаз місяця використовувався простий 19-річний цикл. У григоріанському календарі (роки після 1753 - розроблений Христофором Клавіусом і Алоїзієм Ліліусом і введений Папою Григорієм XIII у жовтні 1582, а у Великій Британії та її колоніях у вересні 1752 р.) було додано 2 поправочних коефіцієнта, що збільшують точность.
Список параметрів
year
Рік повинен бути числом від 1970 до 2037 для 32-бітних або 2000000000 для 64-бітних систем. Якщо не вказано або null, буде використано поточний рік за місцевим часом.
mode
Дозволяє розраховувати дати Великодня на основі юліанського календаря, якщо встановлено значення **CAL_EASTER_ALWAYS_JULIAN**Смотрите такжеконстанти календаря
Значення, що повертаються
Повертає дату Великодня у вигляді позначки часу Unix.
Помилки
Буде викинуто виняток ValueErrorякщо значення року виявиться менше 1970 або більше 2037 для 32-бітних або 2 000 000 000 для 64-бітних систем.
список змін
| Версия | Опис |
|---|---|
| 8.3.0 | На 64-бітових системах параметр year тепер приймає значення в діапазоні від 1970 до 2000000000. |
| 8.0.0 | Параметрyear тепер може мати значення null |
| 8.0.0 | Буде викинуто виняток ValueError, если значение параметраyear виходить межі допустимого діапазону. Раніше викликалася помилка рівня E_WARNING та функція повертала false |
Приклади
Приклад #1 Приклад використання easter_date()****
Приклад #2 Приклад використання easter_date()** з об'єктом класу DateTime**
Примітки
Зауваження :
Функцияeaster_date() покладається на працюючі згодом системні функції бібліотеки мови Сі, а чи не працюючі з датою і часом внутрішні функції PHP. Внаслідок цього для визначення часового поясу, в якому вона має працювати, функція easter_date() використовує змінну оточення
TZ, а не заданий у PHP часовий пояс за замовчуванням, що може призвести до несподіваної поведінки у поєднанні з іншими функціями PHP для роботи з датами.Як обхідний шлях для розрахунку початку Великодня в поточному часовому поясі PHP можна використовувати функцію easter_days() з об'єктами класів DateTime і DateIntervalследующим образом:
Результат виконання наведеного прикладу:
Великдень у 2012 році припадає на April 8 Великдень у 2013 році припадає на March 31 Великдень у 2014 році припадає на April 20 Великдень у 2015 році припадає на April 5
Дивіться також
- Функцияeaster_days() - Отримати кількість днів між 21 березня та Великоднем у заданому році для розрахунку дня Великодня до 1970 або після 2037 року