alirezaafkar/PersianDatePicker

An Android DatePicker for Persian Calendar

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.alirezaafkar:PersianDatePicker:1.1.1'
	}

	dependencies {
		implementation("com.github.alirezaafkar:PersianDatePicker:1.1.1")
	}

	<dependency>
	    <groupId>com.github.alirezaafkar</groupId>
	    <artifactId>PersianDatePicker</artifactId>
	    <version>1.1.1</version>
	</dependency>


                            
    libraryDependencies += "com.github.alirezaafkar" % "PersianDatePicker" % "1.1.1"


                            
    :dependencies [[com.github.alirezaafkar/PersianDatePicker "1.1.1"]]

Readme

PersianDatePicker

An Android DatePicker for Persian Calendar

ScreenShot

Usage:

Add as an Android Library Project:
- Add this line to root layout element:
  <pre><code>xmlns:persianDatePicker="http://schemas.android.com/apk/res-auto"</code></pre>
- Add PersianDatePicker view:
  <pre><code><ir.smartlab.persindatepicker.PersianDatePicker android:layout_width="wrap_content" android:layout_height="wrap_content"/></code></pre>
Add Source and other required things to your Project:
- Copy all sources to your source tree.
- Copy /res/layout/sl_persian_date_picker.xml to your /res/layout folder.
- Add this to your /res/values/attrs.xml:
  <pre><code><declare-styleable name="PersianDatePicker"> <attr name="minYear" format="integer" /> <attr name="maxYear" format="integer" /> <attr name="selectedYear" format="integer" /> <attr name="selectedMonth" format="integer" /> <attr name="selectedDay" format="integer" /> <attr name="displayMonthNames" format="boolean" /> <attr name="yearRange" format="integer" /> </declare-styleable></code></pre>

Params:

minYear: Min value for year in the picker. Default is current Hijri Shamsi (Jalali) year - yearRange(default is 10).
maxYear: Max value for year in the picker. Default is current Hijri Shamsi (Jalali) year + yearRange(default is 10).
yearRange: If you set a selected year, available years in picker will be from (selectedYear - yearRange) to (selectedYear + yearRange). Default value is 10.
selectedYear: Selected year that PersianDatePicker starts with. Default is the current Hijri Shamsi (Jalali) year.
selectedMonth: Selected month that PersianDatePicker starts with. Default is the current Hijri Shamsi (Jalali) year's month.
selectedDay: Selected day of month that PersianDatePicker starts with. Default is the current Hijri Shamsi (Jalali) month's day.
displayMonthNames: If set to true, months names are displayed, otherwise their number will be shown.
displayDescription: If set to true, a TextView below datepicker will show the selected date with more details.

Examples:

Display a PersianDatePicker with current Hijri Shamsi (Jalali) values:
<pre><code><ir.smartlab.persindatepicker.PersianDatePicker android:layout_width="wrap_content" android:layout_height="wrap_content"/></code></pre>
Display a PersianDatePicker with selected Hijri Shamsi (Jalali) date:
<pre><code><ir.smartlab.persindatepicker.PersianDatePicker android:layout_width="wrap_content" android:layout_height="wrap_content" app:selectedYear="1390" app:selectedMonth="5" app:selectedDay="15" /></code></pre>
Display a PersianDatePicker that shows month names:
<pre><code><ir.smartlab.persindatepicker.PersianDatePicker android:layout_width="wrap_content" android:layout_height="wrap_content" app:displayMonthNames="true" /></code></pre>
Display a PersianDatePicker that shows years between 1350 and 1450:
<pre><code><ir.smartlab.persindatepicker.PersianDatePicker android:layout_width="wrap_content" android:layout_height="wrap_content" app:maxYear="1450" app:minYear="1350" /></code></pre>

Java Examples:

You can set a java.util.Date object to PersianDatePpicker in java code:
<pre><code>persianDatePicker.setDisplayDate(new Date());</code></pre>
you can also set a ir.smartlab.persindatepicker.util.PersianCalendar object:
<pre><code>PersianCalendar persianCalendar = new PersianCalendar(); persianCalendar.setPersianDate(1393, 6, 28); persianDatePicker.setDisplayPersianDate(persianCalendar);</code></pre>
You can get displayed date in java.util.Date or ir.smartlab.persindatepicker.util.PersianCalendar:
<pre><code>Date d = persianDatePicker.getDisplayDate(); // OR PersianCalendar pCal = persianDatePicker.getDisplayPersianDate();</code></pre>

Leap Year:

In Hijri Shamsi some years are leap year, so the last month of year is 30 days (not 29 days). PersianDatePicker take cares of leap years. This means that users will never pick a wrong date.

To Do:

Support Persian digits as an option
Support typeface settings

Credits:

PersianDatepicker is heavily based on AOSP (https://source.android.com) and persian-calendar (https://github.com/mortezaadi/persian-calendar).

Version

1.0

License

Apache License Version 2.0