Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/florent37/singledateandtimepicker
You can now select a date and a time with only one widget !
https://github.com/florent37/singledateandtimepicker
android date design dialog material picker range time
Last synced: about 2 months ago
JSON representation
You can now select a date and a time with only one widget !
- Host: GitHub
- URL: https://github.com/florent37/singledateandtimepicker
- Owner: florent37
- License: apache-2.0
- Archived: true
- Created: 2016-12-02T15:53:14.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2023-03-15T19:15:52.000Z (over 1 year ago)
- Last Synced: 2024-09-25T22:40:52.350Z (about 2 months ago)
- Topics: android, date, design, dialog, material, picker, range, time
- Language: Java
- Homepage:
- Size: 21.2 MB
- Stars: 1,020
- Watchers: 27
- Forks: 334
- Open Issues: 158
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# SingleDateAndTimePicker
You can now select a date and a time with only one widget !
[](https://www.github.com/florent37/SingleDateAndTimePicker)
# Usage
```java
new SingleDateAndTimePickerDialog.Builder(context)
//.bottomSheet()
//.curved()
//.stepSizeMinutes(15)
//.displayHours(false)
//.displayMinutes(false)
//.todayText("aujourd'hui")
.displayListener(new SingleDateAndTimePickerDialog.DisplayListener() {
@Override
public void onDisplayed(SingleDateAndTimePicker picker) {
// Retrieve the SingleDateAndTimePicker
}
@Override
public void onClosed(SingleDateAndTimePicker picker) {
// On dialog closed
}
})
.title("Simple")
.listener(new SingleDateAndTimePickerDialog.Listener() {
@Override
public void onDateSelected(Date date) {
}
}).display();
```
## Select 2 dates
[](https://www.github.com/florent37/SingleDateAndTimePicker)
```java
new DoubleDateAndTimePickerDialog.Builder(context)
//.bottomSheet()
//.curved()
//.stepSizeMinutes(15)
.title("Double")
.tab0Text("Depart")
.tab1Text("Return")
.listener(new DoubleDateAndTimePickerDialog.Listener() {
@Override
public void onDateSelected(List dates) {
}
}).display();
```
## Display days, months and years
[](https://www.github.com/florent37/SingleDateAndTimePicker)
```java
new SingleDateAndTimePickerDialog.Builder(this)
.bottomSheet()
.curved()
.displayMinutes(false)
.displayHours(false)
.displayDays(false)
.displayMonth(true)
.displayYears(true)
.displayDaysOfMonth(true)
.display();
```
## Include in a layout
[](https://www.github.com/florent37/SingleDateAndTimePicker)
```xml
```
# iOS like :P
[](https://www.github.com/florent37/SingleDateAndTimePicker)
```java
new SingleDateAndTimePickerDialog.Builder(context)
.bottomSheet()
.curved()
```
[](https://www.github.com/florent37/SingleDateAndTimePicker)
```java
new DoubleDateAndTimePickerDialog.Builder(context)
.bottomSheet()
.curved()
```
# Customisation
You can change the minutes steps (default : 5min)
```java
new SingleDateAndTimePickerDialog.Builder(context)
.stepSizeMinutes(15)
.display();
```
And change some colors
[](https://www.github.com/florent37/SingleDateAndTimePicker)
```java
new SingleDateAndTimePickerDialog.Builder(context)
.backgroundColor(Color.BLACK)
.mainColor(Color.GREEN)
.titleColor(Color.WHITE)
.display();
```
# Date range
Require user to select a date between a range
```java
new SingleDateAndTimePickerDialog.Builder(context)
.defaultDate(defaultDate)
.minDateRange(minDate)
.maxDateRange(maxDate)
.display();
```
Or simply require user to select a future date
```java
new SingleDateAndTimePickerDialog.Builder(context)
.mustBeOnFuture()
.display();
```
# Changing typeface
```java
final SingleDateAndTimePicker singleDateAndTimePicker2 = findViewById(R.id.single_day_picker2);
singleDateAndTimePicker2.setTypeface(ResourcesCompat.getFont(this, R.font.dinot_regular));
```
Or pass it as an attribute in the XML layout. (See XML section on how to use it.)
# XML
Some/most options are also available via XML:
```
```
* picker_itemSpacing: Margin between items. Only has effect with
height=wrap-content
* picker_curvedMaxAngle sets the max angle of top/bottom items. If 45
then the visible 'window' of the wheel is a 'quarter' of the circle.
If 90 (default) its rolling on a half-circle
* `app:fontFamily` or `android:fontFamily` sets the typeface/font to be
used with the date picker.
Note - For api below v-16 use `app:fontFamily`
Get divider lines around selected by overwriting one or more of
```
@android:color/transparent
1dp
@drawable/picker_divider
```
Use in conjuction with
`app:picker_selectorColor="@android:color/transparent"` on layout.
# Download
In your module [](https://bintray.com/florent37/maven/SingleDateAndTimePicker/_latestVersion)
```groovy
implementation 'com.github.florent37:singledateandtimepicker:2.2.7'
//compatible with androidX
```
# Credits
Author: Florent Champigny
Blog : [http://www.tutos-android-france.com/](http://www.tutos-android-france.com/)
Fiches Plateau Moto : [https://www.fiches-plateau-moto.fr/](https://www.fiches-plateau-moto.fr/)
License
--------
Copyright 2016 florent37, Inc.
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.