Jewishtojd: примеры (PHP)

Код:

<?
$jd = jewishtojd(1, 1, 5784);
echo $jd;
?>

Результат:

2460385

Код:

<?
// 14 Адара II 5784 года
$jd = jewishtojd(13, 14, 5784);
var_dump($jd);
?>

Результат:

int(2460758)

Код:

<?
$jd = jewishtojd(15, 40, 10000); // Неверные месяц и год
var_dump($jd);
?>

Результат:

bool(false)

Для работы с календарями в PHP существует набор функций, объединенных в Calendar расширение.

Функция, обратная jewishtojd(). Она конвертирует юлианский день в дату еврейского календаря. Используется, когда исходные данные представлены в виде юлианского дня.

Более универсальные функции для конвертации между юлианскими днями и различными календарными системами, включая еврейский календарь (CAL_JEWISH). Функция cal_to_jd() является аналогом jewishtojd(), но принимает номер календаря константой. Предпочтительнее использовать для кода, где возможна работа с разными календарями.

<?
$jd = cal_to_jd(CAL_JEWISH, 1, 1, 5784);
echo $jd;
?>

Результат:

2460385

Jewishtojd в Python

В стандартной библиотеке Python нет прямой функции для еврейского календаря. Используются сторонние библиотеки, например, hdate или pyluach. Эти библиотеки предлагают объектно-ориентированный подход и более широкий функционал.

from datetime import date
# Пример с использованием pyluach (предварительно требует установки)
# from pyluach.dates import HebrewDate
# hd = HebrewDate(5784, 1, 1)
# jd = hd.to_jd()
# print(jd)

Jewishtojd в Javascript

Прямого аналога в нативном JavaScript нет. Для вычислений используются специализированные библиотеки, такие как hecal или @hebcal/core. Они позволяют конвертировать даты и рассчитывать праздники.

// Пример с библиотекой @hebcal/core
// const {HebrewDate, HDate} = require('@hebcal/core');
// const hd = new HebrewDate(5784, 1, 1);
// const gd = new HDate(hd).greg();
// console.log(gd); // Выведет григорианскую дату

Jewishtojd в MySQL

В СУБД MySQL нет встроенной функции для конвертации в юлианский день из еврейского календаря. Обычно такие преобразования выполняются на стороне приложения или с помощью пользовательских функций (UDF).

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

<?
$jd = jewishtojd('1', '1', '5784'); // Строки
var_dump($jd);
?>

Результат:

int(2460385)

Хотя результат корректен, лучше явно приводить типы для надежности.

Если не проверять возвращаемое значение на false, дальнейшие вычисления с юлианской датой могут прервать выполнение скрипта.

<?
$jd = jewishtojd(14, 1, 5784);
// Неправильно: предполагаем, что $jd - число.
$next_day = $jd + 1;
?>

При ошибке переменная $jd будет иметь значение false, а операция false + 1 даст результат 1, что логически неверно.

В версиях PHP 8.0, 8.1, 8.2 и 8.3 для функции jewishtojd() не было зафиксировано значимых изменений в поведении или сигнатуре. Это стабильная функция, существующая с ранних версий PHP. Однако, общие улучшения механизма обработки ошибок и строгости типов в PHP 8 могут косвенно повлиять на обработку некорректных аргументов.

Код вычисляет григорианскую дату для Рош ха-Шана (1 Тишрея) в заданном году.

<?
$hebrew_year = 5785;
$jd = jewishtojd(7, 1, $hebrew_year); // 1 Тишрея
if ($jd) {
    $gregorian_date = jdtojulian($jd); // Конвертируем в юлианский календарь
    // Для григорианской даты используем jdtogregorian()
    $gregorian_date = jdtogregorian($jd);
    echo "Рош ха-Шана $hebrew_year года: $gregorian_date (по григорианскому календарю)";
}
?>

Код проверяет, является ли день 30-м днем месяца Хешван, который иногда имеет 29 дней.

<?
function isHebrewDateValid($month, $day, $year) {
    return jewishtojd($month, $day, $year) !== false;
}

$dateExists = isHebrewDateValid(2, 30, 5784); // 30 Хешван 5784?
var_dump($dateExists);
?>

Результат:

bool(false)

Код находит разницу в днях между двумя датами.

<?
$jd1 = jewishtojd(1, 15, 5784); // 15 Нисана 5784
$jd2 = jewishtojd(7, 1, 5784);  // 1 Тишрея 5784
if ($jd1 && $jd2) {
    $diff = $jd2 - $jd1;
    echo "Между датами $diff дней.";
}
?>

Результат:

Между датами 167 дней.

Код выводит все юлианские дни для месяца Тевет в указанном году.

<?
$month = 4; // Тевет
$year = 5784;
$first_jd = jewishtojd($month, 1, $year);
$last_jd = jewishtojd($month + 1, 1, $year) - 1;

for ($jd = $first_jd; $jd <= $last_jd; $jd++) {
    echo $jd . "\n";
}
?>