Compose Multiplatform datetime picker implementation featuring highly customizable wheel pickers for date, time, and datetime selection.

Picker	Basic Usage
	WheelDateTimePicker { snappedDateTime -> }
	WheelDatePicker { snappedDate -> }
	WheelTimePicker { snappedTime -> }
	WheelTimePicker(timeFormatter = timeFormatter(timeFormat = TimeFormat.AM_PM)) { snappedTime -> }

• Customizable date order: DMY (Day-Month-Year), MDY (Month-Day-Year), or YMD (Year-Month-Day)
• Hide year picker: Set yearsRange = null to create day-month only or month-day only pickers
• Custom year range: Limit year selection to specific ranges (e.g., next 10 years, last 50 years)
• Multiple month display styles: Full names, short names, or numeric format

• Auto-adapts to locale: Date order and month names automatically match the current locale
• CJK language support: Special handling for Chinese (年/月/日), Japanese (年/月/日), Korean (년/월/일) with customizable year/month/day suffixes
• Localized numerals: Supports Eastern Arabic numerals and other numeral systems
• Script-aware locale matching: A locale is matched first by its language+script subtags, then by language alone, and finally falls back to English. Examples: uz-Arab → uz-Arab (direct script match), uz-Latn → uz (script not bundled, base language used), zh-Hant → zh (same).
• Limitations: BCP 47 -u-* Unicode extension subtags (e.g. -u-nu-* numbering system, -u-ca-* calendar) are ignored — only the language and script subtags influence resolution.

Currently Supported Languages (30): Arabic (العربية), Bengali (বাংলা), Chinese (中文), Czech (Čeština), Danish (Dansk), Dutch (Nederlands), English, Finnish (Suomi), French (Français), German (Deutsch), Greek (Ελληνικά), Hebrew (עברית), Hindi (हिन्दी), Indonesian (Bahasa Indonesia), Italian (Italiano), Japanese (日本語), Korean (한국어), Norwegian (Norsk — nb, no), Persian (فارسی), Polish (Polski), Portuguese (Português), Romanian (Română), Russian (Русский), Spanish (Español), Swedish (Svenska), Thai (ไทย), Turkish (Türkçe), Ukrainian (Українська), Uzbek (Oʻzbekcha / Ўзбекча / اۉزبېکچه — uz, uz-Cyrl, uz-Arab), Vietnamese (Tiếng Việt)

Contributions welcome: If you find any translation errors or want to add support for a new language, please open an issue or submit a pull request.

• Modifier-driven responsive sizing, configurable row count, inactive and selected text styles, and colors
• Customizable selector appearance (shape, color, border)
• Material Design integration

• 12-hour (AM/PM) and 24-hour formats
• Customizable time display

WheelDatePicker(
  startDate = LocalDate(2025, 6, 15),
  yearsRange = null,  // Hides the year picker
  dateFormatter = dateFormatter(
    dateOrder = DateOrder.DMY,
    monthDisplayStyle = MonthDisplayStyle.FULL
  )
) { snappedDate ->
  // snappedDate.month and snappedDate.dayOfMonth
}

WheelDatePicker(
  yearsRange = null,
  dateFormatter = dateFormatter(
    dateOrder = DateOrder.MDY,
    monthDisplayStyle = MonthDisplayStyle.SHORT
  )
) { snappedDate -> }

// Only allow next 10 years
WheelDatePicker(
  yearsRange = IntRange(2025, 2035),
  dateFormatter = dateFormatter(
    dateOrder = DateOrder.YMD
  )
) { snappedDate -> }

// Only allow past 50 years (for birthdate)
val currentYear = Clock.System.now()
  .toLocalDateTime(TimeZone.currentSystemDefault()).year
WheelDatePicker(
  yearsRange = IntRange(currentYear - 50, currentYear),
  dateFormatter = dateFormatter(dateOrder = DateOrder.DMY)
) { snappedDate -> }

WheelDatePicker(
  dateFormatter = dateFormatter(
    locale = Locale("zh"),  // "zh" for Chinese, "ja" for Japanese, "ko" for Korean
    monthDisplayStyle = MonthDisplayStyle.NUMERIC,
    cjkSuffixConfig = CjkSuffixConfig.ShowAll
  )
) { snappedDate -> }

// Without suffixes
WheelDatePicker(
  dateFormatter = dateFormatter(
    locale = Locale("zh"),
    monthDisplayStyle = MonthDisplayStyle.NUMERIC,
    cjkSuffixConfig = CjkSuffixConfig.HideAll
  )
) { snappedDate -> }

WheelDatePicker(
  dateFormatter = dateFormatter(
    dateOrder = DateOrder.DMY,  // or MDY, YMD based on your preference
    monthDisplayStyle = MonthDisplayStyle.NUMERIC
  )
) { snappedDate -> }

WheelDateTimePicker( startDateTime = LocalDateTime( year = 2025, month = 10, day = 20, hour = 5, minute = 30 ), minDateTime = Clock.System .now() .toLocalDateTime(TimeZone.currentSystemDefault()), maxDateTime = LocalDateTime( year = 2025, month = 10, day = 20, hour = 5, minute = 30 ), dateFormatter = dateFormatter( locale = Locale.current, monthDisplayStyle = MonthDisplayStyle.SHORT, cjkSuffixConfig = CjkSuffixConfig.HideAll ), timeFormatter = timeFormatter( timeFormat = TimeFormat.HOUR_24 ), modifier = Modifier.size(200.dp, 100.dp), rowCount = 5, textStyle = MaterialTheme.typography.titleSmall, textColor = Color(0xFFffc300), selectedTextStyle = MaterialTheme.typography.titleSmall.copy( fontWeight = FontWeight.Bold ), selectedTextColor = Color.Black, selectorProperties = WheelPickerDefaults.selectorProperties( enabled = true, shape = RoundedCornerShape(0.dp), color = Color(0xFFf1faee).copy(alpha = 0.2f), border = BorderStroke(2.dp, Color(0xFFf1faee)) ) ) { snappedDateTime -> }

Picker size is controlled entirely through Modifier (since 1.4.0). When the caller does not constrain an axis, the picker supplies its intrinsic default on that axis: 256.dp width for WheelDatePicker/WheelDateTimePicker, 128.dp for WheelTimePicker/WheelTextPicker, and a height of ~42.7.dp per row (rowCount = 3 → exactly 128.dp). Larger rowCounts grow the wheel instead of squeezing rows.

WheelDatePicker { }                                          // intrinsic 256 x 128.dp
WheelDatePicker(rowCount = 5) { }                            // intrinsic height ~213.dp
WheelDatePicker(modifier = Modifier.fillMaxWidth()) { }      // parent width, intrinsic height
WheelDatePicker(modifier = Modifier.height(200.dp)) { }      // fixed height
WheelDatePicker(modifier = Modifier.size(300.dp, 160.dp)) { }        // fixed size
WheelDatePicker(
  modifier = Modifier
    .widthIn(min = 240.dp, max = 400.dp)
    .heightIn(min = 128.dp),
) { }

Standard Compose constraint rules apply: fixed/min/max constraints from the modifier or the parent override or clamp the intrinsic default, and pickers shrink to fit parents narrower than their intrinsic width.

Migrating from size: DpSize (removed in 1.4.0, source-breaking only — hidden 1.3.x overloads keep old binaries linking until the next major release):

// Before
WheelDatePicker(size = DpSize(300.dp, 160.dp)) { }
// After
WheelDatePicker(modifier = Modifier.size(300.dp, 160.dp)) { }

// Before workaround for responsive width
BoxWithConstraints(Modifier.fillMaxWidth()) {
  WheelDatePicker(size = DpSize(maxWidth, 200.dp)) { }
}
// After
WheelDatePicker(modifier = Modifier.fillMaxWidth().height(200.dp)) { }

For rowCount > 3, callers that depended on the old squeezed 128.dp total height should state it explicitly with Modifier.height(128.dp).

Known limitation: the picker resolves its size via subcomposition and does not support intrinsic-measurement parents (IntrinsicSize.Min/Max will throw). Pass an explicit width/height instead.

onSnappedDateChanged vs onSnappedDate

• onSnappedDateChanged is invoked continuously while the user is scrolling, each time a different item snaps into the selector. Useful for live previews, syncing UI, or tracking the in-flight value.
• onSnappedDate is invoked only once after the wheel comes to rest, representing the user's final choice. Use it for committing the selection (saving, navigating, etc.).

The same pattern applies to WheelTimePicker (onSnappedTimeChanged / onSnappedTime) and WheelDateTimePicker (onSnappedDateTimeChanged / onSnappedDateTime).

DateOrder (controls field arrangement):

• DateOrder.DMY - Day, Month, Year (Europe, most of world)
• DateOrder.MDY - Month, Day, Year (US)
• DateOrder.YMD - Year, Month, Day (East Asia, ISO 8601)

MonthDisplayStyle:

• MonthDisplayStyle.FULL - "January", "February", etc.
• MonthDisplayStyle.SHORT - "Jan", "Feb", etc.
• MonthDisplayStyle.NUMERIC - "1", "2", etc.

CjkSuffixConfig (for Chinese/Japanese/Korean):

• CjkSuffixConfig.ShowAll - Shows year/month/day suffixes (Chinese/Japanese: 年/月/日, Korean: 년/월/일)
• CjkSuffixConfig.HideAll - Hides all suffixes
• Custom: CjkSuffixConfig(showYearSuffix = true, showMonthSuffix = false, ...)

TimeFormat:

• TimeFormat.HOUR_24 - 24-hour format (00:00 - 23:59)
• TimeFormat.AM_PM - 12-hour format with AM/PM

Each picker accepts selectedTextStyle / selectedTextColor to style the centered (snapped) item differently from inactive items. By default, they use the same values as textStyle / textColor.

WheelDatePicker(
  textStyle = MaterialTheme.typography.titleMedium,
  textColor = LocalContentColor.current,
  selectedTextStyle = MaterialTheme.typography.titleMedium.copy(fontWeight = FontWeight.Bold),
  selectedTextColor = MaterialTheme.colorScheme.primary,
)

selectedTextColor overrides selectedTextStyle.color, mirroring how Text(color = ...) overrides TextStyle.color in Compose. The same parameters are available on WheelTimePicker, WheelDateTimePicker, and the internal text pickers.

In WheelTimePicker and WheelDateTimePicker, the colon separator sits in the center row next to the selected hour and minute, so it follows selectedTextStyle / selectedTextColor. If you don't set the selected* params (defaults equal textStyle / textColor), the colon is unchanged.

• Add the Maven Central repository if it is not already there:

repositories {
  mavenCentral()
}

• In Compose multiplatform projects, add a dependency to the commonMain source set dependencies:

kotlin {
  sourceSets {
    val commonMain by getting {
      dependencies {
        implementation("io.github.darkokoa:datetime-wheel-picker:<version>")
        implementation("org.jetbrains.kotlinx:kotlinx-datetime:0.8.0")
      }
    }
  }
}

• To use the library in a single-platform project (such as Android project), add a dependency to the dependencies block:

dependencies {
  implementation("io.github.darkokoa:datetime-wheel-picker:<version>")
  implementation("org.jetbrains.kotlinx:kotlinx-datetime:0.8.0")
}

• If your minimum Android platform's API level (minSdk) < 26, please enable Desugaring like this:

compileOptions {
  isCoreLibraryDesugaringEnabled = true
}

//...

dependencies {
  coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.1.5")
}

Released under the Apache License, Version 2.0.

WheelPickerCompose