Slint Kit Documentation

Heures et fuseaux

KitZonedDateTimeField

Saisie de date, heure locale et fuseau avec résolution explicite des ambiguïtés.

Saisie de date, heure locale et fuseau avec résolution explicite des ambiguïtés.
Capture native du même exemple, moteur Skia.

Liez les trois textes et traitez resolve-requested(ZonedDateTimeDraft) avec un résolveur de fuseau IANA. Projetez resolution et resolution-message, puis traitez ambiguity-chosen si nécessaire.

ZonedTimePresentation distingue unresolved, unique, ambiguous, nonexistent et invalid-zone. Une ambiguïté propose AmbiguousTimeChoice.earlier ou .later ; aucune occurrence n’est choisie silencieusement.

Voir le code source ↗

Exemple complet

Ce fichier Slint complet présente une composition visuelle et produit la capture ci-dessus. Les textes internes sans propriété de libellé conservent la langue par défaut du kit ; les dialogues système suivent la plateforme. Les états projetés et les signaux qui demandent une décision doivent être raccordés à l’hôte ; cet exemple isolé ne fournit pas ce contrôleur. Configurer le projet Rust, puis consulter l’application avec contrôleurs typés pour relier réellement édition, validation et sélection.

// Public label overrides localize this fixture; toolkit/host defaults keep their language.
// SPDX-License-Identifier: GPL-3.0-or-later
// Display projections are fixtures. Validate accepted domain values in Rust.
import { KitTheme, KitThemes, KitZonedDateTimeField, ZonedTimePresentation } from "@kit/kit.slint";

export component Example inherits Window {
    title: "KitZonedDateTimeField — exemple";
    preferred-width: 480px;
    preferred-height: 390px;
    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: "Champ de date et heure avec fuseau"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitZonedDateTimeField { theme: root.theme; label: "Réunion"; date-text: "2026-10-17"; time-text: "09:30"; zone-text: "America/Toronto"; resolution: ZonedTimePresentation.unique; resolution-message: "UTC−04:00"; }
        if root.status != "": Text { text: root.status; color: root.theme.text-secondary; font-size: 12px * root.theme.text-scale; wrap: word-wrap; }
    }
}

Télécharger cet exemple

API publique

Hérite de Rectangle. Les déclarations suivantes sont extraites des sources du composant. Les propriétés du parent restent disponibles ; les détails de gestion d’état sont décrits dans le guide des contrôleurs.

Propriétés

Nom Type Sens
theme KitTheme in
control-size ControlSize in
access FieldAccess in
accepted-local LocalDateTimeView in
clock-format ClockFormat in
precision TimePrecision in
label string in
date-error string in
time-error string in
zone-error string in
resolution-message string in
resolution ZonedTimePresentation in
date-text string in-out
time-text string in-out
zone-text string in-out

Types et variantes

Les noms ci-dessous utilisent la syntaxe Slint. Les types Rust partagés se trouvent dans slint_kit ; les enums de présentation proviennent des types Rust générés par Slint.

Type Déclaration
enum AmbiguousTimeChoice earlier, later
struct CivilDateView year: int, month: int, day: int
enum ClockFormat twenty-four-hour, twelve-hour
enum ControlSize compact, medium, comfortable
enum FieldAccess editable, read-only, disabled
struct LocalDateTimeView date: CivilDateView, time: LocalTimeView
struct LocalTimeView hour: int, minute: int, second: int
enum TimePrecision minute, second
struct ZonedDateTimeDraft date: string, time: string, zone: string
enum ZonedTimePresentation unresolved, unique, ambiguous, nonexistent, invalid-zone

Signaux

Fonctions