当前位置: 首页> 最新文章列表> 如何用cal_from_jd函数将天文时间转换为标准日期？实用技巧分享

如何用cal_from_jd函数将天文时间转换为标准日期？实用技巧分享

gitbox 2025-09-16

1. cal_from_jd()函数概述

PHP的cal_from_jd()函数是PHP内建的日历转换函数之一，它能够将儒略日（Julian Day, JD）转换为指定的日历格式。这个函数的语法如下：

<span><span><span class="hljs-keyword">array</span></span><span> </span><span><span class="hljs-title function_ invoke__">cal_from_jd</span></span><span> ( </span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$jd</span></span><span> , </span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$calendar</span></span><span> )
</span></span>

参数说明：

  • $jd：需要转换的儒略日（Julian Date）。它是一个浮动的数字，代表自公元前4713年1月1日正午以来的天数。

  • $calendar：指定转换后的日历类型。PHP支持多种日历系统，包括：

    • CAL_GREGORIAN（公历）

    • CAL_JULIAN（儒略历）

    • CAL_FAJI（伊斯兰历）

    • CAL_HEBREW（希伯来历）

该函数会返回一个关联数组，包含转换后的日期元素，如年份、月份、日期等。

2. 使用cal_from_jd()进行转换

为了更好地理解如何使用cal_from_jd()函数，我们来看一个具体的例子。假设你有一个儒略日为2459373.5（即2022年7月16日的JD），你想将它转换为公历日期。

示例代码：

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$jd</span></span><span> = </span><span><span class="hljs-number">2459373.5</span></span><span>;  </span><span><span class="hljs-comment">// 儒略日</span></span><span>
</span><span><span class="hljs-variable">$calendar</span></span><span> = CAL_GREGORIAN;  </span><span><span class="hljs-comment">// 公历</span></span><span>
</span><span><span class="hljs-variable">$date</span></span><span> = </span><span><span class="hljs-title function_ invoke__">cal_from_jd</span></span><span>(</span><span><span class="hljs-variable">$jd</span></span><span>, </span><span><span class="hljs-variable">$calendar</span></span><span>);

</span><span><span class="hljs-comment">// 输出结果</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"年: "</span></span><span> . </span><span><span class="hljs-variable">$date</span></span><span>[</span><span><span class="hljs-string">'year'</span></span><span>] . </span><span><span class="hljs-string">"\n"</span></span><span>;
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"月: "</span></span><span> . </span><span><span class="hljs-variable">$date</span></span><span>[</span><span><span class="hljs-string">'month'</span></span><span>] . </span><span><span class="hljs-string">"\n"</span></span><span>;
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"日: "</span></span><span> . </span><span><span class="hljs-variable">$date</span></span><span>[</span><span><span class="hljs-string">'day'</span></span><span>] . </span><span><span class="hljs-string">"\n"</span></span><span>;
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

输出：

<span><span><span class="hljs-section">年: 2022</span></span><span>
</span><span><span class="hljs-section">月: 7</span></span><span>
</span><span><span class="hljs-section">日: 16</span></span><span>
</span></span>

在这个例子中，cal_from_jd()将儒略日2459373.5转换成了2022年7月16日的公历日期。

3. 理解JD与日期之间的转换

儒略日（JD）是一个浮动数值，其中整数部分表示自公元前4713年1月1日正午以来的天数，小数部分则代表一天中的时间。比如，JD为2459373.5意味着这一天的正午时分，而JD为2459373.25则表示当天的0时（午夜）。对于不同的日历系统，cal_from_jd()会根据具体的规则调整日期的计算。

例子1：转换到儒略历

如果你想将儒略日转换为儒略历日期（Julian Calendar），可以使用以下代码：

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$jd</span></span><span> = </span><span><span class="hljs-number">2459373.5</span></span><span>;
</span><span><span class="hljs-variable">$calendar</span></span><span> = CAL_JULIAN;  </span><span><span class="hljs-comment">// 儒略历</span></span><span>
</span><span><span class="hljs-variable">$date</span></span><span> = </span><span><span class="hljs-title function_ invoke__">cal_from_jd</span></span><span>(</span><span><span class="hljs-variable">$jd</span></span><span>, </span><span><span class="hljs-variable">$calendar</span></span><span>);

</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"年: "</span></span><span> . </span><span><span class="hljs-variable">$date</span></span><span>[</span><span><span class="hljs-string">'year'</span></span><span>] . </span><span><span class="hljs-string">"\n"</span></span><span>;
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"月: "</span></span><span> . </span><span><span class="hljs-variable">$date</span></span><span>[</span><span><span class="hljs-string">'month'</span></span><span>] . </span><span><span class="hljs-string">"\n"</span></span><span>;
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"日: "</span></span><span> . </span><span><span class="hljs-variable">$date</span></span><span>[</span><span><span class="hljs-string">'day'</span></span><span>] . </span><span><span class="hljs-string">"\n"</span></span><span>;
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

输出：

<span><span><span class="hljs-section">年: 2022</span></span><span>
</span><span><span class="hljs-section">月: 7</span></span><span>
</span><span><span class="hljs-section">日: 3</span></span><span>
</span></span>

可以看到，儒略历与公历的日期不同，这是因为儒略历和公历在日期计算上有所差异。

4. 注意事项

  • 精度问题：cal_from_jd()函数的精度仅到日期的天数，因此，传入的JD值通常是一个浮动的数字，且小数部分不会影响日期的输出（除非你需要精确到小时或分钟）。如果需要处理更精确的时间，可以结合其他时间处理函数来实现。

  • 日期范围：不同的日历系统对于日期的范围有所不同。例如，希伯来历和伊斯兰历的起始日期和有效范围与公历和儒略历有所不同，因此要根据需求选择合适的日历系统。

  • 错误处理：确保传入的JD值有效。如果传入无效的JD，cal_from_jd()函数会返回false，因此在使用时需要做好异常处理。

相关内容