When to use it
Use for an inclusive native date range. Keep values controlled and provide product-specific validation copy when additional rules apply.
FormsApple
Date range field
Select an inclusive native date range with coordinated bounds and validation context.
Apple availability
Supported native targets
Import LumenUI in the target that uses this component. iPad support follows the iOS package baseline and uses native iPad layout behavior.
iPhone · iOS 16+iPad · iPadOS 16+Mac · macOS 13+Apple Vision · visionOS 1+
Native example
Use Date range field
Use for an inclusive native date range. Keep values controlled and provide product-specific validation copy when additional rules apply.
LumenDateRangeField(
"Release window",
start: $releaseStart,
end: $releaseEnd,
bounds: .from(.now),
description: "Choose when this release is available."
)Reference
Public API
The primary shared and platform-specific options exposed by LumenDateRangeField.
| API | Values or type | Default | Description |
|---|---|---|---|
| title | LocalizedStringKey | Required | Labels the inclusive date range. |
| start / end | Binding<Date> pair | Required | Stores the controlled start and end values. |
| bounds | unbounded · closed · from · through | unbounded | Constrains both dates using the native picker contract. |
| description / errorMessage | LocalizedStringKey? | nil | Shows supporting text or a semantic danger validation message. |
Native behavior
Design and accessibility
Accessibility
The range and each native control remain labeled, and selection prevents an end date from preceding its start.
Shared component