Persian CalendarView and TimePicker

A highly customizable calendar library for Android, powered by RecyclerView.

With this library, your calendar will look however you want it to.

Features

• Single or range selection - The library provides the calendar logic which enables you to implement the view whichever way you like.
• Disable desired dates - Prevent selection of some dates by disabling them.
• Boundary dates - limit the calendar date range.
• Custom date view - make your day cells look however you want, with any functionality you want.
• Custom calendar view - make your calendar look however you want, with whatever functionality you want.
• Easily scroll to any date or month view using the date.
• Use all RecyclerView customisations(decorators etc) since CalendarView extends from RecyclerView.

Sample project

It's very important to check out the sample app. Most techniques that you would want to implement are already implemented in the examples.

View the sample app's source code here

Setup

The library uses java.time classes via Java 8+ API desugaring for backward compatibility since these classes were added in Java 8.

Step 1

To setup your project for desugaring, you need to first ensure that you are using Android Gradle plugin 4.0.0 or higher.

Then include the following in your app's build.gradle file:

android {
  defaultConfig {
    // Required ONLY when setting minSdkVersion to 17 or higher
    multiDexEnabled true
  }

  compileOptions {
    // Flag to enable support for the new language APIs
    coreLibraryDesugaringEnabled true
    // Sets Java compatibility to Java 8
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
  }
}

Step 2

Add the JitPack repository to your project level build.gradle:

allprojects {
 repositories {
    google()
    jcenter()
    maven { url "https://jitpack.io" }
 }
}

Add CalendarView to your app build.gradle:

dependencies {
	implementation 'com.github.Loopersgroup:persian-calendar:<latest-version>'
}

Usage

Step 1

use date picker and show this by new DatePickerDialog when need range date picker must use DateRangeCalendarView.SelectionMode.Range when use single date picker must use DateRangeCalendarView.SelectionMode.Single when want last days disable must use DateRangeCalendarView.HolidayMode.Enable when use last days enable must use DateRangeCalendarView.HolidayMode.Disable The view passed in here is the inflated day view resource which you provided.

        AppCompatEditText dateTxt = findViewById(R.id.date_txt);
         DatePickerDialog datePickerDialog = null;
         datePickerDialog = new DatePickerDialog(MainActivity.this);
         datePickerDialog.setSelectionMode(DateRangeCalendarView.SelectionMode.Range, DateRangeCalendarView.HolidayMode.Enable);
         datePickerDialog.setCanceledOnTouchOutside(true);
         datePickerDialog.setOnRangeDateSelectedListener(new DatePickerDialog.OnRangeDateSelectedListener() {
                    @Override
                    public void onRangeDateSelected(PersianCalendar startDate, PersianCalendar endDate) {
                        dateTxt.setText(startDate.getPersianShortDate());
                    }
                });

         datePickerDialog.showDialog();

Step 2

use time picker and show this by new TimePickerDialog

 TimePickerDialog timePickerDialog = new TimePickerDialog(this, new TimePickerDialog.TimePickerCallback() {
                @Override
                public void onTimeSelected(int hours, int mins) {
                    TimeTxt.setText(String.valueOf(hours)+" : "+String.valueOf(mins));
                }

                @Override
                public void onCancel() {

                }
            });

            timePickerDialog.showDialog();

Inspiration

CalendarView was inspired by the Android library PersianRangeDatePicker. I used PersianRangeDatePicker in an Android project but couldn't find anything as customizable on Android so I built this. You'll find some similar terms like InDateStyle, OutDateStyle, DayOwner etc.