PrimeDatePicker

:zap:

Firstly,

PrimeDatePicker

MonthView

CalendarView

Multiple Days | Civil BottomSheet | Dark	Range of Days | Persian BottomSheet | Light	Single Day | Hijri Dialog | Light	Goto Feature | Japanese Dialog | Dark

Table of Contents

• Core Logic
• Main Characteristics
• Download
• Usage
  • Java Example
  • Builder Configurations
  • Input Calendar Configurations
• Customizing Theme
  • Customizing Texts
• Stand-Alone Views
• Change Log

Core Logic

The ❤️ of this library is provided by PrimeCalendar.

Main Characteristics

• Endless Scrolling
• Fully Customizable Views & Themes
• Align With Material Design
• Fluent UI
• RTL Support
• Landscape Support
• Various Calendar Types
• Various Date Picking Strategies
• Dialog & BottomSheet Presentations
• Fast Goto

:dart: Download SampleApp.apk

Download

PrimeDatePicker

build.gradle

repositories {
    jcenter()
}

dependencies {
    implementation 'com.aminography:primedatepicker:3.4.0'
    implementation 'com.aminography:primecalendar:1.3.2'
}

Usage

To enjoy

PrimeDatePicker

1. Decide on BottomSheet or Dialog representation along with an initial calendar: ```kotlin // To show a date picker with Civil dates, also today as the starting date val today = CivilCalendar()

val datePicker = PrimeDatePicker.bottomSheetWith(today) // or dialogWith(today) ```

1. Decide on picking strategy along with passing a proper callback: ```kotlin val callback = SingleDayPickCallback { day -> // TODO }

val today = CivilCalendar()

val datePicker = PrimeDatePicker.bottomSheetWith(today) .pickSingleDay(callback) // or pickRangeDays(callback) or pickMultipleDays(callback) ```

1. Apply some optional configurations:

...

val datePicker = PrimeDatePicker.bottomSheetWith(today)
        .pickSingleDay(callback)
        .initiallyPickedSingleDay(pickedDay)
        ...

1. Build the date picker and show it: ```kotlin val callback = SingleDayPickCallback { day -> // TODO }

val today = CivilCalendar()

val datePicker = PrimeDatePicker.bottomSheetWith(today) .pickSingleDay(callback) .initiallyPickedSingleDay(pickedDay) .build()

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

Java Example

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

// To show a date picker with Japanese dates, also today as the starting date PrimeCalendar today = new JapaneseCalendar();

PrimeDatePicker datePicker = PrimeDatePicker.Companion.dialogWith(today) .pickSingleDay(callback) .build();

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

Builder Configurations

There are several builder functions applying relevant configurations on the date picker.

Input Calendar Configurations

In addition to the builder functions,

PrimeDatePicker

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

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

Customizing Theme

PrimeDatePicker

In this way, a set of customizable theme factory classes are provided to specify theme parameters. By default, there are two concrete subclasses for the them factory:

• DarkThemeFactory

• LightThemeFactory

You can override their parameters, or inherit a class from, or make your own theme factory.

Here is an example of how to override theme parameters to customize it:

val themeFactory = object : LightThemeFactory() {

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

override val dialogBackgroundColor: Int
    get() = getColor(R.color.yellow100)

override val calendarViewBackgroundColor: Int
    get() = getColor(R.color.yellow100)

override val pickedDayBackgroundShapeType: BackgroundShapeType
    get() = BackgroundShapeType.ROUND_SQUARE

override val calendarViewPickedDayBackgroundColor: Int
    get() = getColor(R.color.green800)

override val calendarViewPickedDayInRangeBackgroundColor: Int
    get() = getColor(R.color.green400)

override val calendarViewPickedDayInRangeLabelTextColor: Int
    get() = getColor(R.color.gray900)

override val calendarViewTodayLabelTextColor: Int
    get() = getColor(R.color.purple200)

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 indigo = getColor(R.color.indigo500)
        put(Calendar.SATURDAY, red)
        put(Calendar.SUNDAY, red)
        put(Calendar.MONDAY, indigo)
        put(Calendar.TUESDAY, indigo)
        put(Calendar.WEDNESDAY, indigo)
        put(Calendar.THURSDAY, indigo)
        put(Calendar.FRIDAY, indigo)
    }

override val calendarViewShowAdjacentMonthDays: Boolean
    get() = true

override val selectionBarBackgroundColor: Int
    get() = getColor(R.color.brown600)

override val selectionBarRangeDaysItemBackgroundColor: Int
    get() = getColor(R.color.orange700)
}

Using above theme, we can transform the light theme (left picture) to the right one.

Normal Light Theme	Customized Light Theme

Java Theme Customization Example ```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

To see how to use

PrimeMonthView

PrimeCalendarView

Change Log

The change log is available here.

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.