Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/AmirShayegh/DatePicker
A Date Picker with Calendar for iPhone and iPad Apps.
https://github.com/AmirShayegh/DatePicker
cocoapod cocoapods date datepicker ios ipad ipados iphone library picker swift swift5
Last synced: about 2 months ago
JSON representation
A Date Picker with Calendar for iPhone and iPad Apps.
- Host: GitHub
- URL: https://github.com/AmirShayegh/DatePicker
- Owner: AmirShayegh
- License: mit
- Created: 2018-08-08T21:25:19.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-06-18T10:14:24.000Z (over 1 year ago)
- Last Synced: 2024-11-15T03:13:56.976Z (2 months ago)
- Topics: cocoapod, cocoapods, date, datepicker, ios, ipad, ipados, iphone, library, picker, swift, swift5
- Language: Swift
- Homepage:
- Size: 12.7 MB
- Stars: 205
- Watchers: 4
- Forks: 24
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DatePicker
[](https://cocoapods.org/pods/DatePicker)
[](https://cocoapods.org/pods/DatePicker)
[](https://cocoapods.org/pods/DatePicker)
### A DatePicker for iOS 10 and Above
- iPad and iPhone support (popover on ipad, card on iphone)
- Dark mode support
- Can personalize colours
- Easy to use
|||  |
|:---:|:---:|:---:|
| iPhone | iPad | In Action |
## Installation
DatePicker is available through [CocoaPods](https://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod 'DatePicker', '~> 1.3.0'
```
## Quick Usage
```swift
import DatePicker
class ViewController: UIViewController {
@IBAction func DateButton(_ sender: UIButton) {
let minDate = DatePickerHelper.shared.dateFrom(day: 18, month: 08, year: 1990)!
let maxDate = DatePickerHelper.shared.dateFrom(day: 18, month: 08, year: 2030)!
let today = Date()
// Create picker object
let datePicker = DatePicker()
// Setup
datePicker.setup(beginWith: today, min: minDate, max: maxDate) { (selected, date) in
if selected, let selectedDate = date {
print(selectedDate.string())
} else {
print("Cancelled")
}
}
// Display
datePicker.show(in: self, on: sender)
}
}
```
## Detailed Usage
1) Import the library
```Swift
import UIKit
import DatePicker
class ViewController: UIViewController {
}
```
2) Setup
here are multiple ways to configure DatePicker:
- Basic - Picker between today and 100 years from now
```swift
let datePicker = DatePicker()
datePicker.setup { (selected, date) in
if selected, let selectedDate = date {
print("\(selectedDate)"
} else {
print("cancelled")
}
}
```
Set initial selected by setting the `beginWith` parameter:
```swift
datePicker.setup(beginWith: Date()) { (selected, date) in
if selected, let selectedDate = date {
print(selectedDate.string())
} else {
print("Cancelled")
}
}
```
Set initial selected by setting the `beginWith` parameter:
```swift
datePicker.setup(beginWith: Date()) { (selected, date) in
if selected, let selectedDate = date {
print(selectedDate.string())
} else {
print("Cancelled")
}
}
```
- Picker with minimum and maximum dates
```swift
datePicker.setup(min: minDate, max: maxDate) { (selected, date) in
if selected, let selectedDate = date {
print("\(selectedDate)"
} else {
print("cancelled")
}
}
```
Set initial selected by setting the `beginWith` parameter
```swift
datePicker.setup(beginWith: Date(), min: minDate, max: maxDate) { (selected, date) in
if selected, let selectedDate = date {
print("\(selectedDate)"
} else {
print("cancelled")
}
}
```
Set initial selected by setting the `beginWith` parameter
```swift
datePicker.setup(beginWith: Date(), min: minDate, max: maxDate) { (selected, date) in
if selected, let selectedDate = date {
print("\(selectedDate)"
} else {
print("cancelled")
}
}
```
You can also use DatePickerHelper's functions to help generate dates:
```Swift
let minDate = DatePickerHelper.shared.dateFrom(day: 18, month: 08, year: 1990)
let maxDate = DatePickerHelper.shared.dateFrom(day: 18, month: 08, year: 2020)
```
- Yearless Picker: select and return day and month integers independent of year.
```Swift
let datePicker = DatePicker()
datePicker.setupYearless { (selected, month, day) in
if selected, let day = day, let month = month {
print("selected \(month) \(day)")
// You can also use DatePickerHelper's functions:
// DatePickerHelper.shared.month(number: Int) will return the month string name
print("selected DatePickerHelper.shared.month(number: month) \(day)")
} else {
print("cancelled")
}
}
```
3) Display
- Screen Center:
```Swift
datePicker.display(in: self)
```
- Or as Popover (for iPads):
```Swift
datePicker.displayPopOver(on: button, in: self)
```
## Credit
- [Designed by Roop Jawl](https://www.linkedin.com/in/roopjawl/)
- [Developed by Amir Shayegh](https://www.linkedin.com/in/shayegh/)
## License
DatePicker is available under the MIT license. See the LICENSE file for more info.