该技能围绕 Syncfusion Flutter 生态中的两个日期相关组件展开：SfCalendar（事件日历）与 SfDateRangePicker（日期范围选择器）。两者在视觉与配置上有诸多共通点，但主要用途不同。
用途与组件选择
当需要展示和管理预约/事件、构建排程类功能（如预订、会议、任务）、使用时间轴视图或日程视图、处理重复事件/时区/资源分配，或需要拖放与预约缩放时，应使用 SfCalendar。
当只需要日期选择而无需管理预约、目标是表单或筛选器的日期/日期范围选择、需要灵活的选择模式（单选、多选、范围、多范围）、或需要确认/取消按钮的选择对话框时，应使用 SfDateRangePicker。
两者的主要差异：SfCalendar 主用于事件排程与展示，支持预约/事件、9 种视图、时间槽、重复事件、时区、资源视图、拖放，但不提供确认/取消按钮；SfDateRangePicker 主用于日期选择，支持 4 种视图（月、年、十年、世纪）、单选/多选/范围/多范围、确认与取消按钮，但不支持事件、时间槽、重复事件、时区与资源视图。
主要能力
SfCalendar：九种日历视图（日、周、工作周、月、日程、时间轴日/周/工作周/月、月议程等）、预约数据源（CalendarDataSource 映射）、全天预约、重复预约与规则、时区支持、特殊时间区域、当前时间指示器、拖放与预约缩放、加载更多预约、资源视图、黑名单日期、min/max 日期限制、视图切换与导航。
SfDateRangePicker：四种视图（月、年、十年、世纪）、多选择器并排视图、单选/多选/范围/多范围/可扩展范围选择模式、编程式选择、动作按钮（确认/取消）、今天按钮、Hijri 日历支持、日期限制与自定义日期校验（selectableDayPredicate）、月/年单元格样式。
两者共同支持：选中项装饰与样式、今日高亮色、单元格边框与背景、主题集成、自定义构建器（月/年单元格等）、onSelectionChanged 与 onViewChanged 回调、首日设置、导航箭头、本地化与 RTL、无障碍（屏幕阅读器、语义标签、键盘导航、焦点指示）。
使用方式
文档按主题分文件组织：快速开始（references/getting-started.md）、组件概览（calendar-overview.md、datepicker-overview.md）、视图与导航（views.md、date-navigations.md）、预约（appointments.md）、选择（selections.md）、定制（customization.md、builders.md）、回调（callbacks.md）、本地化与无障碍（localization.md、accessibility.md）、进阶特性（advanced-features.md）。
基础 SfCalendar 示例使用 CalendarView.month 视图，通过自定义 CalendarDataSource 子类覆写 getStartTime、getEndTime、getSubject、getColor、isAllDay 等方法映射预约对象。基础 SfDateRangePicker 示例设置 selectionMode 为 range，通过 onSelectionChanged 接收 PickerDateRange 并读取 startDate 与 endDate，并可开启 showActionButtons。多选示例通过 initialSelectedDates 预设日期列表，回调中 args.value 返回 DateTime 列表。
常见模式包括：多视图切换（日/周/月/日程）、用于报表的日期范围筛选（配合 onSubmit 与范围选择）、自定义单元格外观（todayHighlightColor、cellBorderColor、selectionDecoration 等）、限制日期选择（minDate/maxDate 与 selectableDayPredicate 禁用周末）。
适用场景
会议排程器（SfCalendar + 日程视图）、事件管理（SfCalendar + 月视图、重复事件、拖放）、预订系统（SfDateRangePicker + 范围选择与日期限制）、报表日期筛选（SfDateRangePicker + 范围/多范围）、任务管理（SfCalendar + 日程视图与全天预约）、休假规划（SfDateRangePicker + 多选与黑名单日期）、资源排程（SfCalendar + 资源视图与时间轴）、简单日期输入（SfDateRangePicker + 单选模式）。
限制
资料未提供各组件的安装命令与包依赖的具体写法、版本信息、收费与价格信息、性能指标及浏览器或平台兼容性细节，这些内容暂未提供。使用前需依据官方文档确认包引入方式与最新 API。