momentkh

momentkh is an add-on feature to moment js library DEMO.

Install 🗜

$ npm install moment --save
$ npm install @thyrith/momentkh --save

How to use 🛫

This library is built depends on moment.js popular library. We added some functionality to make it easier to work with Khmer date format.

Nodejs

const moment = require('moment');
// Add our features to your preferred moment.js version
require('@thyrith/momentkh')(moment);

// From now on, your moment js is transformed

let today = moment();

console.log(today);
// Display date today as moment js object
// For example: moment("2018-12-15T14:49:38.586")

let khmerDate = today.toLunarDate();

console.log(khmerDate);
// Display khmer date
// For example: ថ្ងៃសៅរ៍ ៨កើត ខែមិគសិរ ឆ្នាំច សំរឹទ្ធស័ក ពុទ្ធសករាជ ២៥៦២

HTML

First, you need to clone this package to the root of your project or your /public folder.

*** For momentjs library, you can import it any method or any version you want.

<script src="https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.29.1/moment.min.js"></script>
<script src="momentkh/constant.js"></script>
<script src="momentkh/locale/km.js"></script>
<script src="momentkh/getSoriyatraLerngSak.js"></script>
<script src="momentkh/momentkh.js"></script>
<script>
	var moment = momentkh(moment)
	var today = moment()
	console.log('Today: ', today.toKhDate())
	console.log('New year at: ', moment.getKhNewYearMoment(2021))
</script>

Added Functionality 🎡

Attributes of moment instance

| Name | Parameter | Description | Example | |---------|-------|---------|----------------| |toLunarDate| empty or String |display format as Khmer lunar date | moment().toLunarDate(); | |khDay| empty |display khmer day index | moment().khDay(); 0 -> ១កើត 1 -> ២កើត 2 -> ៣កើត ... 15 -> ១រោច 16 -> ២រោច 17 -> ៣រោច ...| |khMonth| empty |display khmer month index | moment.khMonth(); 0 -> មិគសិរ 1 -> បុស្ស 2 -> មាឃ 3 -> ផល្គុន 4 -> ចេត្រ 5 -> ពិសាខ 6 -> ជេស្ឋ 7 -> អាសាឍ 8 -> ស្រាពណ៍ 9 -> ភទ្របទ 10 -> អស្សុជ 11 -> កក្ដិក 12 -> បឋមាសាឍ 13 -> ទុតិយាសាឍ| |khYear| empty |display Buddhist Era year | moment().khYear(); |

Alias

| Name | Original | |---------|----------------| |toKhDate, tokhdate|toLunarDate|

Attributes of moment

| Name | Parameter | Description | Example | |---------|-----|-----------|----------------| |getKhNewYearMoment| Integer | Return moment.js object. Giving the moment of Khmer New Year. (ពេលទេវតាចុះ) | moment.getKhNewYearMoment(2019);| |~~readLunarDate~~(currently working on this)| String or Object |Return moment.js object. Just same as calling: moment('13/04/2018', 'dd/mm/yyyy'); for Gregorian date |moment.readLunarDate('១៥កើត ពិសាខ ព.ស. ២៥៥៥'); |

Alias

| Name | Original | |---------|----------------| |khDate, khdate|readLunarDate|

Format

By default, it will return the format as shown in example above. However, you can also customize your format.

// Use moment.js as usual. Documentaion: momentjs.com
let myBirthday = moment('4/3/1992', 'd/m/yyy');

myBirthday.toLunarDate('dN ថ្ងៃW ខែm ព.ស. b');
// ៦កើត ថ្ងៃព្រហស្បតិ៍ ខែមិគសិរ ព.ស. ២៥៦២'

| Format | Description | Example | |---------|----------------|----------------| | W | ថ្ងៃនៃសប្ដាហ៍| អង្គារ | | w | ថ្ងៃនៃសប្ដាហ៍កាត់ | អ | | d | ថ្ងៃទី ចាប់ពីលេខ ១ ដល់ ១៥ | ១ | | D | ថ្ងៃទី ចាប់ពីលេខ ០១ ដល់ ១៥ | ០១ | | n | កើត ឬ រោច | ក | | N | កើត ឬ រោច | កើត | | o | របៀបសរសេរខ្លីអំពីថ្ងៃទី | ᧡ (មានន័យថា ១កើត)| | m | ខែចន្ទគតិ | មិគសិរ | | M | ខែសុរិយគតិ | មករា | | a | ឆ្នាំសត្វ | រកា | | e | ស័ក | ឯកស័ក | | b | ឆ្នាំពុទ្ធសករាជ | ២៥៥៦ | | c | ឆ្នាំគ្រិស្តសករាជ| ២០១៩ | | j | ឆ្នាំចុល្លសករាជ | ១៤៦៣ |

Bug Report 🐞🐜🦗🕷🕸🦂🦟🐛🐌💣

I know there will be a lot of error.

Testing

There is no test running on this package. If you are available for this work, it would be very awesome.

Contribute 💡

Welcome pull request

References

• គណនាម៉ោងទេវតាចុះ
• ប្រតិទិនចន្ទគតិ