Skip to content

Park-SM/ParkDateTimePicker

Repository files navigation

Generic badge  Generic badge  Generic badge  Generic badge 

ParkDateTimePicker

Android library for selecting date and time from BottomSheet UI. ParkDateTimePicker is customizable so you can even specify your own language. If you think this library is useful, please press ⭐️ Star button at upside : )


# UI Design

Overview

DatePicker TimePicker

DatePicker clip

Screen_Recording_20230625_213951_ParkDateTimePicker.mp4

TimePicker clip

Screen_Recording_20230625_214051_ParkDateTimePicker.mp4

DateTimePicker clip

Screen_Recording_20230625_214148_ParkDateTimePicker.mp4

# How to use

Add mavenCentral and implementation as below code.

// build.gradle(:project)
repositories {
    ....
    mavenCentral()
}

// build.gradle(:app)
dependencies {

    implementation "com.smparkworld.parkdatetimepicker:parkdatetimepicker:1.1.0"
}

// ParkDateTimePicker use DataBinding.
// build.gradle(:app)
android {
    ....
    dataBinding {
        enabled = true
    }
}

# About DatePicker

To use the DatePicker, you have to set the DateListener using the setDateListener(:DateListener) function.

Basic usage

ParkDateTimePicker.builder(this)
    .setDateListener { date ->
        ....
    }
    .show()

Options

ParkDateTimePicker.builder(this)
    .setTitle("Custom Title")
    .setDayOfWeekTexts(arrayOf("Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"))
    .setResetText("Custom Reset")
    .setDoneText("Custom Done")
    .setPrimaryColorInt(ContextCompat.getColor(this, R.color.custom_primary))
    .setHighLightColorInt(ContextCompat.getColor(this, R.color.custom_high_light))
    .setMonthTitleFormatter { year, month ->
        "${year}-${String.format("%02d", month)}"
    }
    .setDateResultFormatter { year, month, day ->
        "${year}-${String.format("%02d", month)}-${String.format("%02d", day)}"
    }
    .setDateListener { date ->
        ....
    }
    .show()

# About TimePicker

To use the TimePicker, you have to set the TimeListener using the setTimeListener(:TimeListener) function.

Basic usage

ParkDateTimePicker.builder(this)
    .setTimeListener { time ->
        ....
    }
    .show()

Options

ParkDateTimePicker.builder(this)
    .setTitle("Custom Title")
    .setAmPmTexts(arrayOf("CustomAM", "CustomPM"))
    .setResetText("Custom Reset")
    .setDoneText("Custom Done")
    .setPrimaryColorInt(ContextCompat.getColor(this, R.color.custom_primary))
    .setHighLightColorInt(ContextCompat.getColor(this, R.color.custom_high_light))
    .setTimeResultFormatter { amPm, hour, minute ->
        "${amPm} ${String.format("%02d", hour)}h ${String.format("%02d", minute)}m"
    }
    .setTimeListener { time ->
        ....
    }
    .show()

# About DateTimePicker

To use the DateTimePicker, you have to set the DateTimeListener using the setDateTimeListener(:DateTimeListener) function.

Basic usage

ParkDateTimePicker.builder(this)
    .setDateTimeListener { dateTime ->
        ....
    }
    .show()

Options

ParkDateTimePicker.builder(this)
    .setTitle("Custom Title")
    .setDayOfWeekTexts(arrayOf("Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"))
    .setAmPmTexts(arrayOf("CustomAM", "CustomPM"))
    .setResetText("Custom Reset")
    .setDoneText("Custom Done")
    .setPrimaryColorInt(ContextCompat.getColor(this, R.color.custom_primary))
    .setHighLightColorInt(ContextCompat.getColor(this, R.color.custom_high_light))
    .setMonthTitleFormatter { year, month ->
        "${year}-${String.format("%02d", month)}"
    }
    .setDateResultFormatter { year, month, day ->
        "${year}-${String.format("%02d", month)}-${String.format("%02d", day)}"
    }
    .setTimeResultFormatter { amPm, hour, minute ->
        "${amPm} ${String.format("%02d", hour)}h ${String.format("%02d", minute)}m"
    }
    .setDateTimeListener { dateTime ->
        ....
    }
    .show()

# License

Copyright 2022 ParkSM

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.