Skip to main content
161

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
Android docs
FormsAndroid

Date range field

Select an inclusive native date range with coordinated bounds and validation context.

Public APILumenDateRangeFieldAndroid / Compose

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.

Date range field rendered in the Android phone emulator Lumen playground
Verified runtime captureAndroid phone emulator
kotlin
LumenDateRangeField(
    label = "Release window",
    value = releaseRange,
    onValueChange = { releaseRange = it },
    minDateMillis = todayUtcMillis,
    description = "Choose when this release is available."
)

Reference

Public API

The primary shared and platform-specific options exposed by LumenDateRangeField.

APIValues or typeDefaultDescription
labelStringRequiredLabels the inclusive date range.
value / onValueChangeLumenDateRangeSelection / callbackRequiredStores the controlled start and end values.
minDateMillis / maxDateMillisLong?nullConstrains both dates using the native picker contract.
description / errorMessageString?nullShows supporting text or a semantic danger validation message.

Native behavior

Design and accessibility

When to use it

Use for an inclusive native date range. Keep values controlled and provide product-specific validation copy when additional rules apply.

Accessibility

The range and each native control remain labeled, and selection prevents an end date from preceding its start.

Shared component

Available on other platforms

React NativeApple / SwiftUI
Android docsCompose module