syncfusion-maui-date-time-range-selector

$npx mdskill add syncfusion/maui-ui-components-skills/syncfusion-maui-date-time-range-selector

Implement interactive date/time range selection with chart integration.

  • Users need to select date/time ranges for filtering time-series data.
  • Depends on Syncfusion .NET MAUI SfDateTimeRangeSelector control.
  • Configures range limits, initial values, and chart binding based on requirements.
  • Renders a slider UI that updates chart data range in real time.

SKILL.md

.github/skills/syncfusion-maui-date-time-range-selectorView on GitHub ↗
---
name: syncfusion-maui-date-time-range-selector
description: Implements Syncfusion .NET MAUI DateTime Range Selector (SfDateTimeRangeSelector) for interactive date/time range selection with chart integration. Use when working with range selectors, date range pickers, time range selection, chart range filtering, or interactive range controls. Covers range selection UI, filtering chart data by date range, and selecting time periods.
metadata:
  author: "Syncfusion Inc"
  version: "34.1.29"
---

# Implementing .NET MAUI Date Time Range Selector

The Syncfusion .NET MAUI Date Time Range Selector (`SfDateTimeRangeSelector`) is a highly interactive UI control that enables users to select a range of DateTime values within specified minimum and maximum limits. It's designed to work seamlessly with charts and other visual content, providing an intuitive way to filter and explore time-based data.

## When to Use This Skill

Use this skill when user need to:

- **Implement date/time range selection** - Allow users to select a date or time range
- **Filter chart data interactively** - Enable users to zoom or filter charts by selecting time periods
- **Create time period selectors** - Build UI for selecting quarters, months, weeks, or custom periods
- **Add range sliders for dates** - Implement slider controls that work with DateTime values
- **Build data exploration tools** - Create interactive controls for analyzing time-series data
- **Customize range selector appearance** - Style labels, ticks, thumbs, tracks, and regions
- **Handle range selection events** - Respond to user interactions with range changes
- **Integrate with charts** - Embed Syncfusion Charts or other content within the range selector

## Component Overview

- DateTime range selection with draggable thumbs
- Chart content integration for data visualization
- Customizable labels, ticks, and dividers
- Discrete selection with step intervals
- Tooltip support with custom formatting
- Rich styling options for all visual elements
- Region highlighting (active/inactive areas)
- Multiple drag behaviors
- Event-driven architecture with commands
- Liquid Glass effect for modern UI (iOS 26+, macOS 26+)

## Documentation and Navigation Guide

### Getting Started
📄 **Read:** [references/getting-started.md](references/getting-started.md)
- NuGet package installation (`Syncfusion.Maui.Sliders`)
- Handler registration (`ConfigureSyncfusionCore`)
- Basic DateTime Range Selector implementation
- Adding chart content
- Minimum, Maximum, RangeStart, RangeEnd configuration

### Interval and Formatting
📄 **Read:** [references/interval-and-formatting.md](references/interval-and-formatting.md)
- Date interval configuration (`Interval`, `IntervalType`)
- Interval types (Years, Months, Days, Hours, Minutes, Seconds)
- Auto interval calculation
- Date format patterns (`DateFormat` property)
- Custom interval scenarios

### Labels Configuration
📄 **Read:** [references/labels.md](references/labels.md)
- Enabling labels (`ShowLabels`)
- Date format customization
- Label placement (`LabelsPlacement`: OnTicks, BetweenTicks)
- Edge labels placement (`EdgeLabelsPlacement`)
- Label styling (colors, fonts, sizes for active/inactive)
- Label offset customization
- Custom label text via `LabelCreated` event

### Ticks and Dividers
📄 **Read:** [references/ticks-and-dividers.md](references/ticks-and-dividers.md)
- Major ticks configuration (`ShowTicks`)
- Minor ticks (`MinorTicksPerInterval`)
- Tick styling (colors, sizes, offsets)
- Dividers display (`ShowDividers`)
- Divider customization (radius, colors, strokes)
- Active/inactive tick states

### Track and Regions
📄 **Read:** [references/track-and-regions.md](references/track-and-regions.md)
- Track properties (Minimum, Maximum, range values)
- Track color customization (active/inactive)
- Track height (`ActiveSize`, `InactiveSize`)
- Track extent configuration
- Region fill and stroke colors
- Region stroke thickness
- Active/inactive region differentiation

### Thumb and Overlay
📄 **Read:** [references/thumb-and-overlay.md](references/thumb-and-overlay.md)
- Thumb size configuration (`Radius`)
- Thumb fill and stroke colors
- Thumb overlap handling (`OverlapStroke`)
- Thumb overlay customization
- Overlay size and colors
- Interactive visual feedback

### Tooltips
📄 **Read:** [references/tooltip.md](references/tooltip.md)
- Enabling tooltips
- ShowAlways mode for persistent display
- Tooltip styling (fill, stroke, padding)
- Text customization (color, font, size)
- Date format in tooltips
- Custom tooltip text via `TooltipLabelCreated` event

### Selection and Interaction
📄 **Read:** [references/selection-and-interaction.md](references/selection-and-interaction.md)
- Discrete selection (`StepDuration`)
- Interval selection mode (`EnableIntervalSelection`)
- Drag behaviors (OnThumb, BetweenThumbs, Both)
- Deferred updates (`EnableDeferredUpdate`, `DeferredUpdateDelay`)
- Touch and mouse interaction
- IsInversed property

### Events and Commands
📄 **Read:** [references/events-and-commands.md](references/events-and-commands.md)
- ValueChangeStart/End events
- ValueChanging event with `DateTimeRangeSelectorValueChangingEventArgs`
- ValueChanged event with `DateTimeRangeSelectorValueChangedEventArgs`
- LabelCreated and TooltipLabelCreated events
- DragStartedCommand and DragCompletedCommand
- Command parameters
- MVVM pattern implementation

### Advanced: Liquid Glass Effect
📄 **Read:** [references/liquid-glass-effect.md](references/liquid-glass-effect.md)
- Modern translucent glass-like UI effect
- `EnableLiquidGlassEffect` property
- Platform requirements (.NET 10, iOS 26+, macOS 26+)
- Visual design principles
- Implementation examples

More from syncfusion/maui-ui-components-skills

SkillDescription
syncfusion-maui-accordionImplements Syncfusion .NET MAUI Accordion (SfAccordion) - a vertically collapsible panel with stacked headers for expanding/collapsing content. Use when working with accordions, collapsible panels, expandable lists, employee lists with details, or FAQ sections in .NET MAUI applications. Covers AccordionItem configuration, expand modes, and grouped content display.
syncfusion-maui-ai-assistviewImplements Syncfusion .NET MAUI AI AssistView (SfAIAssistView) for AI-powered interactive chat interfaces. Use when working with AI chat interfaces, AI AssistView, SfAIAssistView, conversational UI, or chat with AI responses. Covers integrating AI services, creating chat UIs, implementing conversation flows, managing AI requests/responses, and displaying AI suggestions.
syncfusion-maui-autocompleteImplements and configure Syncfusion .NET MAUI Autocomplete (SfAutocomplete) control for intelligent text input with suggestions. Use when implementing autocomplete, autosuggest, type-ahead search, smart search, or filtered dropdowns in .NET MAUI applications. Covers data binding, filtering modes, custom search logic, AI-powered search, multi-selection with tokens, and UI customization.
syncfusion-maui-avatar-viewImplements Syncfusion .NET MAUI Avatar View (SfAvatarView) for displaying user profile pictures, initials, or group avatars. Use when working with avatar views, profile pictures, user images, initials display, profile icons, or contact images. Ideal for implementing user profile displays, contact lists, chat interfaces, or social feeds.
syncfusion-maui-backdropImplements Syncfusion .NET MAUI Backdrop Page (SfBackdropPage) with back layer and front layer surfaces. Use when working with backdrop pages, SfBackdropPage, back layer, front layer, or reveal/conceal animations. Covers backdrop navigation patterns, header icons, corner shapes, reveal height, layer state events, and liquid glass effect.
syncfusion-maui-badge-viewImplements Syncfusion .NET MAUI Badge View (SfBadgeView) control. Use when adding badge notifications, status indicators, unread counts, or notification overlays to MAUI applications. Covers SfBadgeView setup, badge text customization, position adjustments, animations, predefined symbols, and accessibility features.
syncfusion-maui-barcode-generatorImplements Syncfusion .NET MAUI Barcode Generator (SfBarcodeGenerator) for generating machine-readable barcodes. Use when working with barcodes, barcode generation, QR codes, data matrix, EAN codes, UPC codes, Code128, or Code39. This skill covers both one-dimensional (linear) and two-dimensional (matrix) barcode symbologies with extensive customization options.
syncfusion-maui-busy-indicatorImplements Syncfusion .NET MAUI Busy Indicator (SfBusyIndicator) for showing loading states, data processing, and app activity indicators. Use when displaying loading indicators, busy animations, activity spinners, or processing feedback in .NET MAUI apps. Covers busy indicator setup, animations, and visual feedback during long-running operations.
syncfusion-maui-buttonImplements and customize Syncfusion .NET MAUI Button (SfButton) control. Use when working with MAUI buttons, SfButton implementation, button customization, or visual states. Covers button icons, background images, RTL support, Liquid Glass effects, custom button views, button styling, events, and checkable buttons.
syncfusion-maui-calendarImplements and customize Syncfusion .NET MAUI Calendar (SfCalendar) control. Use when implementing calendar functionality, date selection (single, multiple, range), or calendar views (month, year, decade, century). Covers date restrictions (min/max dates, EnablePastDates, SelectableDayPredicate), calendar customization, events (ViewChanged, SelectionChanged, Tapped), and header/footer customization.