jalaali/jalaali-php

PHP函数,用于将伊斯兰历和公历相互转换。

dev-master 2019-07-30 19:30 UTC

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):从儒略日数计算公历和儒略历日期