MonthAndYearPicker Android Library

To use the MonthAndYearPicker library in your Android project, add the dependency to your build configuration.

Gradle: Add the following line to your build.gradle file:

compile 'com.whiteelephant:monthandyearpicker:1.3.0'

Maven: Add the following dependency to your pom.xml:

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

By default, the picker uses the colorAccent from your application theme. To override the colors, define a custom style in your XML resources:

<style name="MonthPickerDialogStyle" >
    <item name="monthBgColor">@color/bgColor</item>
    <item name="monthBgSelectedColor">@color/colorAccent</item>
    <item name="monthFontColorSelected">@color/selectionColor</item>
    <item name="monthFontColorNormal">@color/bgColor</item>
    <item name="monthFontColorDisabled">@color/bgColor</item>

    <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>

You can listen for changes as the user navigates through months or years using the following listeners:

• setOnMonthChangedListener(MonthPickerDialog.OnMonthChangedListener onMonthChange): Triggered when a new month is selected.
• setOnYearChangedListener(MonthPickerDialog.OnYearChangedListener onYearChange): Triggered when a new year is selected.
• OnDateSetListener: (Passed to the Builder constructor) Triggered when the final date (month and year) is confirmed.

Example of implementing change listeners:

builder.setOnMonthChangedListener(new MonthPickerDialog.OnMonthChangedListener() {
    @Override
    public void onMonthChanged(int selectedMonth) {
        // Logic for month change
    }
});

The MonthPickerView can be customized using XML attributes defined under the monthPickerDialog styleable. These attributes allow you to control the colors of the header, months, and action buttons.

Available attributes include:

• headerBgColor: Background color of the header.
• headerFontColorNormal: Font color for the header in normal state.
• headerFontColorSelected: Font color for the header when selected.
• monthBgColor: Background color of the month picker area.
• monthBgSelectedColor: Background color of a selected month.
• monthFontColorNormal: Font color for months in normal state.
• monthFontColorSelected: Font color for the selected month.
• monthFontColorDisabled: Font color for disabled months.
• headerTitleColor: Color of the dialog title.
• dialogActionButtonColor: Color for the 'OK' and 'Cancel' action buttons.

You can pass a HashMap<String, Integer> to setColors(HashMap<String, Integer> colors) to customize the text colors of the year labels. The adapter looks for the following specific keys:

• monthBgSelectedColor: The text color used when a year is currently selected.
• monthFontColorNormal: The text color used for unselected years.

HashMap<String, Integer> colors = new HashMap<>();
colors.put("monthBgSelectedColor", Color.BLUE);
colors.put("monthFontColorNormal", Color.BLACK);
yearPickerView.setColors(colors);

Use setYear(int year) to programmatically set the currently selected year. This method updates the selection in the adapter and automatically scrolls the list so the selected year is centered in the view.

yearPickerView.setYear(2025);

Use setRange(int min, int max) to define the minimum and maximum years available in the picker. This updates the underlying adapter and refreshes the list view.

yearPickerView.setRange(2020, 2030);

The YearPickerView is an Android UI component (extending ListView) used to display and select years. You can configure the range of available years, set the currently selected year, and listen for user selection changes.

To handle user interactions, implement the OnYearSelectedListener interface and register it using setOnYearSelectedListener.

yearPickerView.setOnYearSelectedListener(new YearPickerView.OnYearSelectedListener() {
    @Override
    public void onYearChanged(YearPickerView view, int year) {
        // Handle the year change
    }
});

Use the following methods to get the currently selected values from the picker:

• getMonth(): Returns the selected month as an integer (using Calendar constants).
• getYear(): Returns the selected year as an integer.

You can restrict the selectable range of months and years using the following methods:

• setMonthRange(int minMonth, int maxMonth): Sets the minimum and maximum month. Months must be between Calendar.JANUARY and Calendar.DECEMBER.
• setYearRange(int minYear, int maxYear): Sets the minimum and maximum year.
• setMonthYearRange(int minMonth, int maxMonth, int minYear, int maxYear): Sets both month and year ranges simultaneously.

Note: setMonthRange internally calls setMaxYear (likely a typo in the source for setMaxMonth), and setYearRange calls setMaxYear.