Date conversion

This is actual flow of how this package convert myanmar date to Gregorian date.

We do not have direct conversion from Myanmar date to Gregorian date. To convert from Myanmar date to Gregorian date, we have to convert to Julian date first. Then, convert it to Gregorian date.

In Same way, converting from Gregorian date to Myanamr date also need to convert Gregorian date to Julian date first. Then, convert it to Myanmar date.

graph TD;
    M[Myanmar date]<-->J[Julian date];
    J<-->G[Gregorian date];
    C[Chinese date]<-->G;

Example

import { MyanmarDate, MyanmarMonths, MyanmarMonthType, MoonPhase } from 'mm-calendar';
const date = MyanmarDate({ day: 17, month: 10, year: 2024 }, { lang: 'mm' }) // Gregorian date

const date1 = MyanmarDate.fromMyanmarDate({
    year: 1386,
    month: MyanmarMonths.Tagu,
    day: 29,
    moonPhase: MoonPhase.waxing,
    myanmarMonthType: MyanmarMonthType.hnaung,
    fortnightDay: 14,
}, { lang: 'mm' })
const currentDate = MyanmarDate.now()

Date conversion

Convert date to different format

date.toGregorian()      // to gregorian date
date.toMoment()         // to momentjs date object
date.toMyanmarDate()    // to myanmar date
date.toDate()           // to javascript date object
date.toJulian()         // to julian date number

Myanmar Astro

Calculation of astro is based on https://coolemerald.blogspot.com/2013/06/algorithm-program-and-calculation-of.html

console.log(date.astro)

// OUTPUT: 
// {
//   sabbath: true,
//   sabbatheve: false,
//   yatyaza: false,
//   pyathada: true,
//   thamanyo: false,
//   amyeittasote: false,
//   warameittugyi: false,
//   warameittunge: false,
//   yatpote: false,
//   thamaphyu: false,
//   nagapor: false,
//   yatyotema: false,
//   mahayatkyan: false,
//   shanyat: false,
//   nagahle: 'west',
//   mahabote: 'Adipati',
//   nakhat: 'orc'
// }

Buddhist year

သာဿနာနှစ်

date.getBuddhistYear() 

Holidays

We can check the date is holiday or not. We put default public holiday and chinese holiday from မြန်မာ ၃ဘာသာ calendar.

International holiday

| Name | Date | | --------- | ------- | |1st January|New year| |14th Feb|Valentine day| |8th Mar|Woman day| |1th April|April fool day| |1st May|May day| |11th May|Mother day| |15th Jun|Father day| |24th Dec|Christmas|

Myanmar holiday

| Name | Date | | --------- | ------- | |14th Jan|လွတ်လပ်ရေးနေ့| |12th Feb|ပြည်ထောင်စုနေ့| |19th Feb|အာဇာနည်နေ့| |19th Mar|တောင်သူလယ်သမားနေ့| |27th Mar|တော်လှန်ရေးနေ့| |19th July|တော်လှန်ရေးနေ့| |11th Nov|အမျိုးသားနေ့| |တန်ခူးလ ၁ရက်|သင်္ကြန်| |တန်ခူးလ|သင်္ကြန် အကြို| |တန်ခူးလ|သင်္ကြန် အကျ| |တန်ခူးလ|သင်္ကြန် အတတ်| |တန်ခူးလ|သင်္ကြန် နှစ်ဆန်း ၁ရက်| |တပေါင်းလပြည့်ရက်|တပေါင်းလပြည့်နေ့| |သီတင်းကျွတ်လပြည့်ရက်|သီတင်းကျွတ်ပိတ်ရက်(၃)ရက်| |ဓမ္စကြာရက်လပြည့်နေ|ဓမ္စကြာပိတ်ရက်| |ကဆုန် လပြည့်နေ|ကဆုန်ညောင်ရေသွန်းပွဲ| |တန်းဆောင်မုန်း လပြည့်နေ|တန်းဆောင်မုန်း လပြည့်နေပိတ်ရက်| |ပြာသိုလ ၁ရက်နေ့|ကရင်နှစ်သစ်ကူး|

Chinese holiday

| Name | Date | | --------- | ------- | |1st Oct|国庆节| |24th Oct|平安夜 (Christmas eve)| |正月 初一|除夕| |正月 初六|清水祖师| |正月 初九|天宫宝生| |正月 十五|元宵节| |正月 十八|岱枝兴福| |二月 初二|福德正神诞辰| |二月 十九|观音宝诞| |三月 初七|清明节| |三月 廿三|马祖宝生| |五月 初五|端午节| |六月 廿九|观音得道| |七月 初七|七夕（chinese valentine day）| |七月 十五|中元节| |八月 初七|孔子诞辰| |九月 初九|重阳节（တရုတ်ရှင်ဥပဂုတ္တပူဇော်ပွဲ）| |九月 廿九|观音出家| |十一月 初二|冬至|

You can check if date is holiday or not

// Lunar based holiday is not fixed date in Gregorian Calendar
// it depend on Lunar cycle and moon phase 
console.log(date.isLunarBasedHoliday())

// Fixed date holiday mean
// for example, every year of Feb 14 is a valientine day
console.log(date.isFixedDateHoliday()) 

// combine both Lunar base holiday and fixed date holiday
console.log(date.isHoliday()) 

// Lunar based holiday full moon day
console.log(date.isFullmoonDay()) 

Get holidays in year of ...

static method that find all the holidays in a year is return array of RecursiveEventDate object. We put default public holiday and chinese holiday from မြန်မာ ၃ဘာသာ calendar

console.log(MyanmarDate.getHolidaysOfYear(2023))

// OUTPUT:
//  [
//   RecursiveEventDate {
//     day: 1,
//     month: 1,
//     culture: 'international',
//     type: 'fixed',
//     key: 'new-year'
//   },
//   RecursiveEventDate {
//     day: 11,
//     month: 1,
//     culture: 'burmese',
//     type: 'lunar',
//     key: 'karen-new-year'
//   },
//   RecursiveEventDate {
//     day: 14,
//     month: 1,
//     culture: 'international',
//     type: 'fixed',
//     key: 'independent-day'
//   },
//   ...
//  ]

Hide default holiday

You can hide default holiday by calling this functon everywhere;

HolidaysConfig.hideDefaultHoliday()

You can also set custom holiday !

if you don't want to use default holiday, you can manage custom holiday.

// don't forgot to hide default holiday
HolidaysConfig.hideDefaultHoliday(); 

// for fixed or gregorean date event 
// every year of first day of january is a new year
HolidaysConfig.add({ 
    day: 1, 
    month: 1, 
    culture: 'international', 
    type: 'fixed', 
    key: 'new-year', // => remember this key
    translation: {
        mm: 'နေ့နာနှစ်',
        en: 'New Year',
        cn: '新年'
    }
})



// You can also add lunar based event
// NOTE: it only support chinese and burmese lunar based unit and indian lunar based unit not supported yet

// FOR MYANMAR LUNAR BASED EVENT
// Myanmar lunar based unit require 
// "month" as MyanmarMonths
// "monthType" 
// "moonPhase" properties
// တန်ခူးလဆန်း ၁၁ ရက်နေ့ 
HolidaysConfig.add({
    day: 11,
    month: MyanmarMonths.Tagu,
    culture: 'burmese', // => change it into burmese
    type: 'lunar', // => change it into lunar instead of fixed
    monthType: MyanmarMonthType.oo, // required
    moonPhase: MoonPhase.waxing, // required
    key: 'karen-new-year', // => remember this key
    translation: {
        mm: 'ကရင်နှစ်သစ်ကူး',
        en: 'Karen New Year',
        cn: '卡恩新年'
    }
})


// FOR CHINESE LUNAR BASED EVENT
// 正月 廿三号
HolidaysConfig.add({
    day: 23, // 廿三
    month: 1, // 正月
    culture: 'chinese', // => change it into 'chinese'
    type: 'lunar', // => change it into lunar instead of fixed
    key: 'xin-nian', // => remember this key
    translation: {
        mm: 'တရုတ်ရိုးရာနှစ်သစ်ကူး',
        en: 'Chinese New Year',
        cn: '新年'
    }
})

Clear and delete custom holiday

HolidaysConfig.clearCustomHoliday()

// You can delete custom created holiday by using key
HolidaysConfig.deleteCustomHoliday('karen-new-year')

MyanmarDate object is immutable !!!

MyanmarDate object is immutable. Therefore we give API to modify and create new MyanmarDate object

const newDate = date.clone();
const date2 = date.copyWidth({ day: 1, month: 10 })

Language

Update language

date.setLang('mm')

Algorithm reference

Myanmar date calendar calculation https://coolemerald.blogspot.com/2013/06/algorithm-program-and-calculation-of.html

Myanmar date calendar calculation https://coolemerald.blogspot.com/2013/12/blog-post.html