README.md

Java Persian Calendar

The main class of this project that you can copy to your project freely is PersianCalendar.

This calendar is unlimited as long as Kayyam rules and Java are correct. You can see important functions in here and here. And if you want to more proof of correctness of this class you can see the tests.

However, this class is written in android project structure, you can simply use it in java projects.

BTW, roll method of calendar is not supported, and I have no plan to support it. Also, The maximum and minimum of fields are not carefully determined yet, but as you can see in tests, from year 3000 before hijra to 3000 after hijra is a valid interval for this calendar.

Add to dependencies

This single class library is added to jcenter, so you can add it to your Android project as the following. Before gradle 3.0

dependencies {
    compile 'ir.hadilq:Persian-Calendar:1.1.3'
}

After gradle 3.0

dependencies {
    implementation 'ir.hadilq:Persian-Calendar:1.1.3'
}

Usage

You can use it like this

PersianCalendar calendar = new PersianCalendar();
calendar.setTimeInMillis(time);
int year = calendar.get(Calendar.YEAR);
int month = calendar.get(Calendar.MONTH); // zero base just like standard Java SDK calendar
int dayOfMonth = calendar.get(Calendar.DAY_OF_MONTH);

int hourOfDay = calendar.get(Calendar.HOUR_OF_DAY);
int minute = calendar.get(Calendar.MINUTE);
int second = calendar.get(Calendar.SECOND);

Or you can use it like this

PersianCalendar calendar = new PersianCalendar(1395, 7, 23, 10, 56, 52);
long millis = calendar.getTimeInMillis()

Also you can use add method like this

calendar.add(Calendar.DATE, 1);

Or this

calendar.add(Calendar.DATE, -1);