https://github.com/hamid97m/herodatepicker
A Jetpack Compose Date Picker for Persian (Jalali) Calendar by Jetpack Compose.
https://github.com/hamid97m/herodatepicker
android androidlibrary calender date-picker datepicker jetpack-compose kotlin persian persian-date-picker persian-to-gregorian
Last synced: about 1 month ago
JSON representation
A Jetpack Compose Date Picker for Persian (Jalali) Calendar by Jetpack Compose.
- Host: GitHub
- URL: https://github.com/hamid97m/herodatepicker
- Owner: hamid97m
- License: mit
- Created: 2020-07-15T14:36:52.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2025-01-26T13:39:06.000Z (4 months ago)
- Last Synced: 2025-01-26T14:24:46.822Z (4 months ago)
- Topics: android, androidlibrary, calender, date-picker, datepicker, jetpack-compose, kotlin, persian, persian-date-picker, persian-to-gregorian
- Language: Kotlin
- Homepage: https://github.com/hamid97m/HeroDatePicker
- Size: 1.33 MB
- Stars: 24
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# HeroDatePicker
HeroDatePicker is a customizable date picker component for Android Jetpack Compose that allows users
to easily select Persian (Jalali) dates in a visually appealing way. It features a sleek and modern
design, with smooth animations and intuitive controls.
[](https://jitpack.io/#hamid97m/herodatepicker)
## Features:
- Support for Persian (Jalali) calendar system
- Customizable date format and locale
- Ability to disable specific dates or date ranges
- Integration with ViewModel for state management
- Easy-to-use API with clear documentation
## Setup
### Configure the repositories
`HeroDatePicker` is available through the *JitPack* repository. You can declare this repository in
your build script as follows:
Kotlin DSL
```kotlin
repositories {
maven { url = uri("https://jitpack.io") }
}
```
Groovy DSL
```groovy
repositories {
maven { url 'https://jitpack.io' }
}
```
### Add the dependency
After repository configuration, add a dependency on HeroDatePicker to your module's `build.gradle`
file:
Kotlin DSL
```kotlin
dependencies {
implementation("com.github.hamid97m:herodatepicker:1.0.0")
}
```
Groovy DSL
```groovy
dependencies {
implementation 'com.github.hamid97m:herodatepicker:1.0.0'
}
```
## Usage
```kotlin
HeroDatePicker(Modifier.fillMaxWidth()) { selectedDate ->
val (year, month, day) = selectedDate
println("Selected Date: $year/$month/$day")
}
```
In addition, there is a sample app available in the
project's [sample directory](https://github.com/hamid97m/HeroDatePicker/tree/master/sample) that
demonstrates how to use the library.
## Contributing
We welcome contributions from the community! If you find a bug or have a feature request, please open an issue on the GitHub repository. If you'd like to contribute code, please fork the repository and submit a pull request.
## License
HeroDatePicker is licensed under the MIT License.