README

BanglaDateTime 是一个PHP库，允许您轻松地将DateTime格式化为孟加拉历法和孟加拉数字格式。它支持当前时间和自定义日期，以及时区。

功能

• 将DateTime转换为孟加拉格式。
• 转换为孟加拉历法（孟加拉纪元）。
• 支持自定义日期和时区。
• 使用流畅的API易于使用。
• 提供辅助函数以轻松访问常见操作。

安装

您可以通过 Composer 安装此包

composer require bangladatetime/php

使用方法

要使用 BanglaDateTime，您可以创建一个日期和时间的新实例，使用当前时间、特定日期或特定时区。

基本示例

use BanglaDateTime\BanglaDateTime;

require __DIR__ . '/vendor/autoload.php';

// Create a BanglaDateTime instance with the current date and time, formatted in Bangla locale
$date = BanglaDateTime::create();
echo 'Current time with Bangla format: ' . $date->format('l jS F Y h:i:s');

echo '<br>';

// Create a BanglaDateTime instance with the current date and time, converted to the Bangla calendar
$date = BanglaDateTime::create();
echo 'Current time converted to Bangla: ' . $date->toBangla('l jS F Y h:i:s');

输出

Current time with Bangla format: বৃহস্পতিবার ১২ই সেপ্টেম্বর ২০২৪ ০৩:৩৭:০৩
Current time converted to Bangla: বৃহস্পতিবার ২৮শে ভাদ্র ১৪৩১ ০৩:৩৭:০৩

设置自定义日期

您也可以在创建 BanglaDateTime 实例时指定自定义日期

// Create a BanglaDateTime instance with a custom date ('2023-04-13'), formatted in Bangla locale
$date = BanglaDateTime::create('2023-04-13');
echo 'Set Time with Bangla format: ' . $date->format('l jS F Y h:i:s');

echo '<br>';

// Create a BanglaDateTime instance with a custom date ('2023-04-13'), converted to the Bangla calendar
$date = BanglaDateTime::create('2023-04-13');
echo 'Set Time & converted to Bangla: ' . $date->toBangla('l jS F Y h:i:s');

输出

Set Time with Bangla format: বৃহস্পতিবার ১৩ই এপ্রিল ২০২৩ ১২:০০:০০
Set Time & converted to Bangla: বৃহস্পতিবার ৩০শে চৈত্র ১৪২৯ ১২:০০:০০

处理时区

您还可以在创建 BanglaDateTime 实例时传递时区

// Create a BanglaDateTime instance with the current time and a specific timezone ('Asia/Dhaka'), formatted in Bangla locale
$date = BanglaDateTime::create('now', 'Asia/Dhaka');
echo 'Set Time & Time Zone with Bangla format: ' . $date->format('l jS F Y h:i:s');

echo '<br>';

// Create a BanglaDateTime instance with the current time and a specific timezone ('Asia/Dhaka'), converted to the Bangla calendar
$date = BanglaDateTime::create('now', 'Asia/Dhaka');
echo 'Set Time & Time Zone & converted to Bangla: ' . $date->toBangla('l jS F Y h:i:s');

输出

Set Time & Time Zone with Bangla format: বৃহস্পতিবার ১২ই সেপ্টেম্বর ২০২৪ ০৯:৩৭:০৩
Set Time & Time Zone & converted to Bangla: বৃহস্পতিবার ২৮শে ভাদ্র ১৪৩১ ০৯:৩৭:০৩

API

BanglaDateTime::create($time = 'now', $timezone = 'UTC')

创建一个新的 BanglaDateTime 实例。

• $time: 要使用的日期和时间（可选，默认为 'now'）。
• $timezone: 要使用的时区（可选，默认为 'UTC'）。

format($format)

使用指定的格式格式化日期和时间，输出为孟加拉语区域。

• $format: 格式字符串（与PHP的 DateTime::format 相同）。

toBangla($format)

将日期和时间转换为孟加拉历法和孟加拉数字。

• $format: 格式字符串（与PHP的 DateTime::format 相同）。

辅助函数

BanglaDateTime 提供以下全局辅助函数以方便访问

• bangla_date_time($time = 'now', $timezone = 'UTC'): 创建一个新的 BanglaDateTime 实例。

  $date = bangla_date_time('2023-04-13', 'Asia/Dhaka');

• format_bangla_date($format, $time = 'now', $timezone = 'UTC'): 格式化日期/时间为孟加拉格式。

  echo format_bangla_date('l jS F Y h:i:s');

• convert_to_bangla_calendar($format, $time = 'now', $timezone = 'UTC'): 将日期/时间转换为孟加拉历法格式。

  echo convert_to_bangla_calendar('l jS F Y h:i:s');

贡献

请随意通过提交拉取请求或打开问题来贡献。您的贡献非常受赞赏！

许可证

此库是开源软件，使用MIT许可证。