Need help with android-times-square?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

4.4K Stars 1.2K Forks Apache License 2.0 339 Commits 40 Opened issues


Standalone Android widget for picking a single date from a calendar view.

Services available


Need anything else?

Contributors list

TimesSquare for Android

Standalone Android widget for picking a single date from a calendar view.




in your layout XML.

This is a fairly large control so it is wise to give it ample space in your layout. On small devices it is recommended to use a dialog, full-screen fragment, or dedicated activity. On larger devices like tablets, displaying full-screen is not recommended. A fragment occupying part of the layout or a dialog is a better choice.

In the

of your activity/dialog or the
of your fragment, initialize the view with a range of valid dates as well as the currently selected date.
Calendar nextYear = Calendar.getInstance();
nextYear.add(Calendar.YEAR, 1);

CalendarPickerView calendar = (CalendarPickerView) findViewById(; Date today = new Date(); calendar.init(today, nextYear.getTime()) .withSelectedDate(today);

The default mode of the view is to have one selectable date. If you want the user to be able to select multiple dates or a date range, use the inMode() method:

calendar.init(today, nextYear.getTime())


The latest version can be downloaded in zip and referenced by your application as a library project.

You can also depend on the library through Maven:



or Gradle:
compile 'com.squareup:android-times-square:[email protected]'

Snapshots of the development version are available in Sonatype's



Copyright 2012 Square, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.