A date picker tool which provides picking a single day in addition to a range of days

PrimeDatePicker

First, PrimeDatePicker is a date picker tool which provides picking a single day in addition to a range of days. Second, you can use its MonthView and CalendarView as stand-alone views in your projects.

Pick a Single Day	Pick a Range of Days	Fling Orientations

Download

PrimeDatePicker is available on bintray to download using build tools systems. Add the following lines to your build.gradle file:

repositories {
    jcenter()
}
  
dependencies {
    implementation 'com.aminography:primedatepicker:1.0.5'
}

Usage

To use PrimeDatePickerBottomSheet, simply use below snippet:

Kotlin

val datePicker = PrimeDatePickerBottomSheet.newInstance(
            currentDateCalendar,
            pickType,
            pickedSingleDayCalendar, // can be null
            pickedRangeStartCalendar, // can be null
            pickedRangeEndCalendar, // can be null
            minDateCalendar, // can be null
            maxDateCalendar, // can be null
            typefacePath // can be null
    )

datePicker.setOnDateSetListener(object : PrimeDatePickerBottomSheet.OnDayPickedListener {

    override fun onSingleDayPicked(singleDay: PrimeCalendar) {
        // TODO
    }

    override fun onRangeDaysPicked(startDay: PrimeCalendar, endDay: PrimeCalendar) {
        // TODO
    }
})

datePicker.show(supportFragmentManager)

Java

PrimeDatePickerBottomSheet datePicker = PrimeDatePickerBottomSheet.newInstance(
        currentDateCalendar, // for example: new PersianCalendar()
        pickType // for example: PickType.SINGLE
);

datePicker.setOnDateSetListener(new PrimeDatePickerBottomSheet.OnDayPickedListener() {

    @Override
    public void onSingleDayPicked(@NotNull PrimeCalendar singleDay) {
        // TODO
    }

    @Override
    public void onRangeDaysPicked(@NotNull PrimeCalendar startDay, @NotNull PrimeCalendar endDay) {
        // TODO
    }
});

datePicker.show(getSupportFragmentManager());

Stand-Alone Views

In addition to use PrimeDatePicker as a date picker tool, it is possible to employ stand-alone views in your project.
They are PrimeMonthView & PrimeCalendarView which can be used in layout xml files or instantiated programmatically.
For example:

xml

<com.aminography.primedatepicker.monthview.PrimeMonthView
    android:id="@+id/monthView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:padding="16dp" />

Programmatically

val monthView = PrimeMonthView(context)

1. XML Attributes

Applying customization has been provided for PrimeMonthView and PrimeCalendarView by using xml attributes as well as setting them programmatically.
For example:

xml

<com.aminography.primedatepicker.calendarview.PrimeCalendarView
    android:id="@+id/calendarView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:pickedDayCircleColor="#0000FF" />

Programmatically

calendarView.pickedDayCircleColor = Color.BLUE

1.1. Common attributes for PrimeMonthView & PrimeCalendarView:

1.2. PrimeCalendarView Specific Attributes:

2. Other Variables (Common for PrimeMonthView & PrimeCalendarView)

These variables are only accessible programmatically to get or set. (Available by getter and setter methods in java)

3. Listener (Common for PrimeMonthView & PrimeCalendarView)

You can listen to day picking actions by setting an instance of OnDayPickedListener to the views.
For example:

monthView.onDayPickedListener = object : OnDayPickedListener {

    override fun onDayPicked(pickType: PickType, 
                             singleDay: PrimeCalendar?, 
                             startDay: PrimeCalendar?, 
                             endDay: PrimeCalendar?) {
        // TODO
    }
}

Locale

PrimeMonthView and PrimeCalendarView (consequently PrimeDatePickerBottomSheet) have been implemented with localization capabilities.
By choosing locale for the PrimeCalendar instance which is passed to goto method, or by setting it directly to the views, you can localize names, digits, and layout direction.

Localization example for PrimeMonthView using PersianCalendar:

monthView.goto(PersianCalendar()) // or monthView.locale = Locale("fa")	monthView.goto(PersianCalendar(Locale.ENGLISH)) // or monthView.locale = Locale.ENGLISH

Localization example for PrimeCalendarView using HijriCalendar:

calendarView.goto(HijriCalendar()) // or calendarView.locale = Locale("ar")	calendarView.goto(HijriCalendar(Locale.ENGLISH)) // or calendarView.locale = Locale.ENGLISH

Customizing Texts in Date Picker Bottom Sheet

If you want to change the texts of the date picker bottom sheet, define some strings in your project's strings.xml with equal name defined in the library's strings.xml, to override them.

GitHub