PHP: полный мануал с примерами, функциями и ООП

PHP 4+ · calendar

gregoriantojd(int $month, int $day, int $year): int

Архиву нужно сравнить две календарные даты без часов. Превратим 15 июня 2024 в целый номер дня 2460477.

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

if (условие) { ... } выполняет выбранную ветку. function name($value) { ... } объявляет повторяемое действие; return отдаёт результат вызывающему коду. === сравнивает также тип. Параметр, вызов, результат.

<?php
$jd = gregoriantojd(6, 15, 2024);
echo $jd, "\n";
echo jdtogregorian($jd), "\n";

2460477
6/15/2024

<?php
$month = 2;
$day = 31;
$year = 2024;
echo jdtogregorian(gregoriantojd($month, $day, $year)), "\n";
if (!checkdate($month, $day, $year)) {
    echo "reject input\n";
}
var_dump(gregoriantojd(1, 1, 0));

3/2/2024
reject input
int(0)

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

Сравните jdtogregorian, cal_to_jd, juliantojd. Как выбирать календарь.

• PHP: gregoriantojd
• PHP 8.5.11: реализация Calendar

PHP 4+ · calendar

juliantojd(int $month, int $day, int $year): int

Для документа со старым стилем 2 июня 2024 юлианского календаря соответствует 15 июня григорианского. Соединим их общим номером дня.

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

<?php
$jd = juliantojd(6, 2, 2024);
echo $jd, "\n";
echo jdtogregorian($jd), "\n";

2460477
6/15/2024

<?php
echo jdtogregorian(juliantojd(3, 1, 1900)), "\n";
echo jdtogregorian(juliantojd(3, 1, 2100)), "\n";
var_dump(juliantojd(1, 1, 0));

3/14/1900
3/15/2100
int(0)

Применение и ограничения. Правила юлианского календаря и начало года в реальном историческом источнике могли отличаться от этой математической модели. Модуль не восстанавливает локальную историю переходов.

Сравните jdtojulian, gregoriantojd, cal_to_jd. Как выбирать календарь.

• PHP: juliantojd
• PHP 8.5.11: реализация Calendar

PHP 4+ · calendar

frenchtojd(int $month, int $day, int $year): int

Каталог революционных документов хранит год I и месяцы республиканского календаря. Получим привычную дату первого дня этого календаря.

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

if (условие) { ... } выполняет выбранную ветку. function name($value) { ... } объявляет повторяемое действие; return отдаёт результат вызывающему коду. === сравнивает также тип. Параметр, вызов, результат.

<?php
echo frenchtojd(1, 1, 1), "\n";
echo jdtogregorian(frenchtojd(1, 1, 1)), "\n";

2375840
9/22/1792

<?php
$year = 3;
$day = 6;
if ($day <= cal_days_in_month(CAL_FRENCH, 13, $year)) {
    echo jdtogregorian(frenchtojd(13, $day, $year)), "\n";
}
echo cal_days_in_month(CAL_FRENCH, 13, 14), "\n";
echo jdtofrench(frenchtojd(13, 6, 14)), "\n";

9/22/1795
5
0/0/0

Применение и ограничения. Расширение намеренно не моделирует произвольное продолжение этого календаря после года XIV. Не используйте его для выдуманного «республиканского 2026 года».

Сравните jdtofrench, cal_days_in_month, cal_to_jd. Как выбирать календарь.

• PHP: frenchtojd
• PHP 8.5.11: реализация Calendar

PHP 4+ · calendar

jewishtojd(int $month, int $day, int $year): int

Для календаря мероприятий нужна дата 1 тишрея 5785: преобразуем её в 3 октября 2024 для обычного списка событий.

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

[...] создаёт массив; $info["year"] читает поле по ключу; foreach ($items as $item) последовательно берёт элементы. Ключи и значения.

<?php
$jd = jewishtojd(1, 1, 5785);
echo jdtogregorian($jd), "\n";
echo jdtojewish($jd), "\n";

10/3/2024
1/1/5785

<?php
foreach ([5780, 5784] as $year) {
    foreach ([6, 7] as $month) {
        $jd = jewishtojd($month, 1, $year);
        echo jdtojewish($jd), ': ', jdmonthname($jd, CAL_MONTH_JEWISH), "\n";
    }
}

7/1/5780: Adar
7/1/5780: Adar
6/1/5784: Adar I
7/1/5784: Adar II

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

Сравните jdtojewish, jdmonthname, cal_days_in_month. Как выбирать календарь.

• PHP: jewishtojd
• PHP 8.5.11: реализация Calendar

PHP 4+ · calendar

jdtogregorian(int $julian_day): string

Получить григорианскую запись уже известного номера дня — для подписи записи в архиве.

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

[...] создаёт массив; $info["year"] читает поле по ключу; foreach ($items as $item) последовательно берёт элементы. Ключи и значения.

В прикладном опыте sprintf собирает строку по шаблону: %04d — целое с четырьмя цифрами, %02d — с двумя и ведущим нулём. Оно только форматирует, а не проверяет дату.

<?php
$date = jdtogregorian(2460477);
echo $date, "\n";

6/15/2024

<?php
$jd = gregoriantojd(6, 15, 2024);
$parts = cal_from_jd($jd, CAL_GREGORIAN);
echo sprintf('%04d-%02d-%02d', $parts['year'], $parts['month'], $parts['day']), "\n";
echo jdtogregorian(0), "\n";

2024-06-15
0/0/0

Применение и ограничения. Строка удобна для диагностики, но для ISO-поля отчёта лучше cal_from_jd: не путайте месяц с днём. Для проверки импортируемой даты сопоставляйте обратные компоненты с исходными; преобразование само по себе не является универсальной валидацией.

Сравните gregoriantojd, cal_from_jd. Как выбирать календарь.

• PHP: jdtogregorian
• PHP 8.5.11: реализация Calendar

PHP 4+ · calendar

jdtojulian(int $julian_day): string

Получить юлианскую запись уже известного номера дня — для подписи записи в архиве.

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

<?php
$date = jdtojulian(2460477);
echo $date, "\n";

6/2/2024

<?php
echo jdtojulian(gregoriantojd(1, 7, 2024)), "\n";
echo jdtojulian(gregoriantojd(1, 7, 2101)), "\n";
echo jdtojulian(0), "\n";

12/25/2023
12/24/2100
0/0/0

Применение и ограничения. Это старый стиль; имя jdtojulian не означает получение JDN. Результат — три календарных компонента в строке. Для проверки импортируемой даты сопоставляйте обратные компоненты с исходными; преобразование само по себе не является универсальной валидацией.

Сравните juliantojd, cal_from_jd. Как выбирать календарь.

• PHP: jdtojulian
• PHP 8.5.11: реализация Calendar

PHP 4+ · calendar

jdtofrench(int $julian_day): string

Получить французскую республиканскую запись уже известного номера дня — для подписи записи в архиве.

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

<?php
$date = jdtofrench(2375840);
echo $date, "\n";

1/1/1

<?php
echo jdtofrench(2380952), "\n";
echo jdtofrench(2380953), "\n";
echo jdtofrench(gregoriantojd(6, 15, 2024)), "\n";

13/5/14
0/0/0
0/0/0

Применение и ограничения. Результат доступен только для JDN 2375840…2380952 (годы I…XIV). Современная дата даст 0/0/0. Для проверки импортируемой даты сопоставляйте обратные компоненты с исходными; преобразование само по себе не является универсальной валидацией.

Сравните frenchtojd, cal_from_jd. Как выбирать календарь.

• PHP: jdtofrench
• PHP 8.5.11: реализация Calendar

PHP 4+ · calendar

jdtojewish(int $julian_day, bool $hebrew = false, int $flags = 0): string

Список событий может показать числовую еврейскую дату или подпись буквами. Выберем формат явно, чтобы однобайтный текст не испортил UTF-8 страницу.

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

try выполняет попытку; catch (ValueError $error) обрабатывает недопустимое значение. Это не проверка текстовой формы: внешнюю строку сначала разбирают и проверяют. Исключения; Безопасный приём формы.

Перед вторым опытом: mb_convert_encoding перекодирует байты; имена кодировок в кавычках — её аргументы. Строка, байты и кодировка.

<?php
$jd = gregoriantojd(10, 3, 2024);
echo jdtojewish($jd), "\n";
echo jdmonthname($jd, CAL_MONTH_JEWISH), "\n";

1/1/5785
Tishri

<?php
$jd = gregoriantojd(10, 3, 2024);
$flags = CAL_JEWISH_ADD_ALAFIM_GERESH | CAL_JEWISH_ADD_GERESHAYIM;
$bytes = jdtojewish($jd, true, $flags);
$text = mb_convert_encoding($bytes, 'UTF-8', 'ISO-8859-8');
echo $text, "\n";

א' תשרי ה'תשפ"ה

<?php
echo jdtojewish(0), "\n";
try { jdtojewish(0, true); }
catch (ValueError $error) { echo "no Hebrew date\n"; }

0/0/0
no Hebrew date

Применение и ограничения. Флаги: ALAFIM_GERESH добавляет знак после тысяч, ALAFIM — слово «тысяч», GERESHAYIM — знаки в записи дня и года. Буквенная запись не уникальный ключ данных; храните числовые компоненты. Полная таблица констант.

Сравните jewishtojd, cal_from_jd, jdmonthname. Как выбирать календарь.

• PHP: jdtojewish
• PHP 8.5.11: реализация Calendar

PHP 4.1+ · calendar

cal_days_in_month(int $calendar, int $month, int $year): int

Форма расписания должна разрешить 29 февраля в 2024 году, но только 28 дней в 2023. Длину месяца вычисляет выбранный календарь.

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

if (условие) { ... } выполняет выбранную ветку. function name($value) { ... } объявляет повторяемое действие; return отдаёт результат вызывающему коду. === сравнивает также тип. Параметр, вызов, результат.

try выполняет попытку; catch (ValueError $error) обрабатывает недопустимое значение. Это не проверка текстовой формы: внешнюю строку сначала разбирают и проверяют. Исключения; Безопасный приём формы.

<?php
echo cal_days_in_month(CAL_GREGORIAN, 2, 2024), "\n";
echo cal_days_in_month(CAL_GREGORIAN, 2, 2023), "\n";

29
28

<?php
function acceptsDay($month, $day, $year) {
    if ($year < 1 || $year > 9999 || $month < 1 || $month > 12) {
        return false;
    }
    return $day >= 1 && $day <= cal_days_in_month(CAL_GREGORIAN, $month, $year);
}
var_dump(acceptsDay(2, 29, 2024), acceptsDay(2, 29, 2023), acceptsDay(0, 1, 2024));

bool(true)
bool(false)
bool(false)

<?php
echo cal_days_in_month(CAL_JEWISH, 6, 5780), "\n";
echo cal_days_in_month(CAL_JEWISH, 7, 5780), "\n";
try { cal_days_in_month(CAL_GREGORIAN, 13, 2024); }
catch (ValueError $error) { echo "invalid month\n"; }

0
29
invalid month

Применение и ограничения. Для григорианского DateTime объектный format("t") тоже возвращает длину месяца, но строкой и уже для даты объекта. Ни один вариант не вычисляет число рабочих смен, праздники или остаток дней до 27-го числа.

Сравните cal_info, cal_to_jd, jewishtojd. Как выбирать календарь.

• PHP: cal_days_in_month
• PHP 8.5.11: реализация Calendar

PHP 4.1+ · calendar

cal_info(int $calendar = -1): array

Нужен список поддерживаемых календарей и названия месяцев для административной формы. Получим метаданные, а не дату «сегодня».

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

[...] создаёт массив; $info["year"] читает поле по ключу; foreach ($items as $item) последовательно берёт элементы. Ключи и значения.

<?php
$info = cal_info(CAL_GREGORIAN);
echo $info['months'][2], "\n";
echo $info['maxdaysinmonth'], "\n";

February
31

<?php
foreach (cal_info() as $id => $info) {
    echo $id, ': ', $info['calname'], ' / ', $info['calsymbol'], "\n";
}

0: Gregorian / CAL_GREGORIAN
1: Julian / CAL_JULIAN
2: Jewish / CAL_JEWISH
3: French / CAL_FRENCH

Применение и ограничения. Не используйте cal_info как локализатор и не считайте maxdaysinmonth валидатором конкретной даты. Справочник можно получать один раз при построении формы; повторный вызов для каждой ячейки ничего не добавляет.

Сравните cal_days_in_month, jdmonthname, cal_from_jd. Как выбирать календарь.

• PHP: cal_info
• PHP 8.5.11: реализация Calendar

PHP 4.1+ · calendar

cal_to_jd(int $calendar, int $month, int $day, int $year): int

Импорт принимает календарную систему отдельным полем. Один общий вызов позволяет преобразовать выбранную систему без четырёх разных веток.

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

[...] создаёт массив; $info["year"] читает поле по ключу; foreach ($items as $item) последовательно берёт элементы. Ключи и значения.

try выполняет попытку; catch (ValueError $error) обрабатывает недопустимое значение. Это не проверка текстовой формы: внешнюю строку сначала разбирают и проверяют. Исключения; Безопасный приём формы.

<?php
echo cal_to_jd(CAL_JULIAN, 6, 2, 2024), "\n";
echo cal_to_jd(CAL_GREGORIAN, 6, 15, 2024), "\n";

2460477
2460477

<?php
$calendar = CAL_GREGORIAN;
$month = 2; $day = 31; $year = 2024;
$jd = cal_to_jd($calendar, $month, $day, $year);
$actual = cal_from_jd($jd, $calendar);
var_dump($actual['month'] === $month && $actual['day'] === $day && $actual['year'] === $year);
try { cal_to_jd(99, 1, 1, 2024); }
catch (ValueError $error) { echo "unknown calendar\n"; }

bool(false)
unknown calendar

Применение и ограничения. Когда система фиксирована, gregoriantojd или другая специализированная функция делает намерение заметнее. Общий вызов полезен на границе импорта, где тип календаря — часть данных.

Сравните cal_from_jd, gregoriantojd, juliantojd, frenchtojd, jewishtojd. Как выбирать календарь.

• PHP: cal_to_jd
• PHP 8.5.11: реализация Calendar

PHP 4.1+ · calendar

cal_from_jd(int $julian_day, int $calendar): array

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

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

[...] создаёт массив; $info["year"] читает поле по ключу; foreach ($items as $item) последовательно берёт элементы. Ключи и значения.

<?php
$date = cal_from_jd(2460477, CAL_GREGORIAN);
echo $date['day'], '.', $date['month'], '.', $date['year'], "\n";
echo $date['dayname'], "\n";

15.6.2024
Saturday

<?php
foreach ([CAL_GREGORIAN, CAL_JULIAN] as $calendar) {
    $date = cal_from_jd(2460477, $calendar);
    echo $date['date'], ' / ', $date['dow'], "\n";
}
$missing = cal_from_jd(0, CAL_JEWISH);
echo $missing['date'], "\n";
var_dump($missing['dow']);

6/15/2024 / 6
6/2/2024 / 6
0/0/0
NULL

Применение и ограничения. Нужна только готовая подпись — используйте jdtogregorian и родственников. Нужны поля для CSV/API — этот массив позволяет избежать неоднозначного повторного парсинга.

Сравните cal_to_jd, jdtogregorian, jddayofweek, jdmonthname. Как выбирать календарь.

• PHP: cal_from_jd
• PHP 8.5.11: реализация Calendar

PHP 4+ · calendar

jddayofweek(int $julian_day, int $mode = CAL_DOW_DAYNO): int|string

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

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

[...] создаёт массив; $info["year"] читает поле по ключу; foreach ($items as $item) последовательно берёт элементы. Ключи и значения.

if (условие) { ... } выполняет выбранную ветку. function name($value) { ... } объявляет повторяемое действие; return отдаёт результат вызывающему коду. === сравнивает также тип. Параметр, вызов, результат.

<?php
$jd = gregoriantojd(6, 15, 2024);
echo jddayofweek($jd), "\n";
echo jddayofweek($jd, CAL_DOW_LONG), "\n";
echo jddayofweek($jd, CAL_DOW_SHORT), "\n";

6
Saturday
Sat

<?php
$labels = ['Вс', 'Пн', 'Вт', 'Ср', 'Чт', 'Пт', 'Сб'];
$day = jddayofweek(gregoriantojd(6, 16, 2024));
echo $labels[$day], "\n";
if ($day === 0 || $day === 6) { echo "weekend rule\n"; }

Вс
weekend rule

Применение и ограничения. Не сравнивайте английскую строку с русским названием. JDN без часового пояса сначала должен быть получен именно из местной календарной даты события.

Сравните jdmonthname, cal_from_jd, unixtojd. Как выбирать календарь.

• PHP: jddayofweek
• PHP 8.5.11: реализация Calendar

PHP 4+ · calendar

jdmonthname(int $julian_day, int $mode): string

Архиву нужен месяц в выбранной календарной системе. У одного дня это может быть Gregorian July и Julian June.

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

<?php
$jd = gregoriantojd(7, 1, 2024);
echo jdmonthname($jd, CAL_MONTH_GREGORIAN_LONG), "\n";
echo jdmonthname($jd, CAL_MONTH_JULIAN_LONG), "\n";

July
June

<?php
echo jdmonthname(jewishtojd(6, 1, 5784), CAL_MONTH_JEWISH), "\n";
echo jdmonthname(jewishtojd(7, 1, 5784), CAL_MONTH_JEWISH), "\n";
echo jdmonthname(frenchtojd(13, 1, 3), CAL_MONTH_FRENCH), "\n";

Adar I
Adar II
Extra

Применение и ограничения. Gregorian/Julian SHORT: Jan…Dec; LONG: January…December. Jewish: Tishri, Heshvan, Kislev, Tevet, Shevat, Adar / Adar I / Adar II, Nisan, Iyyar, Sivan, Tammuz, Av, Elul. French: Vendemiaire, Brumaire, Frimaire, Nivose, Pluviose, Ventose, Germinal, Floreal, Prairial, Messidor, Thermidor, Fructidor, Extra. Полный словарь для формы можно получить через cal_info.

Сравните cal_info, jddayofweek, cal_from_jd. Как выбирать календарь.

• PHP: jdmonthname
• PHP 8.5.11: реализация Calendar

PHP 4+ · calendar

jdtounix(int $julian_day): int

После календарного преобразования нужен timestamp для начала конкретного дня UTC. Здесь начало — полночь, хотя астрономический Julian Date часто связан с полуднем.

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

try выполняет попытку; catch (ValueError $error) обрабатывает недопустимое значение. Это не проверка текстовой формы: внешнюю строку сначала разбирают и проверяют. Исключения; Безопасный приём формы.

gmdate("Y-m-d H:i", $timestamp) выбирает год-месяц-день и часы:минуты в UTC. Значения букв формата.

<?php
echo jdtounix(2440589), "\n";
echo gmdate('Y-m-d H:i', jdtounix(2440589)), "\n";

86400
1970-01-02 00:00

<?php
try { jdtounix(gregoriantojd(12, 31, 1969)); }
catch (ValueError $error) { echo "before supported epoch\n"; }
$jd = gregoriantojd(6, 15, 2024);
echo gmdate('Y-m-d H:i', jdtounix($jd)), "\n";

before supported epoch
2024-06-15 00:00

Применение и ограничения. Необратимость с unixtojd двоякая: время суток теряется, а та функция использует локальную системную дату. Для полуночи конкретного региона соберите DateTimeImmutable с явным DateTimeZone.

Сравните unixtojd, gregoriantojd. Как выбирать календарь.

• PHP: jdtounix
• PHP 8.5.11: реализация Calendar

PHP 4+ · calendar

unixtojd(?int $timestamp = null): int|false

Сервису нужен только календарный день из timestamp. Функция отбрасывает время суток по локальной системной зоне; этот выбор нужно знать до группировки событий.

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

try выполняет попытку; catch (ValueError $error) обрабатывает недопустимое значение. Это не проверка текстовой формы: внешнюю строку сначала разбирают и проверяют. Исключения; Безопасный приём формы.

new DateTimeImmutable(...) создаёт объект даты; new DateTimeZone(...) задаёт регион. -> вызывает его метод. Изменения immutable возвращают новый объект, поэтому результат сохраняют. Сначала дата, момент и зона.

<?php
putenv('TZ=UTC0');
echo unixtojd(100000), "\n";
echo jdtounix(unixtojd(100000)), "\n";

2440589
86400

<?php
putenv('TZ=EST5');
date_default_timezone_set('UTC');
echo jdtogregorian(unixtojd(0)), "\n";
echo gmdate('Y-m-d', 0), "\n";
try { unixtojd(-1); }
catch (ValueError $error) { echo "negative timestamp rejected\n"; }

12/31/1969
1970-01-01
negative timestamp rejected

<?php
$moment = new DateTimeImmutable('1970-01-01 00:00:00 UTC');
$local = $moment->setTimezone(new DateTimeZone('America/New_York'));
$jd = gregoriantojd((int) $local->format('n'), (int) $local->format('j'), (int) $local->format('Y'));
echo jdtogregorian($jd), "\n";

12/31/1969

Применение и ограничения. Для изолированного примера изменение TZ допустимо; в многозадачном серверном коде не переключайте окружение ради каждого клиента. Для клиентского дня предпочтительнее DateTime с зоной и gregoriantojd. Сравнение разницы JDN считает переходы календарной даты, а не полные 24 часа.

Сравните jdtounix, gregoriantojd, cal_from_jd. Как выбирать календарь.

• PHP: unixtojd
• PHP 8.5.11: реализация Calendar

PHP 4+ · calendar

easter_days(?int $year = null, int $mode = CAL_EASTER_DEFAULT): int

Для расписания праздника достаточно узнать отступ от 21 марта в выбранном календаре. В 2024 григорианский отступ 10 дней даёт 31 марта.

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

if (условие) { ... } выполняет выбранную ветку. function name($value) { ... } объявляет повторяемое действие; return отдаёт результат вызывающему коду. === сравнивает также тип. Параметр, вызов, результат.

new DateTimeImmutable(...) создаёт объект даты; new DateTimeZone(...) задаёт регион. -> вызывает его метод. Изменения immutable возвращают новый объект, поэтому результат сохраняют. Сначала дата, момент и зона.

Расчёт основан на церковном календарном алгоритме: условное равноденствие 21 марта, табличная луна и следующее воскресенье. Это не наблюдение реального астрономического полнолуния. Исторический алгоритм восходит к VI веку; григорианская ветка добавляет поправки к 19-летнему циклу. Четыре режима и границы истории.

<?php
echo easter_days(2024, CAL_EASTER_ALWAYS_GREGORIAN), "\n";
echo easter_days(2024, CAL_EASTER_ALWAYS_JULIAN), "\n";

10
32

<?php
$western = gregoriantojd(3, 21, 2024) + easter_days(2024, CAL_EASTER_ALWAYS_GREGORIAN);
$julianRule = juliantojd(3, 21, 2024) + easter_days(2024, CAL_EASTER_ALWAYS_JULIAN);
echo jdtogregorian($western), "\n";
echo jdtogregorian($julianRule), "\n";

3/31/2024
5/5/2024

<?php
function holidayStart($year, $zone) {
    $base = new DateTimeImmutable($year . '-03-21 00:00:00', new DateTimeZone($zone));
    $days = easter_days($year, CAL_EASTER_ALWAYS_GREGORIAN);
    return $base->modify('+' . $days . ' days');
}
echo holidayStart(2024, 'Europe/Paris')->format('Y-m-d H:i P'), "\n";

2024-03-31 00:00 +01:00

Применение и ограничения. Для дат 1583…1752 DEFAULT и ROMAN различаются. Даже современный ALWAYS_JULIAN описывает алгоритм, а не весь набор конфессиональных исключений. Правило выбора календаря храните явно вместе с результатом.

Сравните easter_date, juliantojd, gregoriantojd. Как выбирать календарь.

• PHP: easter_days
• PHP 8.5.11: реализация Calendar

PHP 4+ · calendar

easter_date(?int $year = null, int $mode = CAL_EASTER_DEFAULT): int

Если интеграция требует именно timestamp, функция возвращает системную местную полночь праздника. Для сайта с собственной зоной часто яснее easter_days плюс DateTime.

Функция получает значения в круглых скобках, разделённые запятыми, и возвращает результат. $jd = gregoriantojd(6, 15, 2024);: $jd — переменная, = сохраняет результат, ; завершает команду. Порядок здесь месяц, день, год. echo выводит значение; "\n" — перенос строки. var_dump дополнительно показывает тип. Имена CAL_* без кавычек — встроенные целочисленные константы режима. Переменные; вызов функции.

В сигнатуре int — целое, string — текст, array — массив, bool — true/false. Знак ? перед типом разрешает null; | означает один из перечисленных типов. Значение после = — аргумент по умолчанию.

try выполняет попытку; catch (ValueError $error) обрабатывает недопустимое значение. Это не проверка текстовой формы: внешнюю строку сначала разбирают и проверяют. Исключения; Безопасный приём формы.

Расчёт основан на церковном календарном алгоритме: условное равноденствие 21 марта, табличная луна и следующее воскресенье. Это не наблюдение реального астрономического полнолуния. Исторический алгоритм восходит к VI веку; григорианская ветка добавляет поправки к 19-летнему циклу. Четыре режима и границы истории.

<?php
putenv('TZ=UTC0');
$timestamp = easter_date(2024);
echo $timestamp, "\n";
echo gmdate('Y-m-d H:i', $timestamp), "\n";

1711843200
2024-03-31 00:00

<?php
putenv('TZ=UTC0');
date_default_timezone_set('America/New_York');
$timestamp = easter_date(2024);
echo date('Y-m-d H:i', $timestamp), "\n";
try { easter_date(1969); }
catch (ValueError $error) { echo "unsupported year\n"; }

2024-03-30 20:00
unsupported year

<?php
putenv('TZ=UTC0');
echo gmdate('Y-m-d', easter_date(2024, CAL_EASTER_ALWAYS_JULIAN)), "\n";
$jd = juliantojd(3, 21, 2024) + easter_days(2024, CAL_EASTER_ALWAYS_JULIAN);
echo jdtogregorian($jd), "\n";

2024-04-22
5/5/2024

Применение и ограничения. d в формате означает день месяца, t — количество дней в месяце. Ошибка буквы может выглядеть как ошибка календарного алгоритма. Для региона пользователя используйте путь easter_days с явной зоной; для юлианского алгоритма выполните календарное преобразование через JDN, показанное в соседней карточке.

Сравните easter_days, jdtounix, juliantojd. Как выбирать календарь.

• PHP: easter_date
• PHP 8.5.11: реализация Calendar