Updated: October 18, 2018




The Calendar View provides a visual overview of a week, a month, or multiple months.



  • Use Calendar View to display a visual overview of a week, a month, multiple months, or a range of selected dates.
  • Use Calendar View to visually present correlations between two dates. For instance: consecutive holidays, flight ticket prices in peak season versus off season, hotel room availabilities.


  • Don’t use Calendar View when text-based / list-based components (such as Pickers) can fulfill your primary requirement.


The structure is composed of four parts: Calendar View Container, Week Label Container, Date Cell Container, and Month Label.

Inside a Calendar View Container, there is a Week Label Container on the top, and a Date Cell Container on the bottom. Month Label sits in Navigation Bar as Navigation Bar Title.

The space below Calendar View is available for different configurations. For instance: using Object Cells as an agenda or Timeline as a timesheet.

A.  Calendar View Container

B.  Week Label Container

C.  Date Cell Container

D.  Month Label (as Navigation Bar Title)


Each container has its own attributes:

A.  Calendar View Container

It provides four types of Calendar View. You may choose the one that fits the purpose of your app and start designing from there.


• Types:

1. Month View (Default)

2. Week View

3. Expandable View

4. Multiple Selection View

B.  Week Label Container

It provides three standards of First Day of Week configurations. The Week Label of today will be highlighted with Dark Tint color.


• Types:

1. Start with Sunday (Default) – US Standard

2. Start with Monday – Europe, Asia, Oceania Standard

3. Start with Saturday – Middle East Standard

C.  Date Cell Container

It provides two types of Date Cell: Number Only and Number with Indicator. The two types cannot be mixed.

For instance, if your app is currently configured with the Number Only type and you want it to display Indicator of the day, please reconfigure your app with the Number with Indicator type.


• Types:

1. Number with Indicator (Default)

2. Number Only

D.  Month Label

It provides two types of Month Label: one-line and two-line. It uses three-letter, title-case abbreviation. For instance: Jan, Feb, Mar.


• Types:

1. Single Title (Default)

2. Double Title

Interactions & Behaviors

Each View type has its own defined interaction:

1. Month View (Default)

  • Vertical Scrolling

2. Week View

  • Horizontal Scrolling

3. Expandable View

  • Horizontal Scrolling
  • Agenda Container can be pulled down and pulled up

4. Multiple Selection View

  • Vertical Scrolling


Here are some examples of designing with the Calendar View:

The most basic one is to use the Calendar View as a schedule or calendar.

The components used in this example:

You may also make a timesheet with the Calendar View.

The components used in this example:

You also could make a date selection modal with the Calendar View.

The components used in this example:

  • Calendar View – Multiple Selection View
  • Cell Button

Compact & Regular

The layouts on iPhone 8, iPhone 8 Plus, iPhone X, iPhone SE; iPad and iPad Pro have been configured with the following guidelines, by default:

  • The height of Date Cell stays the same across all devices. That being said, the height of Calendar View Container also stays the same across all devices.
  • If the device is iPhone 8, iPhone 8 Plus, iPhone X, iPhone SE: the width of Calendar View Container is the width of device screen.
  • If the device is iPad and iPad Pro: the width of Calendar View Container is the width of device screen minus UIEdgeInsets.

Compact View

• iPhone 8 (375×667)

• iPhone 8 Plus (414×736)

• iPhone X (375×812)

• iPhone SE (320×568)

Regular View

• iPad (768×1024)

• iPad Pro (1024×1366)