Custom Calendar View Library in Android

The CustomCalendarView is an open source library that provides ability to create a calendar view in Android. It displays the days of a month in a grid layout and allows navigating between months and is highly customizable.

Custom Calendar View Features

Currently it allows the following features:

• Next and previous month navigation
• Allow various customization including background color for day, week and title
• Set custom typeface using setCustomTypeFace() method.
• Show hide next previous month overflow days
• Set custom day options for start day of week. By default it is set to Calendar.SUNDAY
• Unlimited customizations for day of the month using custom Decorators.
• Allow you to handle event when user changes month and day selection.

Library Compatibility

This library is compatible from API 14.

Add CustomCalendarView Library

To use the CustomCalendarView in your application, you first need to add the library to your application. You can do this by either from Gradle, Maven or by directly downloading the source code form GitHub.

Gradle

Step 1. Add the JitPack repository to your build file

Step-1 Add it in your build.gradle at the end of repositories:

repositories {
    maven { url "https://jitpack.io" }
}

Step-2 Add the dependency in the form

dependencies {
    compile 'com.github.npanigrahy:Custom-Calendar-View:v1.1'
}

Maven

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

Step 2. Add the dependency in the form

<dependency>
     <groupId>com.github.npanigrahy</groupId>
     <artifactId>Custom-Calendar-View</artifactId>
     <version>v1.1</version>
</dependency>

Sbt

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

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

Step-2 Add the dependency in the form

libraryDependencies += "com.github.npanigrahy" % "Custom-Calendar-View" % "v1.1"

Using CustomCalendarView Library

The GitHub project source includes a sample application, that is used for demonstrating the various features currently supported by this library. Once the library is added to your project, you can include the CustomCalendarView into your activity/fragment layout using the following code snippets.

<com.stacktips.view.CustomCalendarView
	android:id="@+id/calendar_view"
	android:layout_width="match_parent"
	android:layout_height="wrap_content"
	android:background="@color/off_white">
</com.stacktips.view.CustomCalendarView>

The above code snippet will show the simple Calendar View with default design. Now, you can use the following attributes, to customize the appearance of calendar.

<com.stacktips.view.CustomCalendarView
	android:id="@+id/calendar_view"
	android:layout_width="match_parent"
	android:layout_height="wrap_content"
	android:background="@color/off_white"
	app:calendarBackgroundColor="@color/off_white"
	app:calendarTitleTextColor="@color/black"
	app:currentDayOfMonthColor="@color/blue"
	app:dayOfMonthTextColor="@color/black"
	app:dayOfWeekTextColor="@color/black"
	app:disabledDayBackgroundColor="@color/off_white"
	app:disabledDayTextColor="@color/grey"
	app:selectedDayBackgroundColor="@color/blue"
	app:titleLayoutBackgroundColor="@color/white"
	app:weekLayoutBackgroundColor="@color/white">
</com.stacktips.view.CustomCalendarView>

Let us now, initialize the calendar view to control the various other appearance and behavior of calendar using the following methods.

//Initialize CustomCalendarView from layout
calendarView = (CustomCalendarView) findViewById(R.id.calendar_view);

//Initialize calendar with date
Calendar currentCalendar = Calendar.getInstance(Locale.getDefault());

//Show Monday as first date of week
calendarView.setFirstDayOfWeek(Calendar.MONDAY);

//Show/hide overflow days of a month
calendarView.setShowOverflowDate(false);

//call refreshCalendar to update calendar the view
calendarView.refreshCalendar(currentCalendar);

//Handling custom calendar events
calendarView.setCalendarListener(new CalendarListener() {
    @Override
    public void onDateSelected(Date date) {
        SimpleDateFormat df = new SimpleDateFormat("dd-MM-yyyy");
        Toast.makeText(MainActivity.this, df.format(date), Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onMonthChanged(Date date) {
        SimpleDateFormat df = new SimpleDateFormat("MM-yyyy");
        Toast.makeText(MainActivity.this, df.format(date), Toast.LENGTH_SHORT).show();
    }
});

Using Custom TypeFace

//Setting custom font
final Typeface typeface = Typeface.createFromAsset(getAssets(), "fonts/Arch_Rival_Bold.ttf");
if (null != typeface) {
    calendarView.setCustomTypeface(typeface);
    calendarView.refreshCalendar(currentCalendar);
}

Using Day Decorators

Example2: How to Disable Past Dates in CustomCalendarView using Decorators.

//adding calendar day decorators
List decorators = new ArrayList<>();
decorators.add(new ColorDecorator());
calendarView.setDecorators(decorators);
calendarView.refreshCalendar(currentCalendar);

If you enjoy this library, don’t forget to like our Facebook page or follow us on twitter @Stacktips.