Cela fait un moment que j’ai écrit sur PHP Zmanim — le travail que j’ai accompli avec et les choses que j’ai apprises en l’implémentant. Mais malgré le retard, j’ai toujours eu l’intention de poursuivre la conversation. C’est ce que nous faisons aujourd’hui.
Dans mon premier article, j’ai expliqué comment installer et commencer à utiliser la bibliothèque PHP Zmanim. Ensuite, dans le prochain article, j’ai approfondi le calcul de temps plus complexes et la véritable puissance de l’outil — en appliquant les opinions rabbiniques les plus courantes pour divers zmanim. Je reprends là où je m’étais arrêté avec un minimum de chevauchement, donc si vous avez besoin d’une minute pour vous remettre à niveau, j’ai lié ces articles précédents.
Le but aujourd’hui est d’explorer les utilisations de PHP Zmanim qui vont au-delà de l’utilisation relativement simple de la bibliothèque. Cela inclut :
- Prendre un temps standard et l’ajuster pour des cas d’utilisation spécifiques à la synagogue (« Mincha commence 25 minutes avant Shkia chaque jour »).
- Utiliser les fonctions et méthodes de la bibliothèque PHP Zmanim qui fournissent des calculs non temporels — tels que la portion hebdomadaire de la Torah, la date hébraïque, et si une date spécifiée est un jour férié (comme Rosh Chodesh ou Souccot).
Remerciements
Une fois de plus, je dois commencer par exprimer ma gratitude envers les personnes qui ont rendu tout cela possible. Parmi une longue liste de noms, Zachary Weixelbaum, le mainteneur de la bibliothèque PHP Zmanim elle-même, et Eliyahu Hershfeld, créateur de la bibliothèque Java Kasher sur laquelle PHP Zmanim est basé.
Un petit rappel
Lorsque nous avons quitté, nous avions un solide script PHP de base qui :
- Définit des variables pour la localisation (en latitude/longitude), ainsi que le fuseau horaire et l’altitude.
- Définit la date
- Crée un objet php zmanim à partir de ces variables
- Utilise les méthodes intégrées pour calculer l’heure pour tout, du lever du soleil à mincha en passant par tzeit hakochavim
Cela ressemblait à ceci :
require 'vendor/autoload.php';
use PhpZmanim\Zmanim;
use PhpZmanim\Calendar\ComplexZmanimCalendar;
use PhpZmanim\Geo\GeoLocation;
# Set variables:
$locname = "Beit Knesset Chochmat Shlomo, Beachwood, OH";
$lat = 41.4939407;
$long = -81.516709;
$elev = 0;
$tz = 'America/New_York';
$getyear = 2024;
$getday = 20;
$getmonth = 12;
$testzmanim = Zmanim::create($getyear, $getmonth, $getday, $locname, $lat, $long, $elev, $tz);
$sunrise = $testzmanim->sunrise;
echo "$sunrise\n";
Mais le lever du soleil n’est que le début. En utilisant n’importe lequel des calculs intégrés (qui sont décrits sur la page ReadMe de GitHub), vous pouvez obtenir une grande variété d’heures. Par exemple, pour obtenir Mincha Gedola en utilisant un avis rabbinique spécifique, je pourrais inclure :
$gedolah = $zmanim->minchaGedola16Point1Degrees
Dans le dernier blog, j’ai également abordé des moyens d’utiliser la méthode de format de PHP Zmanim pour rendre la sortie plus lisible :
$gedolah = $gedolah->format('g:i a');
« Sel au goût » — Ajustement des heures
Pour ceux qui ne passent pas beaucoup de temps à la synagogue (pas de reproche, pas de honte, vous êtes toujours le bienvenu ici), cela peut ne pas être évident, mais — malgré le nom du zman — très peu d’organisations prient Mincha (prières de l’après-midi) à Mincha Ketana, Mincha Gedola ou Plag haMincha.
En fait, une grande partie du travail concernant le calcul des horaires a moins à voir avec le simple « à quelle heure est Mincha Gedola ? » et plus avec « jusqu’à quelle heure dans la journée pouvons-nous raisonnablement programmer Mincha pour que tout le monde ait le temps d’arriver ici après le travail ; mais pas si tard que personne ne vienne parce qu’il manquera le dîner ? »
Si cela semble trop théorique, permettez-moi de partager le casse-tête logique de jenga que ma synagogue considère lors de l’établissement du calendrier hebdomadaire :
- Allumage des bougies vendredi soir : Shkia (coucher de soleil) moins 18 minutes
- Mincha vendredi été : Plag haMincha (en utilisant « plagHaminchaAteretTorah ») moins 20 minutes
- Mincha vendredi hiver : Shkia (coucher de soleil) moins 22 minutes
- Mincha samedi : Shkia moins 40 minutes
- Ma’ariv samedi : Shkia plus 50 minutes
- Fin du Shabbat samedi : Shkia plus 45 minutes
- Mincha en semaine : trouver le plus tôt shkia de la semaine, puis soustraire 17 minutes
Bien que tous les autres horaires que j’ai abordés dans les blogs précédents aient encore de l’importance, j’espère que vous commencez à réaliser qu’ils importent moins souvent qu’on pourrait s’y attendre.
Alors, comment faites-vous pour prendre un moment (comme shkia/coucher de soleil) et ensuite ajouter ou soustraire des minutes ? Nous allons commencer avec le même script que nous avions auparavant :
require 'vendor/autoload.php';
use PhpZmanim\Zmanim;
use PhpZmanim\Calendar\ComplexZmanimCalendar;
use PhpZmanim\Geo\GeoLocation;
# Set variables:
$locname = "Beit Knesset Chochmat Shlomo, Beachwood, OH";
$lat = 41.4939407;
$long = -81.516709;
$elev = 0;
$tz = 'America/New_York';
$getyear = 2024;
$getday = 20;
$getmonth = 12;
$testzmanim = Zmanim::create($getyear, $getmonth, $getday, $locname, $lat, $long, $elev, $tz);
À cela, nous ajouterons le code pour obtenir le coucher de soleil :
$sunset = $zmanim->sunset;
Et ensuite, nous soustrairons 18 minutes pour obtenir l’heure d’allumage des bougies :
$candles = date('g:i a', strtotime($sunset . " -18 minutes"));
C’est exact. Vous utilisez simplement la fonction propre de PHP pour convertir une chaîne en heure. Je suis désolé de vous avoir tenu en haleine. Mais c’est vraiment aussi simple que cela.
Quelle est la portion de la Torah ? Quelle est la date hébraïque ? Quand est Rosh Chodesh ?
(… et d’autres questions essentielles mais vexantes souvent posées dans et autour de votre synagogue.)
Avec les calculs de dates, la bibliothèque KosherJava (et donc la bibliothèque PHP Zmanim) a des méthodes et des fonctions pour fournir rapidement des informations comme celles demandées ci-dessus.
La première chose à comprendre est que l’objet PHP Zmanim avec lequel nous avons travaillé jusqu’à présent a été un objet Zmanim — un objet qui a un ensemble d’heures spécifiques pour une date particulière. Pour les choses impliquant les dates elles-mêmes, nous instancions un objet jewishCalendar. La bonne nouvelle est que c’est beaucoup plus facile à créer. Tout ce dont vous avez besoin est l’année, le mois et le jour.
require 'vendor/autoload.php';
use PhpZmanim\Zmanim;
use PhpZmanim\Calendar\ComplexZmanimCalendar;
use PhpZmanim\Geo\GeoLocation;
# Set variables:
$getyear = 2024;
$getday = 21;
$getmonth = 09;
$jewishCalendar = Zmanim::jewishCalendar(Carbon::createFromDate($getyear, $getmonth, $getday));
Nous avons maintenant un objet jewishCalendar avec lequel travailler et pouvons utiliser des méthodes similaires à celles que nous avons trouvées pour les heures. Par exemple, en supposant que la date que nous avons sélectionnée était un samedi, nous pouvons obtenir la portion de la Torah :
$format = Zmanim::format();
$parshaeng = json_decode('"' . $format->formatParsha($jewishCalendar) . '"');
(Ignorez le paramètre $format pour l’instant. Nous allons y revenir dans un instant).
Si vous exécutiez ce code, $parshaeng vous donnerait :
Parshas Ki Savo
Vous remarquerez que nous n’avons pas eu besoin de fournir la latitude, la longitude, le fuseau horaire, etc. Je ne saurais trop insister sur le fait que cette capacité, à elle seule – la possibilité d’obtenir des dates, des portions de Torah, et plus encore — rend la bibliothèque PHP Zmanim utile en elle-même, même sans les calculs de temps.
Puis-je obtenir cela en hébreu ?
La portion de Torah ? Bien sûr ! C’est là que la ligne $format entre en jeu.
Tout d’abord, une explication de ce que c’est : c’est une méthode qui modifie des objets comme Zmanim et jewishCalendar, en définissant les options d’affichage et de sortie. Définir Zmanim::format() sans aucune autre information par défaut en anglais. Mais ensuite, vous pouvez indiquer au système que vous voulez l’hébreu avec cette ligne supplémentaire :
$format->setHebrewFormat(true)
Maintenant, si vous exécutez la même ligne json_decode(‘”‘ . $format->formatParsha($jewishCalendar) . ‘”‘), vous obtiendrez :
כי תבוא
En mettant tout cela ensemble :
require 'vendor/autoload.php';
use PhpZmanim\Zmanim;
use PhpZmanim\Calendar\ComplexZmanimCalendar;
use PhpZmanim\Geo\GeoLocation;
# Set variables:
$getyear = 2024;
$getday = 21;
$getmonth = 09;
$jewishCalendar = Zmanim::jewishCalendar(Carbon::createFromDate($getyear, $getmonth, $getday));
$format = Zmanim::format();
$parshaeng = json_decode('"' . $format->formatParsha($jewishCalendar) . '"');
$format->setHebrewFormat(true);
$parshaheb = json_decode('"' . $format->formatParsha($jewishCalendar) . '"');
echo "$parshaheb - $parshaeng\n";
Cela afficherait : כי תבוא – Ki Savo.
Quel jour sommes-nous ?
Plus précisément, quel jour est-ce en HÉBREU ?
Comme dans l’exemple précédent, nous commençons par un jewishCalendar et un objet format.
$jewishCalendar = Zmanim::jewishCalendar(Carbon::createFromDate($theyear, $themonth, $theday));
$format = Zmanim::format();
Ensuite, nous ajoutons la même ligne pour définir le format en hébreu.
$format->setHebrewFormat(true);
Et enfin (et assez simplement), nous demandons une sortie d’objet calendrier simple :
$zmandate = json_decode('"' . $format->format($jewishCalendar) . '"');
C’est littéralement tout ce dont vous avez besoin. Le résultat est quelque chose comme ça :
17 Elul, 5784
Oui, même si nous avons spécifié setHebrewFormat, cela est sorti en anglais.
Puis-je obtenir cela en hébreu réel ?
Pour que la date hébraïque s’affiche entièrement en hébreu — tant les mots que les lettres — nous invoquons une méthode légèrement différente appelée, suffisamment appropriée, HebrewDateFormatter.
En présumant (encore une fois) que vous avez configuré vos variables initiales et créé un objet jewishCalendar, le code pour afficher une date en langue hébraïque serait :
$hebformat = HebrewDateFormatter::create();
$hebformat->setHebrewFormat(true);
$hebdate = json_decode('"' . $hebformat->format($jewishCalendar) . '"');
print("Hebrew date: $hebdate\n");
Ce qui vous donnerait :
Hebrew date: י״ח אלול תשפ״ד
Est-ce que aujourd’hui est le jour ?
Parfois, vous devez vérifier si une date spécifique est… eh bien, un jour spécifique comme Rosh Chodesh (le nouveau mois) ou partie d’une fête de plusieurs jours (comme Souccot).
Il s’avère que la méthode PHP Zmanim rend cela très simple. En présumant que vous avez commencé de la même manière que les autres exemples, une fois que vous avez configuré l’objet jewishCalendar, c’est aussi simple que :
$jewishCalendar->isRoshHashana();
$jewishCalendar->isSuccos();
Si la date correspond à la fête, elle retournera « vrai », et vous pouvez procéder avec la logique ou le processus que vous souhaitez, comme afficher la date (ou pas).
Alors, qu’est-ce qui vient ensuite ?
Croyez-le ou non, il y a encore plus à couvrir. Dans les semaines à venir Quand j’en aurai l’occasion, j’aimerais aborder des façons de tirer parti des fonctions d’astronomie intégrées pour les calculs de temps. Croyez-le ou non, cela peut vraiment avoir de l’importance en termes d’avoir des heures vraiment précises pour des choses comme le début et la fin du Shabbat et des fêtes, ainsi que d’autres observances.
En attendant, si vous avez d’autres sujets que vous aimeriez que j’aborde ou si vous avez des questions, des corrections ou des félicitations, n’hésitez pas à les laisser dans les commentaires ci-dessous.
Source:
https://dzone.com/articles/time-data-series-the-rest-of-the-story