jalaali / jalaali-php
PHP函数,用于将伊斯兰历和公历相互转换。
dev-master
2019-07-30 19:30 UTC
Requires
- php: >=5.3.0
This package is not auto-updated.
Last update: 2024-09-28 17:49:22 UTC
README
PHP实现jalaali.js,其中包含用于将伊斯兰历和公历相互转换的函数。
伊斯兰历系统有不同的名称,例如
- 伊斯兰历
- 哈伊亚米
- 科尔希迪
- 波斯
- 沙姆斯
基本算法是奥马尔·哈亚姆的衍生作品,他900多年前完成了该日历系统。
关于
伊斯兰历是波斯使用的太阳历,其变体至今仍在伊朗以及阿富汗使用。阅读更多或查看日历转换器。
日历转换基于Kazimierz M. Borkowski提供的算法,性能非常好。
安装
composer require jalaali/jalaali-php
API
Jalaali命名空间内的基类定义了10个静态方法,因此无需实例化。例如,要将公历日期转换为伊斯兰历,请使用以下代码
// PHP 3.0.x date to Jalaali :) \Jalaali\Jalaali::toJalaali(2000, 10, 20)
关于此项目的完整文档页面位于docs/api
文件夹中,但方法列表如下
toJalaali($gy, $gm, $gd)
:将公历日期转换为伊斯兰历
toGregorian($jy, $jm, $jd)
:将伊斯兰历日期转换为公历
isValidJalaaliDate($jy, $jm, $jd)
:检查伊斯兰历日期是否有效
isLeapJalaaliYear($jy)
:检查是否为闰年
jalaaliMonthLength($jy, $jm)
:给定月份在伊斯兰年中的天数
jalaaliCalendar($jy)
:基本算法
j2d($jy, $jm, $jd)
:将伊斯兰历日期转换为儒略日数
d2j($jdn)
:将儒略日数转换为伊斯兰历日期
g2d($gy, $gm, $gd)
:从公历或儒略历日期计算儒略日数
d2g($jdn)
:从儒略日数计算公历和儒略历日期