Selektory czasu

Selektory czasu umożliwiają użytkownikom wybór godziny. Możesz użyć komponentów TimePicker i TimeInput, aby zaimplementować w aplikacji selektor czasu.

Typy

Wyróżniamy 2 rodzaje selektorów czasu:

• Pokrętło: umożliwia użytkownikom ustawienie czasu przez przesuwanie uchwytu po pokrętle.
• Wprowadzanie: umożliwia użytkownikom ustawienie czasu za pomocą klawiatury.

Na ilustracji poniżej po lewej stronie widać selektor czasu z pokrętłem, a po prawej – selektor czasu z polem wpisywania:

Powierzchnia interfejsu API

Aby zaimplementować selektor czasu, użyj funkcji kompozycyjnej TimePicker lub TimeInput:

• TimePicker: implementuje selektor czasu wybierania.
• TimeInput: implementuje selektor czasu.

Województwo

W przypadku obu wartości TimePicker i TimeInput musisz też przekazać wartość TimePickerState. Umożliwia to ustawienie domyślnego wybranego czasu, który pojawia się w selektorze. Rejestruje też czas wybrany przez użytkownika za pomocą selektora.

Dialog

Okna wyboru czasu pojawiają się w oknach dialogowych. Przykłady w tym przewodniku nie korzystają z okien. Przykłady, w których używane są okna, znajdziesz w przewodniku Okna do wyboru czasu.

Selektor godziny

Ten fragment kodu pokazuje, jak wdrożyć podstawowy selektor czasu z wybieraniem za pomocą pokrętła.

@Composable
fun DialExample(
    onConfirm: () -> Unit,
    onDismiss: () -> Unit,
) {
    val currentTime = Calendar.getInstance()

    val timePickerState = rememberTimePickerState(
        initialHour = currentTime.get(Calendar.HOUR_OF_DAY),
        initialMinute = currentTime.get(Calendar.MINUTE),
        is24Hour = true,
    )

    Column {
        TimePicker(
            state = timePickerState,
        )
        Button(onClick = onDismiss) {
            Text("Dismiss picker")
        }
        Button(onClick = onConfirm) {
            Text("Confirm selection")
        }
    }
}
TimePickers.kt

Zwróć uwagę na te elementy w tym fragmencie kodu:

• Calendar.getInstance() inicjuje TimePickerState bieżącym czasem.
  • W tym przykładzie użyto metody java.util.Calendar. Włącz w projekcie odcukrzanie interfejsu API Java 8+, aby alternatywnie używać java.time.LocalTime we wszystkich wersjach Androida.
• Funkcja kompozycyjna TimePicker wyświetla selektor czasu, przyjmując jako parametr wartość timePickerState.
• Implementacja obejmuje 2 przyciski: jeden do potwierdzania wyboru, a drugi do zamykania selektora.

Ta implementacja wygląda tak:

Selektor godziny

Ten fragment kodu pokazuje, jak wdrożyć podstawowy selektor czasu w stylu pola wejściowego.

@Composable
fun InputExample(
    onConfirm: () -> Unit,
    onDismiss: () -> Unit,
) {
    val currentTime = Calendar.getInstance()

    val timePickerState = rememberTimePickerState(
        initialHour = currentTime.get(Calendar.HOUR_OF_DAY),
        initialMinute = currentTime.get(Calendar.MINUTE),
        is24Hour = true,
    )

    Column {
        TimeInput(
            state = timePickerState,
        )
        Button(onClick = onDismiss) {
            Text("Dismiss picker")
        }
        Button(onClick = onConfirm) {
            Text("Confirm selection")
        }
    }
}
TimePickers.kt

Najważniejsze kwestie dotyczące tej implementacji:

• Struktura jest zasadniczo taka sama jak w przypadku selektora czasu w formie tarczy, z tą różnicą, że zamiast TimePicker używa się TimeInput.
• Parametr is24Hour zdarzenia timePickerState jest wyraźnie ustawiony na true. Domyślnie ta wartość wynosi false.

Ta implementacja wygląda tak:

Używanie stanu

Aby wykorzystać czas wybrany przez użytkownika w selektorze czasu, przekaż odpowiedni element TimePickerState do funkcji onConfirm. Komponent kompozycyjny elementu nadrzędnego może uzyskać dostęp do wybranego czasu za pomocą funkcji TimePickerState.hour i TimePickerState.minute.

Poniższy fragment kodu pokazuje, jak to zrobić:

@Composable
fun DialUseStateExample(
    onConfirm: (TimePickerState) -> Unit,
    onDismiss: () -> Unit,
) {
    val currentTime = Calendar.getInstance()

    val timePickerState = rememberTimePickerState(
        initialHour = currentTime.get(Calendar.HOUR_OF_DAY),
        initialMinute = currentTime.get(Calendar.MINUTE),
        is24Hour = true,
    )

    Column {
        TimePicker(
            state = timePickerState,
        )
        Button(onClick = onDismiss) {
            Text("Dismiss picker")
        }
        Button(onClick = { onConfirm(timePickerState) }) {
            Text("Confirm selection")
        }
    }
}
TimePickers.kt

Kompozycję możesz wywołać w ten sposób:

var selectedTime: TimePickerState? by remember { mutableStateOf(null) }

// ...

DialUseStateExample(
    onDismiss = {
        showDialExample = false
    },
    onConfirm = {
            time ->
        selectedTime = time
        showDialExample = false
    },
)

// ...

if (selectedTime != null) {
    val cal = Calendar.getInstance()
    cal.set(Calendar.HOUR_OF_DAY, selectedTime!!.hour)
    cal.set(Calendar.MINUTE, selectedTime!!.minute)
    cal.isLenient = false
    Text("Selected time = ${formatter.format(cal.time)}")
} else {
    Text("No time selected.")
}

Więcej informacji znajdziesz w pełnej implementacji w aplikacji z fragmentami kodu.

Dodatkowe materiały

• TimePicker
• Material Design – selektory czasu