Calendar Date Icon
⋯
CalendarDateIcon renders the Figma .Calendar date icon from the Calendar page: a 64px wide tile,
at least 56px tall, with the month on a gray band above the day number. The
Calendar header renders this component for today.
import { CalendarDateIcon } from "@nesra/ui/calendar-date-icon";
export function NextEvent() { return <CalendarDateIcon date="2026-01-10" />;}CalendarDateIcon and CalendarDateIconProps are also exported from @nesra/ui.
Examples
Section titled “Examples”Beside an event
Section titled “Beside an event”import { CalendarDateIcon } from "@nesra/ui/calendar-date-icon";
export function CalendarDateIconBasicExample() { return ( <div className="flex items-center gap-3"> <CalendarDateIcon date="2026-01-10" /> <div className="grid"> <span className="type-nesra-body-large-semibold text-nesra-text-headline"> Quarterly review </span> <span className="type-nesra-body-small-regular text-nesra-text-support"> 10:00 – 11:30 · Room 4 </span> </div> </div> );}Locale
Section titled “Locale”locale formats the month abbreviation and the accessible date with Intl.DateTimeFormat. The
month is shown in uppercase, as in Figma.
import { CalendarDateIcon } from "@nesra/ui/calendar-date-icon";
export function CalendarDateIconLocaleExample() { return ( <div className="flex flex-wrap gap-4"> <CalendarDateIcon date="2026-08-17" /> <CalendarDateIcon date="2026-08-17" locale="id-ID" /> <CalendarDateIcon date="2026-08-17" locale="de-DE" /> </div> );}Figma mapping
Section titled “Figma mapping”| Part | Figma value | CSS |
|---|---|---|
| Tile | 64px wide, min height unit-27 (56px), radius-sm, 1px border |
w-nesra-spacing-7xl min-h-nesra-unit-27 rounded-nesra-sm border-nesra-stroke-border |
| Tile | Surface/popover-bg-neutral |
bg-nesra-surface-popover-bg-neutral |
| Month | Foundation/bg-gray, padding 4 / 8 / 2 / 8, Body/XSmall/Semibold |
bg-nesra-foundation-bg-gray type-nesra-body-xsmall-semibold text-nesra-text-support |
| Day | Body/Large/Bold, Text/text-brand-primary |
type-nesra-body-large-bold text-nesra-text-brand-primary |
All roles have Light and Dark values. The tile was checked in both modes.
The Figma Calendar page also has a Calendar Icon set (Name=Calendar, Clock, Bell, Copy,
Trash, Edit). Those are 16px Icon/icon-muted glyphs, not a package export. Use the Lucide
Calendar, Clock, BellRing, Copy, Trash2, and Pencil icons with text-nesra-icon-muted.
Accessibility
Section titled “Accessibility”- The tile is a
<time>element whosedateTimeis the ISO date. - The month and day text are hidden from assistive technology. A visually hidden full date, such as “January 10, 2026”, is read instead.
- Pass
aria-hidden="true"when nearby text already states the date, as the Calendar header does. - The tile has no built-in text, so it adds no translation keys. Dates come from
locale.
API reference
Section titled “API reference”| Prop | Type | Default | Effect |
|---|---|---|---|
date |
string | Date |
required | Day to show. See the rules below. |
locale |
string |
"en-US" |
BCP 47 locale for the month abbreviation and the accessible date. |
- A string must be an ISO
YYYY-MM-DDdate, as Calendar uses. It is shown as that calendar day in every time zone. - A
Dateshows its local calendar day. - An invalid value, such as
"2026-02-30"or an invalidDate, throws aRangeError.
Native <time> attributes except dateTime and children, className, and refs are forwarded.
The rendered element has data-slot="calendar-date-icon". The month and day spans have
data-calendar-date-icon-month and data-calendar-date-icon-day. See also
layout tokens and typography.