Slint Kit Documentation

Times and zones

KitTimePicker

Local-time input with explicit adjustment of each segment.

Local-time input with explicit adjustment of each segment.
Native screenshot of the same example, rendered with Skia.

Share the draft and KitTimeField policies, then handle adjust(TimeSegment, TimeAdjustment). The controller applies adjustments to the allowed hours, minutes or seconds.

Buttons emit .increment or .decrement without creating a date or instant. The seconds segment appears with TimePrecision.second.

View source ↗

Complete example

This complete Slint file is a visual composition used to produce the screenshot above. Internal strings without a label property retain the kit’s default language; system dialogs follow the host platform. Projected state and callbacks requesting a decision need host wiring; the standalone fixture does not supply that controller. Set up the Rust project, then see the typed controller application for working editing, validation and selection.

// SPDX-License-Identifier: GPL-3.0-or-later
// Display projections are fixtures. Validate accepted domain values in Rust.
import { KitTheme, KitThemes, KitTimePicker } from "@kit/kit.slint";

export component Example inherits Window {
    title: "KitTimePicker example";
    preferred-width: 620px;
    preferred-height: 300px;
    max-width: 100000px;
    max-height: 100000px;
    background: root.theme.canvas;
    in-out property <KitTheme> theme: KitThemes.light;
    in-out property <string> status;
    VerticalLayout {
        padding: 24px; spacing: 16px; alignment: start;
        Text { text: "Time Picker"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitTimePicker { theme: root.theme; label: "Start time"; text: "09:30"; accepted-time: { hour: 9, minute: 30, second: 0 }; }
        if root.status != "": Text { text: root.status; color: root.theme.text-secondary; font-size: 12px * root.theme.text-scale; wrap: word-wrap; }
    }
}

Download this example

Public API

Inherits Rectangle. The declarations below come from the component source. Parent properties remain available; see the controller guide for state management.

Properties

Name Type Direction
theme KitTheme in
control-size ControlSize in
access FieldAccess in
accepted-time LocalTimeView in
clock-format ClockFormat in
precision TimePrecision in
label string in
error string in
text string in-out

Types and variants

Names below use Slint syntax. Shared Rust domain types live in slint_kit; presentation enums come from the Rust types generated by Slint.

Type Declaration
enum ClockFormat twenty-four-hour, twelve-hour
enum ControlSize compact, medium, comfortable
enum FieldAccess editable, read-only, disabled
struct LocalTimeView hour: int, minute: int, second: int
enum TimeAdjustment increment, decrement
enum TimePrecision minute, second
enum TimeSegment hour, minute, second

Callbacks

Functions