Swiftpack.co -  spneshaei/ShamsiDatePicker as Swift Package
Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
spneshaei/ShamsiDatePicker
An easy to use SwiftUI date picker for Shamsi (Persian) calendar
.package(url: "https://github.com/spneshaei/ShamsiDatePicker.git", from: "1.0.0")

ShamsiDatePicker

An easy-to-use SwiftUI iOS/watchOS date picker for Shamsi (Persian) calendar.

ShamsiDatePicker in iOS ShamsiDatePicker in iOS with Dark Mode

ShamsiDatePicker in Apple Watch ShamsiDatePicker in Apple Watch used in a `Form` view

Features

  • Pure (100%) SwiftUI implementation
  • Full support for Shamsi (Persian) calendar, including weekday names and leap years
  • Easy to customize various properties, such as minimum and maximum date allowed
  • Simple to use in various views by adding a single line of code
  • Support for both iOS (13.0 +) and watchOS (7.0 +) apps with great-looking styles
  • Compact style when used in watchOS Forms

Installation

ShamsiDatePicker can easily be installed using Swift Package Manager (SPM).

  1. Open your project in Xcode.
  2. Click File -> Swift Packages -> Add Package Dependency...
  3. Add https://github.com/spneshaei/ShamsiDatePicker.git as a package

Usage

Basic Usage

To use ShamsiDatePicker in a SwiftUI view, you should import ShamsiDatePicker first:

import ShamsiDatePicker

Then, you can start using ShamsiDatePicker:

struct ContentView: View {
    @State var date = Date()
    
    var body: some View {
        ShamsiDatePicker(selectedDate: $date)
    }
}

Setting a Range of Supported Dates

To specify the minimum and maximum possible-to-select dates from ShamsiDatePicker, you can specify those dates in ShamsiDatePickers initializer:

ShamsiDatePicker(selectedDate: $date, minDate: Date(timeIntervalSince1970: 0), maxDate: Date())

Using ShamsiDatePicker in SwiftUI Forms

ShamsiDatePicker works with SwiftUI Forms out of the box. When using ShamsiDatePicker in watchOS, using ShamsiDatePicker in a Form will result in a compact date picker, suitable for the Apple Watch's small display. When you use ShamsiDatePicker outside of the Form view, ShamsiDatePicker will be rendered as a wheel scrolling view, similar to its iOS counterpart.

License

To see the license which is applied to all the files in the current repository, open LICENSE.

GitHub

link
Stars: 16
Last commit: 2 weeks ago

Ad: Job Offers

iOS Software Engineer @ Perry Street Software
Perry Street Software is Jack’d and SCRUFF. We are two of the world’s largest gay, bi, trans and queer social dating apps on iOS and Android. Our brands reach more than 20 million members worldwide so members can connect, meet and express themselves on a platform that prioritizes privacy and security. We invest heavily into SwiftUI and using Swift Packages to modularize the codebase.

Submit a free job ad (while I'm testing this). The analytics numbers for this website are here.

Release Notes

v1.0.0
2 weeks ago

First release of ShamsiDatePicker

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics