PrimeDatePicker

:zap:

First,

PrimeDatePicker

MonthView

CalendarView

Picking Multiple Days Example for Civil	Picking a Range of Days Example for Persian	Picking a Single Day Example for Hijri	Goto View Example for Japanese

Core Logic

The ❤️ of this library is provided by PrimeCalendar.

Main Characteristics

• Endless Scrolling
• Fully Customizable Views & Theme
• Regarding Material Design
• Fluent UI
• RTL Support
• Landscape Support
• Various Calendar Types
• Various Date Picking Strategies
• Showing Both Dialog & BottomSheet
• Fast Goto

:dart: Download SampleApp.apk

Download

PrimeDatePicker

build.gradle

repositories {
    jcenter()
}

dependencies {
    implementation 'com.aminography:primedatepicker:3.2.0'
    implementation 'com.aminography:primecalendar:1.3.0'
}

Usage

To enjoy

PrimeDatePicker

Kotlin ```kotlin

val multipleDaysPickCallback = MultipleDaysPickCallback { multipleDays -> // TODO }

val themeFactory = DarkThemeFactory()

val today = CivilCalendar() // Causes a Civil date picker, also today as the starting date

val datePicker = PrimeDatePicker.bottomSheetWith(today) // or dialogWith(today) .pickMultipleDays(multipleDaysPickCallback) // Passing callback is optional, can be set later using setDayPickCallback() .minPossibleDate(minDateCalendar) // Optional .maxPossibleDate(maxDateCalendar) // Optional .disabledDays(disabledDaysList) // Optional .firstDayOfWeek(Calendar.MONDAY) // Optional .applyTheme(themeFactory) // Optional .build()

datePicker.show(supportFragmentManager, "SOME_TAG") ```

Java ```java SingleDayPickCallback singleDayPickCallback = new SingleDayPickCallback() { @Override public void onSingleDayPicked(PrimeCalendar singleDay) { // TODO } };

BaseThemeFactory themeFactory = new LightThemeFactory();

PrimeCalendar today = new JapaneseCalendar(); // Causes a Japanese date picker, also today as the starting date

PrimeDatePicker datePicker = PrimeDatePicker.Companion.dialogWith(today) // or bottomSheetWith(today) .pickSingleDay(singleDayPickCallback) // Passing callback is optional, can be set later using setDayPickCallback() .minPossibleDate(minDateCalendar) // Optional .maxPossibleDate(maxDateCalendar) // Optional .disabledDays(disabledDaysList) // Optional .firstDayOfWeek(Calendar.MONDAY) // Optional .applyTheme(themeFactory) // Optional .build();

datePicker.show(getSupportFragmentManager(), "SOME_TAG"); ```

Configurations Based on Input Calendar

PrimeDatePicker

// shows a Persian calendar, but in English language which leads to LTR direction
val calendar = PersianCalendar(Locale.ENGLISH).also {
    it.year = 1398                       // customizes starting year
    it.month = 7                         // customizes starting month
    it.firstDayOfWeek = Calendar.MONDAY  // sets first day of week to Monday
}

val datePicker = PrimeDatePicker.bottomSheetWith(calendar)
                    .pickSingleDay(singleDayPickCallback)
                     ...
                    .build()

Customizing Theme

PrimeDatePicker

In this way, a theme factory class is provided which declares theme parameters. A concrete subclass of this class realizes the parameters to be used by views. By default, there are two concrete subclasses:

DarkThemeFactory

LightThemeFactory

Here is an example of how to override theme parameters in

Kotlin

Java

Kotlin ```kotlin val themeFactory = object : LightThemeFactory() {

override val typefacePath: String?
    get() = "fonts/Roboto-Regular.ttf"

override val calendarViewPickedDayInRangeBackgroundColor: Int
    get() = getColor(R.color.red100)
override val calendarViewPickedDayInRangeLabelTextColor: Int
    get() = getColor(R.color.gray900)
override val calendarViewWeekLabelFormatter: LabelFormatter
    get() = { primeCalendar ->
        when (primeCalendar[Calendar.DAY_OF_WEEK]) {
            Calendar.SATURDAY,
            Calendar.SUNDAY -> String.format("%s😍", primeCalendar.weekDayNameShort)
            else -> String.format("%s😁", primeCalendar.weekDayNameShort)
        }
    }
override val calendarViewWeekLabelTextColors: SparseIntArray
    get() = SparseIntArray(7).apply {
        val red = getColor(R.color.red300)
        val green = getColor(R.color.green400)
        put(Calendar.SATURDAY, red)
        put(Calendar.SUNDAY, red)
        put(Calendar.MONDAY, green)
        put(Calendar.TUESDAY, green)
        put(Calendar.WEDNESDAY, green)
        put(Calendar.THURSDAY, green)
        put(Calendar.FRIDAY, green)
    }
 // Other customizations...

} ```

Result:

Java ```java BaseThemeFactory themeFactory = new LightThemeFactory() {

@NotNull
@Override
public PrimeCalendarView.FlingOrientation getCalendarViewFlingOrientation() {
    return PrimeCalendarView.FlingOrientation.HORIZONTAL;
}

@Override
public int getSelectionBarBackgroundColor() {
    return super.getColor(R.color.green300);
}
// Other customizations...

}; ```

Customizing Texts

If you want to change some texts in

PrimeDatePicker

strings.xml

strings.xml

Stand-Alone Views

In addition to use

PrimeDatePicker

PrimeMonthView

PrimeCalendarView

xml

xml

xml

Programmatically

kotlin
val monthView = PrimeMonthView(context)

1. XML Attributes

Applying customization has been provided for

PrimeMonthView

PrimeCalendarView

xml

xml

xml

Programmatically

kotlin
calendarView.pickedDayBackgroundColor = 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?,
                         multipleDays: List<primecalendar>?) {
    // TODO
}
}

Locale

PrimeMonthView

PrimeCalendarView

PrimeDatePicker

PrimeCalendar

goto

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

Change Log

Version 3.2.0

• Ability to show adjacent months' days in the current month (using

  showAdjacentMonthDays

  ) and customize their text color.
• Ability to change the background shape of the selected days (using

  pickedDayBackgroundShapeType

  and

  pickedDayRoundSquareCornerRadius

  ).
• Minor improvements.

Version 3.1.1

• Some UI adjustments.

Version 3.1.0

• Adding ability to change background and text color of days in selected range.
• Improvement in japanese text and temporal names.
• Minor bug fixed.

Version 3.0.4

• A minor bug fixed.

Version 3.0.0

• Builder mechanism has changed a bit.
• Adding full customization ability using a user configurable theme factory.
• Ability to show the date picker as a dialog using

  PrimeDatePicker.dialogWith

  method as well as

  PrimeDatePicker.bottomSheetWith

  to show a bottom sheet.
• Ability to specify a list of disabled days.

Version 2.0.0

• Builder mechanism has changed.
• Picking multiple days has better UX.
• Adding Goto by tapping on Month-Year.
• Picking animation has improved.
• Possibility to change start day of week.
• Adding RTL support in bottom sheet.```

Version 1.1.0

• Migrated to AndroidX

Version 1.0.16

• Ability to pick multiple days using

  MULTIPLE

  PickType.

Version 1.0.15

• A minor bug is fixed.

Version 1.0.14

• Animation for selected days using

  animateSelection

  ,

  animationDuration

  , and

  animationInterpolator

  attributes.

Third-Party Libraries

• PrimeCalendar (https://github.com/aminography/PrimeCalendar)

• PrimeAdapter (https://github.com/aminography/PrimeAdapter)

License

Copyright 2019 Mohammad Amin Hassani.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
   http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.