如何解决PHP中Jalali日期处理的痛点，morilog/jalali助你轻松实现日期转换与操作_网络技术

如何解决PHP中Jalali日期处理的痛点，morilog/jalali助你轻松实现日期转换与操作

发布时间 - 2025-09-07 00:00:00 点击率：次

可以通过一下地址学习composer：学习地址

告别日期转换的烦恼：PHP Jalali 日历处理的救星

在开发面向中东或中亚地区用户的php应用程序时，我们经常会遇到一个特殊的日期处理难题：如何优雅地支持jalali（也称为波斯历或沙姆西历）日历。php的内置

datetime

对象和相关函数对格里高利历（公历）的支持可谓驾轻就熟，但在处理jalali历时，它们却显得束手无策。

实际痛点：当格里高利遇上Jalali

想象一下这样的场景：你的应用需要记录用户的活动时间，并以Jalali格式展示给他们；或者你需要根据Jalali日期来筛选数据，甚至进行复杂的日期加减运算。如果只依靠PHP原生功能，你可能会面临以下困境：

手动转换的复杂性： 你可能需要自己编写复杂的算法来将格里高利日期转换为Jalali日期，反之亦然。这不仅耗时，而且极易出错，尤其是涉及到闰年、月份天数等细节时。
格式化难题： 即使转换成功，如何将Jalali日期按照特定格式（例如，波斯语月份名称）输出，又是一个新的挑战。
日期操作的缺失： 想要在Jalali日期上进行“加一个月”、“减三天”这样的操作？原生PHP函数无法直接支持，你需要先转换回格里高利历，操作后再转换回来，过程繁琐且容易引入逻辑错误。
代码可读性与维护性差： 大量的自定义日期处理逻辑会使代码变得臃肿、难以理解和维护。

这些问题不仅拖慢了开发进度，也增加了后期维护的成本，更可能因为日期显示错误而影响用户体验。

解决方案：

morilog/jalali

—— 你的Jalali日期瑞士军刀

正当我为这些日期问题焦头烂额时，我发现了

morilog/jalali

这个宝藏级的Composer包。它彻底改变了我处理Jalali日期的方式，让一切变得前所未有的简单和高效。

morilog/jalali

是一个专门为PHP应用程序设计的库，旨在帮助开发者轻松地处理Jalali日期。它基于Jalali

datetime

类，提供了高可读性的API，涵盖了Jalali日期的创建、操作、比较和与格里高利历的转换等所有常用功能。

轻松安装，即刻上手

使用Composer安装

morilog/jalali

非常简单，只需一条命令：

composer require morilog/jalali:3.*

安装完成后，你就可以在项目中使用它了。

核心功能与使用示例

morilog/jalali

主要通过

Jalalian

类和

CalendarUtils

类来提供其功能。

Jalalian

类：面向对象的日期操作

Jalalian

类是这个库的核心，它提供了一个类似于PHP原生

datetime

或

Carbon

库的面向对象接口，用于处理Jalali日期。

创建Jalali日期： 你可以轻松地创建当前Jalali日期，或者从时间戳、字符串、甚至

Carbon

对象创建。

use Morilog\Jalali\Jalalian;

// 获取当前Jalali日期
$now = Jalalian::now();
echo $now->format('Y/m/d H:i:s'); // 例如：1402/09/25 10:30:00

// 从时间戳创建
$dateFromTimestamp = Jalalian::forge(time());
echo $dateFromTimestamp->format('Y-m-d');

// 从字符串创建 (支持多种格式)
$specificDate = Jalalian::fromFormat('Y-m-d H:i:s', '1397-01-18 12:00:40');
echo $specificDate->format('%A, %d %B %y'); // 例如：پنجشنبه، 18 فروردین 97

// 从 Carbon 对象创建
use Carbon\Carbon;
$carbonDate = Carbon::now();
$jalaliFromCarbon = Jalalian::fromCarbon($carbonDate);
echo $jalaliFromCarbon->format('Y/m/d');

格式化Jalali日期：

format()

方法支持

strftime()

风格的格式化字符串，让你能灵活地控制输出格式。

ago()

方法则能输出人性化的相对时间。

$date = Jalalian::now();
echo $date->format('%A, %d %B %Y'); // 例如：جمعه، 25 آذر 1402
echo $date->ago(); // 例如：چند لحظه پیش (几秒前)

日期加减运算：

add*()

和

sub*()

方法让日期计算变得直观。

$today = Jalalian::now();
$nextMonth = $today->addMonths(1);
echo $nextMonth->format('Y/m/d');

$lastWeek = $today->subDays(7);
echo $lastWeek->format('Y/m/d');

与格里高利历的转换：

toCarbon()

方法可以将

Jalalian

对象转换为

Carbon

对象，方便与PHP原生

datetime

生态系统集成。

$jalaliDate = Jalalian::now();
$carbonDate = $jalaliDate->toCarbon();
echo $carbonDate->toDateTimeString(); // 输出对应的格里高利日期

CalendarUtils

类：实用工具函数

CalendarUtils

提供了一系列静态方法，用于日期转换、校验和一些高级操作。

Jalali与格里高利互转：

use Morilog\Jalali\CalendarUtils;

// 格里高利转Jalali
$jalaliArray = CalendarUtils::toJalali(2025, 12, 16); // [1402, 9, 25]
echo implode('-', $jalaliArray); // 1402-9-25

// Jalali转格里高利
$gregorianArray = CalendarUtils::toGregorian(1402, 9, 25); // [2025, 12, 16]
echo implode('-', $gregorianArray); // 2025-12-16

日期校验：

// 校验Jalali日期
$isValidJalali = CalendarUtils::checkDate(1391, 2, 30, true); // true
$isValidGregorian = CalendarUtils::checkDate(2016, 5, 7, false); // true

数字转换： 在某些情况下，你可能需要将拉丁数字（0-9）转换为波斯数字（۰-۹），反之亦然。

$persianNumbers = CalendarUtils::convertNumbers('1395-02-19'); // ۱۳۹۵-۰۲-۱۹
$latinNumbers = CalendarUtils::convertNumbers('۱۳۹۵-۰۲-۱۹', true); // 1395-02-19