Zeitreihendaten: Der Rest der Geschichte

Tutorials

PHP

Es ist eine Weile her, seit ich über PHP Zmanim — die Arbeit, die ich damit geleistet habe, und die Dinge, die ich beim Implementieren gelernt habe, geschrieben habe. Aber trotz der Verzögerung hatte ich immer die Absicht, das Gespräch fortzusetzen. Das tun wir heute.

In meinem ersten Beitrag habe ich erklärt, wie man die PHP Zmanim-Bibliothek installiert und damit anfängt. Dann habe ich im nächsten Beitrag komplexere Zeiten berechnet und die wahre Kraft des Werkzeugs untersucht — indem ich die gängigsten rabbinischen Meinungen zu verschiedenen zmanim angewendet habe. Ich setze dort fort, wo ich aufgehört habe, mit minimalen Überschneidungen, also wenn Sie eine Minute brauchen, um wieder auf den neuesten Stand zu kommen, habe ich auf diese vorherigen Beiträge verlinkt.

Das Ziel heute ist es, Anwendungen von PHP Zmanim zu erkunden, die über die relativ unkomplizierte Nutzung der Bibliothek hinausgehen. Dazu gehört:

Eine Standardzeit zu nehmen und sie für synagogenspezifische Anwendungsfälle anzupassen („Mincha beginnt jeden Tag 25 Minuten vor Shkia“).
Die Funktionen und Methoden der PHP Zmanim-Bibliothek zu nutzen, die keine Zeitberechnungen bieten — wie den wöchentlichen Torah-Abschnitt, das hebräische Datum und ob ein bestimmtes Datum ein Feiertag ist (wie Rosh Chodesh oder Sukkot).

Anerkennungen

Noch einmal möchte ich meine Dankbarkeit gegenüber den Leuten zum Ausdruck bringen, die all dies möglich gemacht haben. An erster Stelle einer langen Liste von Namen steht Zachary Weixelbaum, der Verwalter der PHP Zmanim-Bibliothek selbst, und Eliyahu Hershfeld, Schöpfer der Kosher Java-Bibliothek, auf der PHP Zmanim basiert.

Eine kurze Auffrischung

Als wir aufgehört haben, hatten wir ein solides grundlegendes PHP-Skript, das:

Variablen für den Standort (in Breitengrad/Längengrad), sowie die Zeitzone und Höhe setzt.
Das Datum setzt
Eine PHP-Zmanim-Objekt aus diesen Variablen erstellt
Die integrierten Methoden verwendet, um die Zeit für alles von Sonnenaufgang bis Mincha bis Tzeit Hakochavim zu berechnen

Es sah so aus:

PHP

<?php

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";

?>

Aber der Sonnenaufgang ist nur der Anfang. Mit einer der integrierten Berechnungen (die auf der GitHub ReadMe-Seite beschrieben sind), können Sie eine Vielzahl von Zeiten abrufen. Zum Beispiel, um Mincha Gedola unter Verwendung einer spezifischen rabbinischen Meinung zu erhalten, könnte ich einschließen:

PHP

$gedolah = $zmanim->minchaGedola16Point1Degrees

Im letzten Blog habe ich auch Möglichkeiten behandelt, wie man die Format-Methode von PHP Zmanim verwenden kann, um die Ausgabe lesbarer zu gestalten:

PHP

$gedolah = $gedolah->format('g:i a');

„Nach Geschmack würzen“ — Anpassen von Zeiten

Für diejenigen, die nicht viel Zeit in der Synagoge verbringen (kein Vorwurf, kein Scham, du bist immer noch willkommen hier), mag es nicht offensichtlich sein, aber — trotz des Namens des Zman — beten nur sehr wenige Organisationen Mincha (Nachmittagsgebet) bei Mincha Ketana, Mincha Gedola oder Plag haMincha.

Tatsächlich hat die meiste Arbeit bei der Berechnung der Zeiten weniger mit dem einfachen „Wann ist Mincha Gedola?“ zu tun, sondern mehr mit „Wie spät am Tag können wir Mincha vernünftigerweise planen, damit alle nach der Arbeit hierher kommen können; aber nicht so spät, dass niemand kommt, weil er das Abendessen verpassen würde?“

Wenn das zu theoretisch ist, erlauben Sie mir, das logische Jenga-Puzzle meiner Synagoge zu teilen, wenn der wöchentliche Zeitplan festgelegt wird:

Freitagnacht Kerzenanzünden: Shkia (Sonnenuntergang) minus 18 Minuten
Freitags Mincha im Sommer: Plag haMincha (unter Verwendung von „plagHaminchaAteretTorah“) minus 20 Minuten
Freitags Mincha im Winter: Shkia (Sonnenuntergang) minus 22 Minuten
Samstags Mincha: Shkia minus 40 Minuten
Samstags Ma’ariv: Shkia plus 50 Minuten
Samstags Ende des Shabbat: Shkia plus 45 Minuten
Wochentags Mincha: finde die früheste Shkia für die Woche und subtrahiere dann 17 Minuten

Während alle anderen Zeiten, über die ich in früheren Blogs gesprochen habe, immer noch wichtig sind, hoffentlich beginnen Sie zu erkennen, dass sie weniger oft wichtig sind, als man erwarten könnte.

Also, wie nehmen Sie eine Uhrzeit (wie Schkia/Sonnenuntergang) und fügen dann Minuten hinzu oder ziehen sie ab? Wir werden mit demselben Skript beginnen, das wir zuvor hatten:

PHP

<?php

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);

Zu diesem werden wir den Code hinzufügen, um den Sonnenuntergang zu erhalten:

PHP

$sunset = $zmanim->sunset;

Und dann werden wir 18 Minuten abziehen, um die Kerzenanzündzeit zu erhalten:

PHP

$candles = date('g:i a', strtotime($sunset . " -18 minutes"));

Genau. Verwenden Sie einfach die PHP-eigene String-zu-Zeit-Funktion. Es tut mir leid, wenn ich Sie in Spannung gehalten habe. Aber es ist wirklich so einfach.

Was ist der Tora-Abschnitt? Was ist das hebräische Datum? Wann ist Rosch Chodesch?

(…und andere wesentliche, aber quälende Fragen, die oft in und um Ihre Synagoge gestellt werden.)

Zusammen mit Datumsberechnungen verfügt die KosherJava-Bibliothek (und daher die PHP-Zmanim-Bibliothek) über Methoden und Funktionen, um schnell Informationen wie die oben gestellten zu liefern.

Das erste, was zu verstehen ist, ist, dass das PHP-Zmanim-Objekt, mit dem wir bisher gearbeitet haben, ein Zmanim-Objekt war — ein Objekt, das eine Reihe spezifischer Zeiten für ein bestimmtes Datum hat. Für Dinge, die die Daten selbst betreffen, instanziieren wir ein jewishCalendar-Objekt. Die gute Nachricht ist, dass es viel einfacher ist zu erstellen. Alles, was Sie brauchen, sind das Jahr, den Monat und den Tag.

PHP

<?php

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));

Wir haben jetzt ein jewishCalendar-Objekt, mit dem wir arbeiten können, und können Methoden ähnlich wie die für Zeiten verwenden. Zum Beispiel, vorausgesetzt, das ausgewählte Datum war ein Samstag, können wir den Tora-Abschnitt erhalten:

PHP

$format = Zmanim::format();

$parshaeng = json_decode('"' . $format->formatParsha($jewishCalendar) . '"');

(Ignorieren Sie vorerst die $format-Einstellung. Wir werden gleich darauf eingehen).

Wenn Sie diesen Code ausführen würden, würde $parshaeng Ihnen geben:

PHP

Parshas Ki Savo

Sie werden feststellen, dass wir keine Breiten- und Längengrade, Zeitzonen usw. angeben mussten. Ich kann nicht genug betonen, dass diese Fähigkeit allein – die Möglichkeit, Daten, Torah-Abschnitte und mehr — macht die PHP Zmanim-Bibliothek nützlich, ganz allein, auch ohne die Zeitberechnungen.

Kann ich das auf Hebräisch bekommen?

Der Torah-Abschnitt? Natürlich! Hier kommt die $format-Zeile ins Spiel.

Zuerst eine Erklärung, was es ist: Es ist eine Methode, die Objekte wie Zmanim und jewishCalendar modifiziert und die Anzeige- und Ausgabeoptionen festlegt. Wenn Sie Zmanim::format() ohne weitere Informationen aufrufen, wird standardmäßig Englisch verwendet. Aber dann können Sie dem System sagen, dass Sie Hebräisch mit dieser zusätzlichen Zeile möchten:

PHP

$format->setHebrewFormat(true)

Wenn Sie jetzt die gleiche json_decode(‘”‘ . $format->formatParsha($jewishCalendar) . ‘”‘)-Zeile ausführen, würden Sie folgendes erhalten:

Plain Text

כי תבוא

Alles zusammengefügt:

PHP

<?php

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";

Dies würde angezeigt: כי תבוא – Ki Savo.

Welcher Tag ist es?

Genauer gesagt, welcher HEBRÄISCHE Tag ist es?

Wie im vorherigen Beispiel beginnen wir mit einem jewishCalendar und einem Formatobjekt.

PHP

$jewishCalendar = Zmanim::jewishCalendar(Carbon::createFromDate($theyear, $themonth, $theday));

$format = Zmanim::format();

Dann fügen wir die gleiche Zeile hinzu, um das Format auf Hebräisch zu setzen.

PHP

$format->setHebrewFormat(true);

Und schließlich (und ziemlich einfach) fragen wir nach einer einfachen Kalenderobjektausgabe:

PHP

$zmandate = json_decode('"' . $format->format($jewishCalendar) . '"');

Das ist buchstäblich alles, was Sie brauchen. Das Ergebnis ist etwas wie dies:

Plain Text

17 Elul, 5784

Ja, obwohl wir setHebrewFormat angegeben haben, kam es auf Englisch heraus.

Kann ich das in echtem Hebräisch bekommen?

Um das hebräische Datum vollständig in Hebräisch anzeigen zu lassen, sowohl Wörter als auch Buchstaben, verwenden wir eine etwas andere Methode namens, passenderweise, „HebrewDateFormatter„.

Vorausgesetzt (erneut), dass Sie Ihre Anfangsvariablen eingerichtet und ein „jewishCalendar„-Objekt erstellt haben, wäre der Code zur Ausgabe eines hebräischen Datums:

PHP

$hebformat = HebrewDateFormatter::create();

$hebformat->setHebrewFormat(true);

$hebdate = json_decode('"' . $hebformat->format($jewishCalendar) . '"');

print("Hebrew date: $hebdate\n");

Was Ihnen Folgendes liefern würde:

Plain Text

Hebrew date: י״ח אלול תשפ״ד

Ist heute der Tag?

Manchmal müssen Sie überprüfen, ob ein bestimmtes Datum… nun, ein spezifischer Tag wie Rosh Chodesh (der neue Monat) oder Teil eines mehrtägigen Feiertags (wie Sukkot) ist.

Es stellt sich heraus, dass die PHP Zmanim-Methode dies sehr einfach macht. Vorausgesetzt, dass Sie genauso wie in den anderen Beispielen begonnen haben und das „jewishCalendar„-Objekt eingerichtet haben, ist es so einfach wie:

PHP

$jewishCalendar->isRoshHashana();

$jewishCalendar->isSuccos(); 

Wenn das Datum mit dem Feiertag übereinstimmt, gibt es „true“ zurück, und Sie können mit der gewünschten Logik oder dem gewünschten Prozess fortfahren, z. B. das Datum anzeigen (oder nicht).

Was kommt als Nächstes?

Glauben Sie es oder nicht, es gibt noch mehr zu besprechen. ~~In den~~ ~~kommenden Wochen~~ Wenn ich dazu komme, möchte ich Wege aufzeigen, wie man die eingebauten astronomischen Funktionen für Zeitberechnungen nutzen kann. Glauben Sie es oder nicht, es kann wirklich wichtig sein, um wirklich genaue Zeiten für Dinge wie den Beginn und das Ende des Shabbats und der Feiertage sowie anderer Beobachtungen zu haben.

In der Zwischenzeit, falls es etwas gibt, das Sie gerne sehen würden, dass ich darauf eingehe, oder wenn Sie Fragen, Korrekturen oder Lob haben, können Sie diese gerne in den Kommentaren unten hinterlassen.

Source:
https://dzone.com/articles/time-data-series-the-rest-of-the-story