问题现象描述
当开发者使用st.time_input()方法创建时间选择器时，经常遇到设置的默认值(default_value)无法正确显示的异常情况。控制台不报错但界面展示为空，或者显示的时间格式与预期不符。这种问题多发生在以下场景：
- 从数据库读取的时间戳直接作为参数传递
- 使用
datetime.time对象但时区不匹配 - 通过
pd.Timestamp转换的临时变量
根本原因分析
通过剖析streamlit 1.22.0的源码，发现时间输入组件对数据类型的处理存在三个关键约束：
- 类型校验严格：只接受
datetime.time或特定格式的字符串 - 时区敏感：UTC时间不自动转换为本地时区
- 格式限制：字符串必须符合ISO 8601的简化格式(HH:MM)
5种解决方案对比
| 方法 | 代码示例 | 适用场景 |
|---|---|---|
| datetime标准化 | default_time = datetime.time(9, 30)
st.time_input("会议时间", default_time) |
硬编码固定时间 |
| 字符串格式化 | st.time_input("截止时间", value="15:00") |
配置化时间管理 |
| 时间戳转换 | ts = pd.Timestamp("2023-01-01 08:00")
st.time_input("开始时间", ts.time()) |
数据库时间字段 |
| 时区处理 | utc_time = datetime.datetime.utcnow()
local_time = utc_time.astimezone()
st.time_input("当前时间", local_time.time()) |
跨时区应用 |
| 回调函数 | def get_default_time():
return datetime.time(10, 45)
st.time_input("提醒时间", get_default_time()) |
动态默认值 |
性能优化建议
在处理大规模时间数据时，建议采用以下最佳实践：
- 使用
@st.cache_data缓存时间转换结果 - 避免在回调函数中执行复杂的时间计算
- 对持续更新的时间值使用
st.session_state - 考虑使用
arrow库处理跨时区场景
异常处理机制
健壮的时间输入处理应包含以下错误处理逻辑：
try:
user_time = st.time_input("预约时间", datetime.time(9, 0))
except ValueError as e:
st.error(f"时间格式错误: {e}")
user_time = datetime.time.now()