如何为TimePickerDialog设置30分钟间隔的时间选项？

需求：使用TimePickerDialog时，仅显示00:30、1:00、1:30、2:00这类从00:30开始、间隔30分钟的时间选项，是否可以实现？

当前使用的代码：

binding.tvSelectionTerm.setOnClickListener {
         val dialog = TimePickerDialog(
                requireContext(),
                AlertDialog.THEME_HOLO_LIGHT,
                timeSetListener(WhichTimeType.TERMS_TIME),
                cal.get(Calendar.HOUR_OF_DAY),
                cal.get(Calendar.MINUTE),
                true,
            )
            if (termsBetweenTimeForDialog?.isEmpty() == true) {
                dialog.updateTime(1, 0)
            } else {
                dialog.updateTime(
                    dropZeroChar(WhichTimeUnitType.FOR_HOUR, WhichTimeType.TERMS_TIME),
                    dropZeroChar(WhichTimeUnitType.FOR_MINUTE, WhichTimeType.TERMS_TIME)
                )
            }
            dialog.show()
}

private fun timeSetListener(whichTimeType: WhichTimeType) =
        TimePickerDialog.OnTimeSetListener { _, hour, minutes ->
            cal.set(Calendar.HOUR_OF_DAY, hour)
            cal.set(Calendar.MINUTE, minutes)
            val myFormat = "HH:mm" // mention the format you need
            val sdf = SimpleDateFormat(myFormat, Locale.getDefault())
            val selectedTime = sdf.format(cal.timeInMillis)
        }

实现方案 #

原生TimePickerDialog没有直接提供设置分钟间隔的API，但可以通过以下两种方式实现需求：

方案1：修正选中的时间值（轻量改造） #

在时间选择完成后，将用户选中的分钟自动修正为符合30分钟间隔的值，同时保证起始时间从00:30开始。修改OnTimeSetListener逻辑：

private fun timeSetListener(whichTimeType: WhichTimeType) =
        TimePickerDialog.OnTimeSetListener { _, hour, minutes ->
            // 计算最近的符合要求的时间
            val (adjustedHour, adjustedMinute) = when {
                minutes < 30 -> {
                    // 选中分钟小于30，修正为当前小时的30分
                    Pair(hour, 30)
                }
                else -> {
                    // 选中分钟大于等于30，修正为下一小时的0分，处理23:30的边界情况
                    val nextHour = if (hour == 23) 0 else hour + 1
                    Pair(nextHour, 0)
                }
            }
            // 特殊处理：如果当前修正后是00:00，强制改为00:30（保证起始时间从00:30开始）
            val finalHour = if (adjustedHour == 0 && adjustedMinute == 0) 0 else adjustedHour
            val finalMinute = if (adjustedHour == 0 && adjustedMinute == 0) 30 else adjustedMinute

            cal.set(Calendar.HOUR_OF_DAY, finalHour)
            cal.set(Calendar.MINUTE, finalMinute)
            val myFormat = "HH:mm"
            val sdf = SimpleDateFormat(myFormat, Locale.getDefault())
            val selectedTime = sdf.format(cal.timeInMillis)
            // 这里添加更新UI的逻辑
        }

如果希望在选择过程中就实时修正（而不是选完才修正），可以在dialog.show()后获取内部的TimePicker，设置时间变化监听器：

binding.tvSelectionTerm.setOnClickListener {
    val dialog = TimePickerDialog(
        requireContext(),
        AlertDialog.THEME_HOLO_LIGHT,
        timeSetListener(WhichTimeType.TERMS_TIME),
        cal.get(Calendar.HOUR_OF_DAY),
        cal.get(Calendar.MINUTE),
        true,
    )
    // 保留原有的updateTime逻辑
    if (termsBetweenTimeForDialog?.isEmpty() == true) {
        dialog.updateTime(1, 0)
    } else {
        dialog.updateTime(
            dropZeroChar(WhichTimeUnitType.FOR_HOUR, WhichTimeType.TERMS_TIME),
            dropZeroChar(WhichTimeUnitType.FOR_MINUTE, WhichTimeType.TERMS_TIME)
        )
    }
    dialog.show()

    // 获取内部TimePicker并设置实时修正
    dialog.findViewById<TimePicker>(android.R.id.timePicker)?.let { timePicker ->
        var isUpdating = false // 防止循环触发
        timePicker.setOnTimeChangedListener { _, hour, minute ->
            if (isUpdating) return@setOnTimeChangedListener
            isUpdating = true

            val (adjustedHour, adjustedMinute) = when {
                minute < 30 -> Pair(hour, 30)
                else -> {
                    val nextHour = if (hour == 23) 0 else hour + 1
                    Pair(nextHour, 0)
                }
            }

            val finalHour = if (adjustedHour == 0 && adjustedMinute == 0) 0 else adjustedHour
            val finalMinute = if (adjustedHour == 0 && adjustedMinute == 0) 30 else adjustedMinute

            timePicker.updateTime(finalHour, finalMinute)
            isUpdating = false
        }
    }
}

方案2：自定义Dialog（完全可控） #

如果需要完全隐藏不符合要求的分钟选项，建议自定义Dialog，使用NumberPicker分别实现小时和分钟选择：

1. 创建自定义布局dialog_time_picker_custom.xml：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="horizontal"
    android:gravity="center">

    <NumberPicker
        android:id="@+id/np_hour"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"/>

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text=":"
        android:textSize="24sp"
        android:paddingHorizontal="8dp"/>

    <NumberPicker
        android:id="@+id/np_minute"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"/>
</LinearLayout>

2. 在代码中实现自定义Dialog：

binding.tvSelectionTerm.setOnClickListener {
    val dialog = AlertDialog.Builder(requireContext())
        .setTitle("选择时间")
        .setView(R.layout.dialog_time_picker_custom)
        .setPositiveButton("确定") { _, _ ->
            val hour = dialog.findViewById<NumberPicker>(R.id.np_hour)?.value ?: 0
            val minute = dialog.findViewById<NumberPicker>(R.id.np_minute)?.value?.let {
                if (it == 0) 0 else 30
            } ?: 30
            cal.set(Calendar.HOUR_OF_DAY, hour)
            cal.set(Calendar.MINUTE, minute)
            val myFormat = "HH:mm"
            val sdf = SimpleDateFormat(myFormat, Locale.getDefault())
            val selectedTime = sdf.format(cal.timeInMillis)
            // 添加更新UI的逻辑
        }
        .setNegativeButton("取消", null)
        .create()

    dialog.setOnShowListener {
        val npHour = dialog.findViewById<NumberPicker>(R.id.np_hour)
        val npMinute = dialog.findViewById<NumberPicker>(R.id.np_minute)

        // 设置小时范围0-23
        npHour?.minValue = 0
        npHour?.maxValue = 23
        npHour?.value = cal.get(Calendar.HOUR_OF_DAY)

        // 设置分钟选项：仅0和30，默认选中30（保证起始时间从00:30开始）
        npMinute?.displayedValues = arrayOf("00", "30")
        npMinute?.minValue = 0
        npMinute?.maxValue = 1
        npMinute?.value = 1
    }

    dialog.show()
}

总结 #

• 方案1适合快速改造现有代码，通过修正时间值实现需求；
• 方案2可以完全控制可选时间，用户无法选择不符合要求的选项，体验更优。

内容的提问来源于stack exchange，提问作者Ahmet Yılmaz