Forms

Date range picker

Choose a start and an end day: two months at a glance, with quick picks for common spans.

Installation

npx sinaui add date-range-picker

Examples

With quick picks

Choose the first day, then the last; the span follows the pointer in between.

Study leave

No dates chosen yet.

<script lang="ts">
	import { endOfMonth, getLocalTimeZone, startOfMonth, today } from '@internationalized/date';
	import type { DateRange } from '#lib/ui/Calendar.svelte';
	import DateRangePicker from '#lib/ui/DateRangePicker.svelte';

	const now = today(getLocalTimeZone());
	const next = startOfMonth(now).add({ months: 1 });
	const presets = [
		{ label: 'Next 7 days', start: now, end: now.add({ days: 6 }) },
		{ label: 'Next 30 days', start: now, end: now.add({ days: 29 }) },
		{ label: 'Rest of this month', start: now, end: endOfMonth(now) },
		{ label: 'Next month', start: next, end: endOfMonth(next) }
	];
	let leave = $state<DateRange>();
	const nights = $derived(leave && leave.end.compare(leave.start));
</script>

<div class="stack">
	<DateRangePicker label="Study leave" bind:value={leave} {presets} min={now} />
	<p>
		{#if leave}{new Intl.PluralRules('en').select(nights!) === 'one'
				? '1 night'
				: `${nights} nights`} away from the House of Wisdom.{:else}No dates chosen yet.{/if}
	</p>
</div>

<style>
	.stack {
		display: grid;
		gap: 0.75rem;
		inline-size: min(100%, 22rem);
	}
	p {
		margin: 0;
		color: var(--ui-muted);
		font-size: 0.875rem;
		font-variant-numeric: tabular-nums;
	}
</style>

Closed days

A range can't run across a day that's unavailable, so days beyond the next closed one can't end it.

Reading room booking

The reading room is closed on Fridays.

<script lang="ts">
	import {
		getDayOfWeek,
		getLocalTimeZone,
		today,
		type CalendarDate
	} from '@internationalized/date';
	import type { DateRange } from '#lib/ui/Calendar.svelte';
	import DateRangePicker from '#lib/ui/DateRangePicker.svelte';

	// Closed on Fridays: a booking can't run across one.
	const closed = (d: CalendarDate) => getDayOfWeek(d, 'en-GB') === 4;
	let booking = $state<DateRange>();
</script>

<div class="stack">
	<DateRangePicker
		label="Reading room booking"
		bind:value={booking}
		isUnavailable={closed}
		min={today(getLocalTimeZone())}
		hint="The reading room is closed on Fridays."
		startName="from"
		endName="to"
	/>
</div>

<style>
	.stack {
		inline-size: min(100%, 22rem);
	}
</style>

On the page

The calendar on its own, in range mode, showing two months.

October 2026

SMTWTFS

November 2026

SMTWTFS

October 4 – 16, 2026

<script lang="ts">
	import { getLocalTimeZone, today } from '@internationalized/date';
	import Calendar, { type DateRange } from '#lib/ui/Calendar.svelte';

	const start = today(getLocalTimeZone()).add({ days: 3 });
	let voyage = $state<DateRange>({ start, end: start.add({ days: 12 }) });
	const fmt = new Intl.DateTimeFormat('en', { dateStyle: 'long' });
	const tz = getLocalTimeZone();
</script>

<div class="stack">
	<Calendar label="Voyage from Basra" mode="range" months={2} bind:range={voyage} />
	<p>{fmt.formatRange(voyage.start.toDate(tz), voyage.end.toDate(tz))}</p>
</div>

<style>
	.stack {
		display: grid;
		grid-template-columns: minmax(0, 1fr);
		gap: 0.75rem;
	}
	p {
		margin: 0;
		color: var(--ui-muted);
		font-size: 0.875rem;
		font-variant-numeric: tabular-nums;
	}
</style>

Props

PropTypeDefault
labelstring (required)
value{ start, end }, bindable
presets{ label, start, end }[]
monthsnumber2
min, maxCalendarDate
isUnavailable(date) => boolean
startName, endNamestring: hidden inputs for forms
localestring'en'
calendarstring | CustomCalendar'gregory'
hint, errorstring
disabledbooleanfalse

Keyboard

KeyDoes
Arrow keysMove by day or week, across into the next month
Page Up / Page DownPrevious or next month (with Shift, year)
Enter / SpaceChoose the start, then the end
EscapeDrop a half-chosen range; press again to close

Accessibility

  • Each month is a grid; every day in the range is marked selected.
  • After the first day, screen readers hear that it’s the start and that the end comes next; once both are chosen, the whole range is read out.
  • The popover opens on the chosen start day (or today), ready for the arrow keys.
Introduction
Theming
Changelog
Button
Action button
Confirm button
Copy button
Hold to confirm
Split button
Calendar
Checkbox
Color picker
Combobox
Date picker
Date range picker
File drop
Form
Input
Mention input
Multi select
Number field
OTP input
Password input
Phone input
Radio cards
Radio group
Rich text editor
Search field
Segmented control
Select
Signature pad
Slider
Switch
Tag input
Upload
Wheel picker
Textarea
Time field
Toggle group
Toolbar
Alert dialog
Command palette
Context menu
Dialog
Drawer
Dropdown
Hover card
Popover
Tooltip
Announcement bar
Alert
Empty state
Meter
Progress
Rolling number
Skeleton
Spinner
Toast
Avatar
Avatar group
Badge
Card
Carousel
Chart
Chat
Code block
Data table
Folder
Kbd
Mind map
Resizable panels
Scroll area
Separator
Sortable
Table
Tag group
Virtual list
Audio player
Image
Image compare
Video
Visualizer
Breadcrumb
File tree
Menubar
Navigation menu
Pagination
Sidebar layout
Stepper
Tabs
Alarm clock
Clock
Dynamic island
Fluid orb
Hourglass
Stopwatch
Timer
AI chat
AI media
Auth
Board
Booking
Dashboard
File explorer
Messaging
Notifications
Settings
Team
Overview
Pricing
Agent chat
Calendar
Voice agent
Mail inbox
CMS
Blog
Marketing site
E-commerce
AI agents
SaaS landing page
SaaS app
Accordion
Dark theme
Light theme