MujicaUI/docs/components/432-timezone-select.md

432 TimezoneSelect · 时区选择

用途

按城市名或偏移搜索 IANA 时区，常用时区置顶，显示当前偏移。

最小示例

zone := "Asia/Shanghai"
view := func(c *ui.Context) {
	mujica.Use(c, mujica.Settings{})
	if mujica.TimezoneSelect(c, &zone, mujica.TimezoneSelectOptions{}).Changed() {
		fmt.Println("zone", zone)
	}
}
ui.Render(view, 400, 300, 1)

参数

func TimezoneSelect(c *ui.Context, zone *string, opts TimezoneSelectOptions) ChoiceResult

字段	类型	默认值	含义
Zones	[]string	内置世界列表	可选时区。
Common	[]string	内置常用列表	置顶的常用时区。
Now	time.Time	零值（系统时钟）	计算偏移所用的时刻（夏令时会改变偏移）。
Disabled	bool	false	禁用：不响应点击、拖动与快捷键，弹层随之关闭。
Label	string	内置文案	辅助技术读出的名称。

状态

关闭、打开（搜索框 + 分组列表）、高亮、已选（勾）、无结果、禁用。

事件

Changed() 报告选中的时区变化。

键盘操作

• Enter、Space 或 ↓ 打开；输入搜索；↑/↓ 移动高亮；Enter 选择；Escape 关闭。

限制

• 内嵌 time/tzdata，离线可用；未知时区名 panic。