biladina/hijridatetime

回历日期时间 - 用于使用回历日期时间的库,兼容沙特阿拉伯和穆斯林世界的“乌姆卡尔拉”正式日历

1.0.3 2024-07-31 07:58 UTC

This package is auto-updated.

Last update: 2024-08-31 08:36:28 UTC


README

回历日期时间库是为希望在其项目中使用回历日期并转换公历(格里历)到回历(伊斯兰历)的用户的方便且完整的解决方案。此库与沙特阿拉伯和穆斯林世界的“乌姆卡尔拉”正式日历100%兼容。

它支持阿拉伯语、英语、法语和印尼语。

原始源代码在这里

可用的Yii2框架扩展在这里

安装

安装此库的首选方式是通过composer

只需运行

composer require biladina/hijridatetime

用法

一旦安装了库,只需在您的代码中使用它

<?php

use biladina\hijridatetime\HijriDateTime;

// Choose Your Format Like 'l ، j F ، Y'
// Y => Hijri Year [1442]
// F => Hijri Month Arabic Name [رمضان]
// j => Hijri Day Number [27]
// l => Arabic Day Name [الجمعة]
// m => Hijri Month Number [09]
// a => 'ص'
// A => 'صباحًا'
// H => Hour
// i => Minutes
// s => Seconds

// set language is available, use 'ar' for Arabic, 'en' for English, 'fr' for France, and 'id' for Indonesia (which is the default language).

$hijri = new HijriDateTime();

$hijri->date("H:i A l, d F Y", time()) // formatting is like date function
// will return in Indonesia language if not set languange
// will return 16:16 PM Jum'at, 01 Ramadhan 1441
//---------------- Or ---------------------
$hijri->date("H:i A l, d F Y", time(), "fr")
// will return in France language
// will return 16:16 PM vendredi, 01 Ramadan 1441

$hijri->GeToHijr(20, 02, 1976)
// will return Array Hijri date[int month, int day, int year, int ln, int ml]

$hijri->strToHijri("24 April 2020")
// will return a Date in Hijri d-m-Y if not formated
//-------- Or -----------
$hijri->strToHijri("24 April 2020 15:00:00", "l, d F Y H:i A")
// will return in Indonesia language if not set languange
// will return a Date in Hijri as formated like Jum'at, 01 Ramadhan 1441 15:00 PM
//-------- Or -----------
$hijri->strToHijri("24 April 2020 15:00:00", "l, d F Y H:i A", "fr")
// will return in France language
// will return a Date in Hijri as formated like vendredi, 01 Ramadan 1441 15:00 PM

如果您想添加更多语言

  • 打开“language”目录
  • 复制其中的一个目录(我更喜欢“en”目录)并重命名为您国家的首字母,例如马来西亚的“ms”,德语的“de”
  • 在重命名的目录中打开“hijri.php”文件
  • 将其翻译成您的语言
  • 创建PR,我将将其合并到主项目中