https://github.com/park-sm/parkdatetimepicker

Android library for selecting date and time from BottomSheet UI.
https://github.com/park-sm/parkdatetimepicker

android android-library bottomsheet date datepicker datetimepicker library picker picker-library pickerview time timepicker

Last synced: 12 months ago
JSON representation

Android library for selecting date and time from BottomSheet UI.

Host: GitHub
URL: https://github.com/park-sm/parkdatetimepicker
Owner: Park-SM
License: apache-2.0
Created: 2022-09-17T10:04:48.000Z (almost 4 years ago)
Default Branch: main
Last Pushed: 2023-07-09T09:04:26.000Z (almost 3 years ago)
Last Synced: 2025-04-22T10:31:48.260Z (about 1 year ago)
Topics: android, android-library, bottomsheet, date, datepicker, datetimepicker, library, picker, picker-library, pickerview, time, timepicker
Language: Kotlin
Homepage:
Size: 301 KB
Stars: 5
Watchers: 1
Forks: 1
Open Issues: 3
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

          ![Generic badge](https://img.shields.io/badge/Platform-Android-green.svg) 

![Generic badge](https://img.shields.io/badge/Repository-MavenCentral-blue.svg) 

![Generic badge](https://img.shields.io/badge/Version-v1.1.0-red.svg) 

![Generic badge](https://img.shields.io/badge/License-Apache2.0-3DB7CC.svg) 

# 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](https://github.com/Park-SM/ParkDateTimePicker#-ui-design)

    - [Overview](https://github.com/Park-SM/ParkDateTimePicker#overview)

    - [DatePicker clip](https://github.com/Park-SM/ParkDateTimePicker#datepicker-clip)

    - [TimePicker clip](https://github.com/Park-SM/ParkDateTimePicker#timepicker-clip)

    - [DateTimePicker clip](https://github.com/Park-SM/ParkDateTimePicker#datetimepicker-clip)

- [How to use](https://github.com/Park-SM/ParkDateTimePicker#-how-to-use)

- [About DatePicker](https://github.com/Park-SM/ParkDateTimePicker#-about-datepicker)

    - [Basic usage](https://github.com/Park-SM/ParkDateTimePicker#basic-usage)

    - [Options](https://github.com/Park-SM/ParkDateTimePicker#options)

- [About TimePicker](https://github.com/Park-SM/ParkDateTimePicker#-about-timepicker)

    - [Basic usage](https://github.com/Park-SM/ParkDateTimePicker#basic-usage-1)

    - [Options](https://github.com/Park-SM/ParkDateTimePicker#options-1)

- [About DateTimePicker](https://github.com/Park-SM/ParkDateTimePicker#-about-datetimepicker)

    - [Basic usage](https://github.com/Park-SM/ParkDateTimePicker#basic-usage-2)

    - [Options](https://github.com/Park-SM/ParkDateTimePicker#options-2)

- [More Sample](https://github.com/Park-SM/ParkDateTimePicker/blob/develop/app/src/main/java/com/smparkworld/sample/MainActivity.kt)

- [License](https://github.com/Park-SM/ParkDateTimePicker#-license)




## # UI Design

#### *Overview*

    

        DatePicker

        TimePicker

    

    

        

        

    

#### *DatePicker clip*

https://github.com/Park-SM/ParkDateTimePicker/assets/47319426/426a9050-2552-4343-b25d-99deb7843c6d

#### *TimePicker clip*

https://github.com/Park-SM/ParkDateTimePicker/assets/47319426/88c98780-f1d8-403b-965f-3e2b385a5986

#### *DateTimePicker clip*

https://github.com/Park-SM/ParkDateTimePicker/assets/47319426/6bd073e7-666a-4769-87ab-d2ffc14f741c




## # How to use

Add mavenCentral and implementation as below code.

```groovy

// 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*

```kotlin

ParkDateTimePicker.builder(this)

    .setDateListener { date ->

        ....

    }

    .show()

```

#### *Options*

```kotlin

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*

```kotlin

ParkDateTimePicker.builder(this)

    .setTimeListener { time ->

        ....

    }

    .show()

```

#### *Options*

```kotlin

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*

```kotlin

ParkDateTimePicker.builder(this)

    .setDateTimeListener { dateTime ->

        ....

    }

    .show()

```

#### *Options*

```kotlin

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.

```

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/park-sm/parkdatetimepicker

Awesome Lists containing this project

README