MonthAndYearPicker

KO | EN

gitlite — search

#javascript #python #php #ruby #java #hacktoberfest #vim #dotfiles #c-sharp #sublime-text #metrics #monitoring

MonthAndYearPicker

★ 162 Open GitHub ↗

The month and year picker for Android. Now you can pick month and year or only month or only year.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MonthAndYearPicker

Month and Year Picker allow user to pick only month and year or only month or only year as required. You will get notified for all action's such as on selection of date, on selection of month and on section of year.

## Sample Project output:

![MonthAndYearPicker](https://github.com/premkumarroyal/MonthAndYearPicker/blob/master/sample/src/main/res/raw/datepicker.gif?raw=true "Month and Year Picker") ![MonthAndYearPicker](https://j.gifs.com/nZpE4P.gif?raw=true "Choose Month") ![MonthAndYearPicker](https://github.com/premkumarroyal/MonthAndYearPicker/blob/master/sample/src/main/res/raw/choose_year.gif?raw=true "Choose Year") ![MonthAndYearPicker](https://j.gifs.com/LgoKEv.gif?raw=true "Choose Quantity")

# Code

MonthPickerDialog.Builder builder = new MonthPickerDialog.Builder(MainActivity.this, 
     new MonthPickerDialog.OnDateSetListener() {
       @Override
       public void onDateSet(int selectedMonth, int selectedYear) { // on date set }
     }, today.get(Calendar.YEAR), today.get(Calendar.MONTH));
    
    builder.setActivatedMonth(Calendar.JULY)
           .setMinYear(1990)
           .setActivatedYear(2017)
           .setMaxYear(2030)
           .setMinMonth(Calendar.FEBRUARY)
           .setTitle("Select trading month")
           .setMonthRange(Calendar.FEBRUARY, Calendar.NOVEMBER)
           // .setMaxMonth(Calendar.OCTOBER)
           // .setYearRange(1890, 1890)
           // .setMonthAndYearRange(Calendar.FEBRUARY, Calendar.OCTOBER, 1890, 1890)
           //.showMonthOnly()
           // .showYearOnly()
           .setOnMonthChangedListener(new MonthPickerDialog.OnMonthChangedListener() {
             @Override
             public void onMonthChanged(int selectedMonth) { // on month selected } })
           .setOnYearChangedListener(new MonthPickerDialog.OnYearChangedListener() {
              @Override
              public void onYearChanged(int selectedYear) { // on year selected } })
            .build()
            .show();
                        
## Listeners
    setOnMonthChangedListener(OnMonthChangedListener());
    setOnYearChangedListener(OnYearChangedListener());

## Methods
 Methods | Docs
------------ | -------------
setMaxMonth(int maxMonth) |  Maximum month that user can select.
setMinMonth(int minMonth) |  Minimum month that user can select.
setMonthRange(int minMonth, int maxMonth) | set both max and min sections.
setActivatedMonth(activatedMonth) | selected the month when picker opens.
setMaxYear(int maxYear) | Maximum year that will be shown in picker.
setMinYear(int minYear) | Minimum year that will be shown in picker.
setYearRange(int minYear, int maxYear) | set both max and min selections.
setActivatedYear(activatedYear) | selected the year when picker opens.
setMonthAndYearRange(int minMonth, int maxMonth, int minYear, int maxYear) | set month and year min and max values at once.
showMonthOnly() | Only month selection will be shown.
showYearOnly() | Only year selection will be shown.
setTitle(String title) | set the title for Month Picker Dialog. By default title will be hidden, it will be visible if value set.
setOnMonthChangedListener(MonthPickerDialog.OnMonthChangedListener onMonthChange); | Listener for select month
setOnYearChangedListener(MonthPickerDialog.OnYearChangedListener onYearChange); | Listener for year select year

## Styling

Month and Year picker by default pick the color from theme if you declared colorAccent. If you want to change color's you can override the theme as below.

<item name="headerBgColor">@color/colorAccent</item>
        <item name="headerFontColorSelected">#fff</item>
        <item name="headerFontColorNormal">#85FFFFFF</item>
        <item name="headerTitleColor">#fff</item>

<item name="dialogActionButtonColor">@color/colorAccent</item>
    </style>

## Usage

Add Gradle Dependency in your build.gradle file

compile 'com.whiteelephant:monthandyearpicker:1.3.0'

or Maven

<dependency>
      <groupId>com.whiteelephant</groupId>
      <artifactId>monthandyearpicker</artifactId>
      <version>1.3.0</version>
      <type>pom</type>   
    </dependency>

MonthAndYearPicker

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README