函数签名[source] | |
---|---|
st.time_input(标签, 值="现在", 键=无, 帮助=无, 更改时=无, 参数=无, 关键字参数=无, *, 禁用=假, 标签可见性="可见", 步长=0:15:00) | |
参数 | |
label (str) | 一个简短的标签,向用户解释这个时间输入的用途。 标签可以选择性地包含以下类型的GitHub风格的Markdown:粗体、斜体、删除线、内联代码、链接和图片。图片显示为图标,最大高度等于字体高度。 不支持的Markdown元素会被解包,因此只有它们的子元素(文本内容)会渲染。通过反斜杠转义不支持的元素,将其显示为字面字符。例如, "1\. 不是一个有序列表"。 有关其他支持的Markdown指令,请参见st.markdown的body参数。 出于可访问性原因,您永远不应设置空标签,但您可以使用label_visibility隐藏它(如果需要)。将来,我们可能会通过引发异常来禁止空标签。 |
value ("now", datetime.time, datetime.datetime, str, or None) | 此小部件首次渲染时的值。可以是以下之一:
|
key (str or int) | 一个可选的字符串或整数,用作小部件的唯一键。 如果省略,将根据小部件的内容生成一个键。 任何两个小部件都不能有相同的键。 |
help (str) | 一个可选的小提示,显示在小部件标签旁边。 只有当label_visibility="visible"时,Streamlit才会显示这个小提示。 |
on_change (callable) | 当此时间输入的值发生变化时调用的可选回调函数。 |
args (tuple) | 传递给回调函数的可选参数元组。 |
kwargs (dict) | 一个可选的字典,用于传递给回调函数。 |
disabled (bool) | 一个可选的布尔值,如果设置为True,则禁用时间输入。默认值为False。 |
label_visibility ("visible", "hidden", or "collapsed") | 标签的可见性。默认是"visible"。如果这是"hidden",Streamlit会显示一个空的占位符而不是标签,这有助于保持小部件与其他小部件对齐。如果这是"collapsed",Streamlit不会显示标签或占位符。 |
步长 (整数或时间差) | 步进间隔,以秒为单位。默认为900,即15分钟。 你也可以传递一个datetime.timedelta对象。 |
返回 | |
(datetime.time or None) | 时间输入小部件的当前值,如果未选择时间则为None。 |
示例
import datetime import streamlit as st t = st.time_input("Set an alarm for", datetime.time(8, 45)) st.write("Alarm is set for", t)要初始化一个空的时间输入,使用 None 作为值:
import datetime import streamlit as st t = st.time_input("Set an alarm for", value=None) st.write("Alarm is set for", t)
还有问题吗?
我们的 论坛 充满了有用的信息和Streamlit专家。