README

乌尔都日期时间库是一个PHP库，旨在处理具有乌尔都本地化的各种日期和时间操作。它包括将公历日期转换为希吉历、计算日期差异、格式化时间以及提供相对时间等功能，所有这些都在乌尔都语中。

安装

方法 1

使用composer安装 urdu-date-time-library 包

composer require callmeahmedr/urdu-date-time-library

方法 2

克隆存储库

git clone https://github.com/callmeahmedr/urdu-date-time-library.git

安装依赖

composer install

用法

以下是一个简单示例，演示如何在项目中使用乌尔都日期时间库

<?php

require 'vendor/autoload.php';

use UrduDateLibrary\UrduDate;

$urduDate = new UrduDate();

函数

convertToHijri($gregorianDate):

将公历日期（格式为 YYYY-MM-DD）转换为对应的希吉历日期。

// Hijri Conversion
$gregorianDate = '2024-09-07';
echo "Hijri Conversion for $gregorianDate: " . $urduDate->convertToHijri($gregorianDate) . "<br>";

getIslamicEvent($hijriDate):

获取给定希吉历日期的伊斯兰事件。希吉历日期格式应为 MM-DD。

// Islamic Event
$hijriDate = '12-10'; // Example Hijri date format
echo "Islamic Event for Hijri Date $hijriDate: " . $urduDate->getIslamicEvent($hijriDate) . "<br>";

getDateDifference($date1, $date2):

计算两个公历日期之间的差异，并以乌尔都语返回。

// Date Difference
$date1 = '2024-09-01';
$date2 = '2024-09-07';
echo "Date Difference between $date1 and $date2: " . $urduDate->getDateDifference($date1, $date2) . "<br>";

formatTimeInUrdu($time):

将时间字符串（格式为 HH:MM）格式化为乌尔都语表示。

// Time Formatting
$time = '14:30';
echo "Formatted Time in Urdu for $time: " . $urduDate->formatTimeInUrdu($time) . "<br>";

relativeTime($date):

提供与当前日期相比给定日期的相对时间描述，例如“1 دن پہلے”（1天前）在乌尔都语中。

// Relative Time
$pastDate = '2024-09-06';
echo "Relative Time for $pastDate: " . $urduDate->relativeTime($pastDate) . "<br>";

getUrduMonthDayName($gregorianDate):

返回公历日期的乌尔都语表示，包括日、月和年。日期应格式化为 YYYY-MM-DD。

// Urdu Month/Day Name
echo "Urdu Month/Day Name for Gregorian Date $gregorianDate: " . $urduDate->getUrduMonthDayName($gregorianDate) . "<br>";

贡献

欢迎贡献！请复制存储库并提交包含您更改的拉取请求。确保您的代码遵循现有的编码风格并包含相关测试。

许可

本项目采用MIT许可 - 有关详细信息，请参阅LICENSE文件。

编码愉快