The PHP libray for convert datetime into Khmer

This is a small package for converting datetime to Khmer language.

Requirements

• PHP 7.0 or higher

Setup

You don't need to install by composer if your project doesn't have it.

Just import it manually in src folder.

But If you want to install by a composer, please follow the command below

composer require phannaly/php-datetime-khmer

Usage

Whenever you want to convert any DateTime into Khmer language, just wrap it inside method.

Firstly, you can import or instance class

use KhmerDateTime\KhmerDateTime;

You have to parse a valid string DateTime format and without a specific time, it will set time to 00:00

$dateTime = KhmerDateTime::parse('2019-05-22');

$dateTime->day(); // ២២
$dateTime->fullDay(); // ពុធ
$dateTime->month(); // ០៥
$dateTime->fullMonth(); // ឧសភា
$dateTime->year(); // ២០១៩
$dateTime->minute(); // ០០
$dateTime->hour(); // ០០
$dateTime->meridiem(); // ព្រឹក
$dateTime->week(); // ៤
$dateTime->fullWeek(); // សប្តាហ៍ទី៤
$dateTime->weekOfYear(); // ២១
$dateTime->fullWeekOfYear(); // សប្តាហ៍ទី២១
$dateTime->quarter(); // ២
$dateTime->fullQuarter(); // ត្រីមាសទី២

For example:

$dateTime = KhmerDateTime::parse('2020-09-20 12:40');

will producing result below

Code	Format	Output
$dateTime->format("L")	L	២០/០៩/២០២០
$dateTime->format("LL")	LL	២០ កញ្ញា ២០២០
$dateTime->format("LLT")	LLT	២០ កញ្ញា ២០២០ ១២:៤០ ល្ងាច
$dateTime->format("LLL")	LLL	អាទិត្យ ២០ កញ្ញា ២០២០
$dateTime->format("LLLT")	LLLT	អាទិត្យ ២០ កញ្ញា ២០២០ ១២:៤០ ល្ងាច
$dateTime->format("LLLLT")	LLLL	ថ្ងៃអាទិត្យ ទី២០ ខែកញ្ញា ឆ្នាំ២០២០
$dateTime->format("LLLLT")	LLLLT	ថ្ងៃអាទិត្យ ទី២០ ខែកញ្ញា ឆ្នាំ២០២០ ១២:៤០ ល្ងាច

If you wanna use DateTime duration in Khmer, you can use fromNow() method that checks the date that you parse compare with your current timestamp. The default fromNow method will add space between duration, if you want to remove space just add fromNow(false) Ex:

KhmerDateTime::parse('2012-10-20')->fromNow() // ៧ ឆ្នាំមុន
KhmerDateTime::parse('2012-10-20')->fromNow(false) // ៧ឆ្នាំមុន

Below is the example how fromNow() method works

Code	Current timestamp	Output
KhmerDateTime::parse('2012-10-20')->fromNow()	2020-09-20	៧ ឆ្នាំមុន
KhmerDateTime::parse('2020-03-20')->fromNow()	2020-09-20	៦ ខែមុន
KhmerDateTime::parse('2020-09-15')->fromNow()	2020-09-20	៥ ថ្ងៃមុន
KhmerDateTime::parse('2020-09-15 02:00')->fromNow()	2020-09-15 06:00	៤ ម៉ោងមុន
KhmerDateTime::parse('2020-09-15 06:00')->fromNow()	2020-09-15 06:03	៣ នាទីមុន

If you parse the timestamp in the future

Code	Current timestamp	Output
KhmerDateTime::parse('2027-10-20')->fromNow()	2020-09-20	៧ ឆ្នាំទៀត
KhmerDateTime::parse('2021-03-20')->fromNow()	2020-09-20	៦ ខែទៀត
KhmerDateTime::parse('2020-09-25')->fromNow()	2020-09-20	៥ ថ្ងៃទៀត
KhmerDateTime::parse('2020-09-15 10:00')->fromNow()	2020-09-15 06:00	៤ ម៉ោងទៀត
KhmerDateTime::parse('2020-09-15 06:03')->fromNow()	2020-09-15 06:00	៣ នាទីទៀត

Using the current timestamp without specific date and time

$dateTime = KhmerDateTime::now();
// or 
$dateTime = new KhmerDateTime();

Contributing

Feel free to contribute through PR.

License

This package operates under the MIT License (MIT). See the LICENSE file for details.