agashe/arabic-date
Composer 安装命令:
composer require agashe/arabic-date
包简介
Handle hijri/gregorian calendar in both arabic and english.
README 文档
README
A PHP Package to handle hijri/gregorian calendar in both arabic and english
Features
- Hijri/Gregorian calendars.
- Support both arabic/english.
- Very lightwieght , 0 dependencies.
- Easy to use , set few options and run.
Installation
composer require agashe/arabic-date
Documentation
ArabicDate hijri converter depends on Kuwati Algorithm , in it's core a single class with few setters/gettes to configure your result.
After installation is done , include the class in your project by:
- including vendor/autoload.php for Native PHP projects
- or adding the class to your framework config , for example app/config/app.php for laravel ,
This table demonstrate the basic three setters , we use to initialize ArabicDate
| Method | Parameter | Options | Description |
|---|---|---|---|
| setCalendar | string | 'hijri', 'gregorian' | Select the calendar |
| setLanguage | string | 'arabic', 'english' | Select the language |
| setFormat | string | Check the table below | Select the date format pattern |
ArabicDate uses the default PHP date format characters , this table shows all supported characters in hijri calendar. (for gregorian calendar , all characters work normally !!)
| Format character | Description |
|---|---|
| d | Day of the month, 2 digits with leading zeros |
| D | A textual representation of a day |
| j | Day of the month without leading zeros |
| m | Numeric representation of a month, with leading zeros |
| M | A textual representation of a month |
| n | Numeric representation of a month, without leading zeros |
| y | A two digit representation of a year |
| Y | A full numeric representation of a year, 4 digits |
| h | 12-hour format of an hour with leading zeros |
| H | 24-hour format of an hour with leading zeros |
| i | Minutes with leading zeros |
| s | Seconds with leading zeros |
| a/A | AM/PM , but in arabic there's no lowercase and uppercase so they both are the same! |
This is the basic example for using ArabicDate
<?php
include "vendor/autoload.php";
use ArabicDate\ArabicDate;
$date = new ArabicDate();
$date->setCalendar('hijri');
$date->setLanguage('english');
$date->setFormat('Y-m-d');
echo $date->get();
// and also you can use the constructor
$date = new ArabicDate('y M D h:i:s a', 'arabic', 'gregorian');
echo $date->get();
Examples
// 1. hijri date in arabic
$date = new ArabicDate('Y/m/d هـ', 'arabic', 'hijri');
echo $date->get(); // ١٤٤٢/٠٩/١٢ هـ
// 2. hijri date in arabic with time
$date = new ArabicDate('Y-m-d h:i:s a', 'arabic', 'hijri');
echo $date->get(); // ١٤٤٢-٠٩-١٢ ٠٢:٢٢:٥٤ مساءً
// 3. gregorian date in arabic
$date = new ArabicDate('y M D h:i:s a', 'arabic', 'gregorian');
echo $date->get(); // ٢١ أبريل السبت ٠٢:١٩:٢٢ مساءً
// 4. hijri date in english with time
$date = new ArabicDate();
$date->setCalendar('hijri');
$date->setLanguage('english');
$date->setFormat('Y-m-d h:i:s a');
echo $date->get(); // 1442-09-12 02:26:10 Masa
License
(ArabicDate) released under the terms of the MIT license.
agashe/arabic-date 适用场景与选型建议
agashe/arabic-date 是一款 基于 PHP 开发的 Composer 扩展包,目前已累计 17 次下载、GitHub Stars 达 0, 最近一次更新时间为 2021 年 04 月 17 日, 在 PHP 生态内属于活跃度较高的组件。
它主要适用于以下技术方向: 「date」 「calendar」 「hijri」 等业务场景。在实际项目中,围绕这些方向常见需要落地的问题包括:接口对接、性能调优、并发安全、与既有框架(Laravel / ThinkPHP / Yii / Webman 等)的兼容适配,以及生产环境的日志埋点与稳定性保障。
我们在过去多个企业项目中使用过 agashe/arabic-date 或与其功能相近的方案,如果你在选型或落地过程中遇到问题,例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查,欢迎联系我们协助评估。
基于 agashe/arabic-date 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复;针对高流量场景做缓存、队列、索引层面的调优。
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维;也可按月提供技术保姆服务。
与 agashe/arabic-date 相关的其它包
同方向 / 同关键字的高下载量 PHP Composer 包推荐,方便对比选型:
Arabic php utilities from Khaled Al-Sham'aa's library http://ar-php.org/
Tools to convert between .NET and PHP date formats
A modern PHP library for generating iCalendar v2.0 events
A powerful event calendar Tool for Laravel's Nova 5.
Date component is a set of methods to help with the manipulation of dates.
Check for holidays - localeaware
统计信息
- 总下载量: 17
- 月度下载量: 0
- 日度下载量: 0
- 收藏数: 0
- 点击次数: 7
- 依赖项目数: 0
- 推荐数: 0
其他信息
- 授权协议: MIT
- 更新时间: 2021-04-17