时间数据系列：故事的其余部分 - adatosystems
自从我写有关 php zmanim 的文章以来已经有一段时间了——我用它所做的工作以及我在实现它时学到的东西。但尽管耽误了时间，我始终打算继续谈话。这就是我们今天要做的
在我的第一篇文章中，我解释了如何安装和开始使用 php zmanim 库。然后在下一篇文章中，我深入研究了计算更复杂的时间以及该工具的真正威力——将最常见的拉比观点应用于各种 zmanim。我将从上次停下的地方继续，尽量减少重叠，因此，如果您需要花一点时间加快速度，我已链接到之前的帖子。
今天的目标是探索 php zmanim 的使用，超越相对简单的库使用。其中包括：
- 制定标准时间并根据犹太教堂的特定用例进行调整（“mincha 每天在 shkia 之前 25 分钟开始”）。
- 使用 php zmanim 库函数和方法提供非时间计算 - 例如每周托拉部分、希伯来日期以及指定日期是否为假期（如 rosh chodesh 或 sukkot）。
致谢
首先需要再次向那些使这一切成为可能的人们表示感谢。在一长串名字中最重要的是 zachary weixelbaum，他是 php zmanim 库本身的维护者；和 eliyahu hershfeld：php zmanim 所基于的 kosher java 库的创建者。
快速回顾
当我们停止时，我们有一个可靠的基本 php 脚本：
- 设置位置变量（纬度/经度），以及时区和海拔。
- 设置日期
- 从这些变量创建一个 php zmanim 对象
- 使用内置方法计算从日出到 mincha 到 tzeit hakochavim 的时间
它看起来像这样：
<?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"; ?>
登录后复制
但日出只是开始。使用任何内置计算（在 github 自述文件页面上进行了描述），您可以拉取多种时间。例如，要让 mincha gedola 使用特定的拉比意见，我可以包括：
$gedolah = $zmanim->minchagedola16point1degrees
登录后复制
在上一篇博客中，我还介绍了使用 php zmanim 的格式方法使输出更具可读性的方法：
$gedolah = $gedolah->format('g:i a');
登录后复制
“加盐调味”——调整时间
对于那些不花很多时间在犹太教堂的人（没有责备，没有羞耻，这里仍然欢迎你），这可能并不明显，但是 - 尽管有 zman 的名字 - 很少有组织为 mincha 祈祷（下午祈祷）在 mincha ketana、mincha gedola 或 plag hamincha。
事实上，很多关于计算时间的工作与直接的“mincha gedola 现在几点了？”关系不大。以及“我们可以在一天中多晚合理安排mincha，以便每个人下班后都有时间到达这里；但也不能太晚以至于没有人来，因为他们会错过晚餐？”
如果这太理论化，请允许我分享我的犹太教堂在设置每周时间表时考虑的逻辑叠叠乐：
- 周五晚上蜡烛点燃：shkia（日落）减去18分钟
- 夏季星期五 mincha：plag hamincha（使用“plaghaminchaaterettorah”）减去 20 分钟
- 冬季星期五 mincha：shkia（日落）减去 22 分钟
- 周六 mincha：shkia 减 40 分钟
- 周六 ma’ariv：shkia 加 50 分钟
- 周六安息日结束：shkia 加 45 分钟
- weekday mincha：找到本周最早的 shkia，然后减去 17 分钟
虽然我在早期博客中介绍的所有其他时间仍然很重要，但希望您开始意识到它们并不像人们想象的那么重要。
那么如何计算时间（例如 shkia/日落），然后添加或减去分钟？我们将从之前的相同脚本开始：
<?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);
登录后复制
为此，我们将添加代码以获取日落：
$sunset = $zmanim->sunset;
登录后复制
然后我们减去 18 分钟即可得到蜡烛点亮时间：
$candles = date('g:i a', strtotime($sunset . " -18 minutes"));
登录后复制
没错。你只需使用 php 自己的字符串时间函数即可。如果我让你保持悬念，我很抱歉。但这真的就是这么简单。
托拉部分是什么？希伯来日期是哪一天？ rosh chodesh 什么时候上映？
（……以及您的犹太教堂内和周围经常提出的其他基本但令人烦恼的问题。）
除了日期计算之外，kosherjava 库（以及 php zmanim 库）还具有快速提供上述信息的方法和函数。
首先要了解的是，到目前为止我们一直在使用的 php zmanim 对象是一个 zmanim 对象 – 一个具有特定日期的一组特定时间的对象。对于涉及日期本身的事情，我们实例化一个 jewishcalendar 对象。好消息是它的创建要容易得多。您所需要的只是年、月、日。
<?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));
登录后复制
我们现在有一个 jewishcalendar 对象可以使用，并且可以使用与我们多次发现的方法类似的方法。例如：假设我们选择的日期是星期六，我们可以得到托拉部分：
$format = zmanim::format();
$parshaeng = json_decode('"' . $format->formatparsha($jewishcalendar) . '"');
登录后复制
（暂时忽略 $format 设置。我们稍后会深入研究它）。
如果你运行该代码，$parshaeng 会给你：
parshas ki savo
登录后复制
您会注意到我们不需要提供纬度、经度、时区等。我必须强调的是，仅此功能（获取日期、托拉部分等的能力）就使 php zmanim 库变得有用一切都靠它自己，即使没有时间计算。
我能得到希伯来语版本吗？
托拉部分？当然！这就是 $format 行的用武之地。
首先解释一下它是什么：它是一个修改 zmanim 和 jewishcalendar 等对象的方法，设置显示和输出选项。 在没有任何其他信息的情况下设置 zmanim::format() 默认为英语。但随后您可以通过以下附加行告诉系统您需要希伯来语：
$format->sethebrewformat(true)
登录后复制
现在，如果你运行相同的 json_decode(‘”‘ . $format->formatparsha($jewishcalendar) . ‘”‘) 行，你会得到：
כי תבוא
登录后复制
把它们放在一起：
<?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";
登录后复制
这将显示：כй תבוא – ki savo
今天星期几？
更具体地说，今天是希伯来语的哪一天？
与前面的示例一样，我们从 jewishcalendar 和格式对象开始
$jewishcalendar = zmanim::jewishcalendar(carbon::createfromdate($theyear, $themonth, $theday)); $format = zmanim::format();
登录后复制
然后我们添加同一行将格式设置为希伯来语。
$format->sethebrewformat(true);
登录后复制
最后（相当简单）我们要求一个直接的日历对象输出：
$zmandate = json_decode('"' . $format->format($jewishcalendar) . '"');
登录后复制
这就是您所需要的。结果是这样的：
17 elul, 5784
登录后复制
是的，即使我们指定了 sethebrewformat，它还是以英语显示。
我能得到实际的希伯来语版本吗？
为了让希伯来语日期完全以希伯来语显示（包括单词和字母），我们调用一个稍微不同的方法，称为希伯来语日期格式器（hebrewdateformatter）。假设（再次）您设置了初始变量并创建了一个 jewishcalendar 对象，输出希伯来语日期的代码将是：
$hebformat = hebrewdateformatter::create();
$hebformat->sethebrewformat(true);
$hebdate = json_decode('"' . $hebformat->format($jewishcalendar) . '"');
print("hebrew date: $hebdate\n");
登录后复制
这会给你：
hebrew date: י״ח אלול תשפ״ד
登录后复制
今天是吗？
有时您需要检查特定日期是否是……嗯，特定的一天。例如 rosh chodesh（新的一个月）或多日假期的一部分（例如住棚节）。
事实证明，php zmanim 方法使这变得非常简单。假设您以与其他示例相同的方式开始，
一旦你设置了 jewishcalendar 对象，它就像
一样简单
$jewishCalendar->isRoshHashana(); $jewishCalendar->isSuccos();
登录后复制
如果日期与假期匹配，它将返回“true”，您可以继续执行您想要的任何逻辑或过程，例如显示（或不显示）日期。
那么下一步是什么？
无论你相信与否，还有更多内容需要介绍。在接下来的几周内，每当我接触到它时，我都会介绍如何利用内置天文学函数进行时间计算。不管你相信与否，对于安息日和假期以及其他纪念活动的开始和结束等事情来说，拥有真正准确的时间确实很重要。
同时，如果您还有其他想要听我介绍的内容；或者，如果您有疑问、更正或荣誉，请随时将其留在下面的评论中。
以上就是时间数据系列：故事的其余部分的详细内容，更多请关注其它相关文章！
