Calendar

The Calendar tool opens a full month grid inside the keyboard, not just a today list: browse any month, and up to two non-Gregorian calendars ride alongside the Gregorian dates in the header and inside each day cell. Tap a day to see its date across every calendar you’ve picked, plus whatever’s on your device calendar for that day.

Screenshot pending

The Calendar panel: month grid with Bengali day numbers, today's events listed below.

Browsing the month

Open Calendar from the toolbar (or the toolbox if you haven’t pinned it). The < and > arrows step a month at a time; a Today chip appears next to the month label whenever you’ve navigated away from the current month, and tapping it jumps straight back and reselects today. The weekday row along the top tints your weekend in the accent color — which days those are is a setting, started off from your phone’s region (see Options).

Tapping a day cell doesn’t leave the panel: it just updates the summary and event list below the grid. Today’s cell gets an accent-colored outline; the day you’ve selected gets a filled pill. If either of your two chosen calendars has day numbers that don’t line up one-to-one with the Gregorian grid, its day number rides inside the cell as a small second number next to the Gregorian one; Bengali dates render in Bengali numerals (০–৯), and the first day of a Chinese lunar month shows the month name instead of a bare “1”, since that’s the only cue in the grid that a lunar month just turned over.

Below the grid, the selected day shows its full Gregorian date, weekday, a relative label (Today, Tomorrow, Yesterday, “in N days,” or “N days ago”), and then the same date in whichever alternate calendars you’ve picked.

Today’s events

The bottom of the panel reads events straight from your device calendar for whichever day is selected. Until you grant calendar access, it shows a one-line prompt with an Allow button instead of any event data. Once granted, it queries in the background every time you change the selected day: a blank area while loading, “No events” if the day is clear, or a scrolling list of event cards otherwise.

Each event card shows a colored stripe down the left edge (the calendar’s own display color, or the accent color if the calendar doesn’t provide one), followed by the title, then the time. All-day events show “All day” instead of a clock time, and an event with a location appends it after the time. Recurring events are expanded per occurrence, so a weekly meeting shows up on every day it actually lands on rather than only its first occurrence.

Screenshot pending

A day with events: colored stripe per calendar, time, and location.

Calendar permission

The keyboard only asks for calendar access the first time you tap Allow in the panel, never at install or first launch. Because an on-screen keyboard service can’t request runtime permissions directly, tapping Allow briefly opens an invisible trampoline activity that shows the system permission dialog and closes itself the instant you answer; the same pattern the camera tool uses for its own permission. If you revoke calendar access in system Settings and come back to the keyboard, the panel notices as soon as it regains focus and drops back to the Allow prompt.

Access is read-only in both directions: the tool only ever issues a read query against the calendar provider and has no code path that inserts, edits, or deletes anything on your calendar.

Not available before you unlock

Calendar is left out of the keyboard’s direct-boot-safe tool set, because it has to query a content provider that isn’t available before your first unlock after a restart. If you open the toolbox on a still-locked device, Calendar won’t work there yet: the arithmetic-only tools (sensors, calculators, the built-in clock tools) keep working, but anything that reads the calendar provider doesn’t.

Options

WM Keyboard›Tools›Calendar

• First calendar — default depends on your phone’s region: the Bengali calendar in Bangladesh, era years in Japan, Hindu (Saka) in India, Hijri across much of the Arab world, and None where no second calendar is in common use. Choose from Bengali, Hijri, Chinese, Hebrew, Hindu (Saka), Persian (Solar Hijri), Buddhist (Thai solar), Japanese (era years), or None. Its day number is the one that also shows up inside each day cell, unless it’s Buddhist or Japanese (whose days line up one-to-one with Gregorian, so there’s nothing extra to show), in which case the cell falls back to Second calendar’s day number if that one has its own.
• Second calendar — same nine choices, also region-defaulted (Hijri alongside the Bengali calendar in Bangladesh, the Chinese calendar alongside Japanese era years, None in most places); shown in the month header and under the selected day, alongside First calendar.
• Weekend — which weekday initials the month grid tints. Seven presets: Saturday & Sunday, Friday & Saturday, Thursday & Friday, Friday, Saturday, Sunday, or no weekend at all. The default comes from your phone’s region — Friday and Saturday across much of the Middle East, Friday in Bangladesh, Thursday and Friday in Iran, Saturday in Nepal, Saturday and Sunday most other places.
• Hijri day adjustment — a slider from −2 to +2 days, default 0. Only appears when First or Second calendar is set to Hijri. The tool computes Hijri dates with the tabular (arithmetic) calendar rather than real moon sighting, so real Islamic months can start a day or two off from the tables; use this to match your local authority’s sighting-based calendar.

Accuracy varies by calendar: Chinese dates are computed astronomically (real new-moon and solar-longitude calculations), so they’re exact for the modern era. Hebrew, Persian, Hindu (Saka), Buddhist, and Japanese are all exact arithmetic conversions. Hijri is the only one that’s an approximation, which is why it’s the only one with an adjustment slider.

The same First calendar / Second calendar / Weekend pickers also appear on the first-run setup page during onboarding, if you’ve kept Calendar enabled: anything you set there is the same setting, just asked up front. All three already open on the region’s guess, so that page is where you see it and correct it.

Calendar options: the two calendar pickers, the weekend picker, and the Hijri day adjustment slider.

Details & edge cases

• Calendar has no text-insertion path of its own: tapping a day only changes what the panel displays. There’s no way to insert a date from any of the eight calendar systems into your text field; the tool is a viewer, not a picker.
• Calendar isn’t pinned to the toolbar out of the box, and it’s only in the “show me everything” starter set that setup lands, not the minimal or the recommended one. Pick either of those two simpler answers and Calendar starts switched off, so you’ll want to turn it on yourself under Settings → Tools.
• Reopening Calendar from the toolbar while the panel is already open closes it, same as most other panel tools.
• The region defaults are a guess, and only ever a starting one. They come from the same permission-free signals as suggested languages — the SIM’s country, then the network’s, then your locale’s region — and are consulted only until you pick something. Once you have, your pick is what sticks, wherever the phone travels.
• Nothing about the Calendar tool touches the network; see network policy for what does.