Myanmar Calendar (Swift)

Myanmar Calendar library for Swift applications. A pure Swift Package Manager port of the popular Myanmar Calendar Java library.

For more information about the original project, see the website.

Features

• Convert between Western dates and Myanmar calendar dates
• Support for multiple calendar types (English, Gregorian, Julian)
• Calculate Buddhist Era
• Moon phase calculations
• Multiple language support (English, Myanmar Unicode, Zawgyi, Mon, Tai, Karen)
• Date formatting with customizable patterns
• Full Swift Package Manager support
• All calculations based on Myanmar Standard Time (UTC+06:30)

Requirements

• Swift 5.9+
• iOS 15.0+ / macOS 12.0+ / tvOS 15.0+ / watchOS 8.0+

Installation

Swift Package Manager

Add the following to your Package.swift file:

dependencies: [
    .package(url: "https://github.com/saitawngpha/myanmar-calendar.git", from: "1.0.0")
]

Or in Xcode:

1. File > Add Package Dependencies
2. Enter the repository URL
3. Select your version requirements

Usage

Basic Date Conversion

Convert Western Date to Myanmar Date

import MyanmarCalendar

// Get Myanmar Date from Western date
let myanmarDate = try MyanmarDate.of(year: 2024, month: 1, day: 1)

// Output: 1385
print(myanmarDate.getYearValue())

// Output: Nadaw
print(myanmarDate.getMonthName(.english))

// Output: နတ်တော်
print(myanmarDate.getMonthName(.myanmar))

// Output: Waning
print(myanmarDate.getMoonPhase(.english))

// Output: 5
print(myanmarDate.getFortnightDay(.english))

// Output: Monday
print(myanmarDate.getWeekDay(.english))

Create Myanmar Date from Current Time

let now = try MyanmarDate.now()
print("Myanmar Year: \(now.getYear(.english))")
print("Month: \(now.getMonthName(.english))")

Create Myanmar Date from Foundation Date

let date = Date()
let myanmarDate = try MyanmarDate.of(date)
print(myanmarDate.description)

Working with Myanmar Dates Directly

// Create Myanmar date by year, month, and day
let myanmarDate = try MyanmarDate.create(myear: 1385, mmonth: 9, monthDay: 5)

// Or by month name
let myanmarDate2 = try MyanmarDate.create(myear: 1385, myanmarMonthName: "Nadaw", monthDay: 5)

Configuration

Configure default calendar type and language:

// Default Language: Myanmar Unicode
// Default Calendar Type: English
// You can configure them:

let config = Config(calendarType: .english, language: .myanmar)
Config.initDefault(config)

// Or using the builder pattern
let config = Config.Builder()
    .setCalendarType(.gregorian)
    .setLanguage(.english)
    .build()
Config.initDefault(config)

Date Formatting

Format Myanmar dates with custom patterns:

let myanmarDate = try MyanmarDate.of(year: 2024, month: 1, day: 1)

// Example formats:
// Output: Sasana Year 2567 Ku, Myanmar Year 1385 Ku, Nadaw Waning 5 Yat Monday Nay
let formatted = myanmarDate.format("S s k, B y k, M p f r E n", .english)

// Output: သာသနာနှစ် ၂၅၆၇ ခု၊ မြန်မာနှစ် ၁၃၈၅ ခု၊ နတ်တော် လဆုတ် ၅ ရက် တနင်္လာနေ့
let myanmarFormatted = myanmarDate.format("S s k, B y k, M p f r En", .myanmar)

Myanmar Date Format Patterns

Letter	Component	Example (English)	Example (Myanmar)
S	Sasana year	Sasana Year	သာသနာနှစ်
s	Buddhist era	2567	၂၅၆၇
B	Burmese year	Myanmar Year	မြန်မာနှစ်
y	Myanmar year	1385	၁၃၈၅
k	Ku	Ku	ခု
M	Month	Nadaw	နတ်တော်
p	Moon phase	Waning	လဆုတ်
f	Fortnight day	5	၅
r	Yat	Yat	ရက်
E	Day name	Monday	တနင်္လာ
n	Nay	Nay	နေ့

Converting Back to Western Date

let myanmarDate = try MyanmarDate.of(year: 2024, month: 4, day: 15)

// Convert to WesternDate
let westernDate = myanmarDate.toWesternDate()
print("Western Date: \(westernDate.year)-\(westernDate.month)-\(westernDate.day)")

// Convert to Foundation Date
if let date = myanmarDate.toDate() {
    print("Foundation Date: \(date)")
}

Language Support

The library supports multiple languages:

public enum Language {
    case english
    case myanmar     // Unicode Standard (Burmese)
    case zawgyi      // Zawgyi encoding
    case mon         // Mon language
    case tai         // Tai language
    case sgawKaren   // Sgaw Karen language
}

// Example usage:
let myanmarDate = try MyanmarDate.of(year: 2024, month: 1, day: 1)

print(myanmarDate.getMonthName(.english))   // Nadaw
print(myanmarDate.getMonthName(.myanmar))   // နတ်တော်
print(myanmarDate.getWeekDay(.english))     // Monday
print(myanmarDate.getWeekDay(.myanmar))     // တနင်္လာ

Calendar Types

public enum CalendarType {
    case english    // English calendar
    case gregorian  // Gregorian calendar
    case julian     // Julian calendar
}

Advanced Usage

Get Buddhist Era

let myanmarDate = try MyanmarDate.of(year: 2024, month: 1, day: 1)

// Output: 2567
let buddhistEra = myanmarDate.getBuddhistEraValue()

// Output in Myanmar numerals: ၂၅၆၇
let buddhistEraMyanmar = myanmarDate.getBuddhistEra(.myanmar)

Working with Western Dates

// Create WesternDate
let westernDate = WesternDate(year: 2024, month: 4, day: 15)

// Convert to Myanmar Date
let myanmarDate = try westernDate.toMyanmarDate()

// Convert to Foundation Date
if let date = westernDate.toDate() {
    print("Foundation Date: \(date)")
}

// Create from Foundation Date
let now = Date()
let western = WesternDate.from(now)

Testing

Run the test suite:

swift test

Credits

This Swift package is a port of the Myanmar Calendar Java library by Chan Mrate Ko Ko.

The original algorithm is based on:

• Algorithm, Program and Calculation of Myanmar Calendar by Dr Yan Naing Aye

Language translations credits:

• Mon: ITVilla, proofread by Mikau Nyan
• Tai: Jao Tai Num, Tai Dictionary

Algorithm Notes

All calculations are based on Myanmar Standard Time (UTC+06:30) which is calculated on the basis of 97° 30' longitude.

The algorithm is capable of calculating from the commencement of the Myanmar Calendar Year 2 up to year 1500.

License

MIT License

Copyright (c) 2017 Chan Mrate Ko Ko (Original Java implementation)
Copyright (c) 2025 Sai Tawng Pha (Swift Port)

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Changelog

Version 1.0.0

• Initial Swift Package Manager release
• Core date conversion functionality
• Multiple language support
• Date formatting
• Comprehensive test coverage