主要内容

uidatepicker

创建日期选择器组件

描述

d= uidatepicker创建一个日期选择器在一个新的图并返回DatePicker对象。MATLAB®调用uifigure函数创建的图。

d= uidatepicker (名称,值)指定DatePicker使用一个或多个属性值名称,值对参数。

d= uidatepicker ()创建一个日期选择在指定的父容器。父母可以创建使用uifigure函数,或者它的一个孩子容器。

例子

d= uidatepicker (,名称,值)创建日期选择指定的容器中,并设置一个或多个DatePicker属性值。

例子

全部折叠

创建一个日期选择界面的左上角图所示。

无花果= uifigure (“位置”,(500 500 320 280));d = uidatepicker(图,“位置”[18 235 150 22]);

日期选择界面图窗口。日期选择器有水印文本“mm / dd / yyyy”。

创建一个日期选择器显示在文本字段中使用的日期dd-MM-yyyy格式。运行应用程序显示的水印新格式,和所有选定日期使用这种格式。

无花果= uifigure (“位置”,(500 500 320 280));d = uidatepicker(图,“位置”[18 235 150 22]);d。DisplayFormat =“dd-MM-yyyy”;

日期选择界面图窗口。日期选择水印文本“dd-mm-yyyy”。

创建一个日期选择器,禁用星期天和2018年元旦。

无花果= uifigure (“位置”,(500 500 375 280));d = uidatepicker(图,“位置”[18 225 150 22]);d。DisabledDaysOfWeek = 1; d.DisabledDates = datetime(2018,1,1);

当你扩大日期选择器,浏览到2018年1月的第一天,星期日都是禁用的。

日期选择界面图窗口。日期选择器扩展,显示日期2018年1月。1月1日周日,天变暗了,划掉了。

创建一个程序文件mydateapp.m创建一个图,一个日期选择ValueChangedFcn回调。

函数mydateapp无花果= uifigure (“位置”,(340 400 415 300));d = uidatepicker(图,“DisplayFormat”,“;”,“位置”(130 190 150 22),“价值”datetime (2014 4 9),“ValueChangedFcn”,@datechange);函数datechange (src、事件)lastdate = char (event.PreviousValue);newdate = char (event.Value);味精= [“改变日期从”lastdate”到“newdate“?”];%确定新的日期选择= uiconfirm(无花果、味精、“确认日期”);如果(比较字符串(选择,“取消”))如果取消%恢复到以前的选择d。值= event.PreviousValue;结束结束结束

datechange函数显示一个确认对话框,并确定用户点击哪个按钮的对话框。该日期选择器返回到以前的日期如果用户单击取消

运行程序,单击一个日期的确认对话框。

mydateapp

左边是一个UI图日期选择器窗口。2014年4月9日,被选中,光标悬停在4月15日,2014年。右边是一个UI图与一个确认对话框与文本:“改变日期从04-09-2014到04-15-2014 ?”。

输入参数

全部折叠

指定为一个父容器对象创建使用uifigure函数或子容器之一:选项卡,面板,ButtonGroup,或GridLayout。如果你不指定一个父容器,MATLAB调用uifigure创建一个新的函数对象作为父容器。

名称-值参数

指定可选的双参数作为Name1 = Value1,…,以=家,在那里的名字参数名称和吗价值相应的价值。名称-值参数必须出现在其他参数,但对的顺序无关紧要。

R2021a之前,用逗号来分隔每一个名称和值,并附上的名字在报价。

例子:d = uidatepicker(“价值”,datetime('今天'))创建一个与今天的日期选择日期选择界面。

请注意

这里列出的属性是唯一的一个子集。一个完整的列表,请参阅DatePicker属性

选择日期,指定为一个datetime对象的范围内限制财产。所选日期不明,设置该属性NaT

如果指定的datetime对象包含时间信息,只有日期信息保存在价值财产。

例子:d = uidatepicker(“价值”,datetime('今天'))

数据类型:datetime

显示格式的日期选择文本字段,指定为一个特征向量或字符串标量。默认的格式取决于系统的现场运行应用程序。

您所指定的格式必须使用有效的字母标识符对应于Unicode®语言环境数据标记语言(LDML)日期和时间的标准。单独的字段,您可以包括nonletter字符,如一个连字符,空间,冒号,或任何非ascii字符。

例子:d = uidatepicker (“DisplayFormat”、“dd / MM / yy”)

常见的例子的格式

此表列出了常见的显示格式。的例子显示格式化输出日期,星期三,2014年4月9日。

的价值格式 例子
“yyyy-MM-dd” 2014-04-09
“dd / MM / yyyy” 09/04/2014
“dd.MM.yyyy” 09.04.2014
“yyyy年MM月dd日” 2014年04月09日
“嗯d, yyyy” 2014年4月9日

所有的日期和时间格式

用这些字母标识符创建一个显示格式。第三列的表显示输出的日期,星期三,2014年4月9日。

字母标识符 描述 显示
G 时代 CE
y 年,没有前导零。 2014年
yy 一年,使用最后两位数。 14
,yyyy 至少一年,使用尽可能多的数字的实例“y” 2014年,“多”显示2014年,而“yyyyy”显示02014年
u,uu,…… ISO,一个数字指定。 2014年
季度,使用一个数字 2
QQ 季度,使用两个数字 02
回调 季度,缩写 第二季
QQQQ 季度,全名 第二季度
月,数值,使用一个或两个数字 4
毫米 月,数值,使用两个数字 04
月,缩写的名字 4月
月,全名 4月
月,大写首字母 一个
W 星期,使用一个数字 2
d 日,使用一个或两个数字 9
dd 日,使用两个数字 09年
D 天,使用一个,两个,三个数字 99年
DD 一天,使用两个数字 99年
DDD 使用三位数的 099年
e 星期,数值,使用一个或两个数字 4,星期日是一周的第一天
ee 天的星期,数值,使用两个数字 04
eee 天,缩写的名字 结婚
eeee 天,全名 周三
eeeee 天,大写首字母 W

请注意

  • 运行应用程序接受编辑字段分隔的数字值,即使DisplayFormat包括单词。例如,如果被指定为月格式“嗯”,应用程序接受一个数字月如04一个月,但将显示名称等“4”

  • 如果用户指定了一个day-of-year应用程序,运行在数量和格式包含标识符的一天(D)和格雷戈里(y),然后datetime可能不读day-of-year数量正确。使用ISO (u在的地方y

  • 使用一个或多个u字符,而不是y字符来表示在处理去年同期数字接近于零。

改变函数值,指定为以下之一:

  • 一个处理函数。

  • 细胞数组中第一个元素是一个函数处理。后续单元阵列中的元素传递给回调函数的参数。

  • 一个特征向量包含有效的MATLAB表达式(不推荐)。MATLAB计算表达式的基本工作空间。

ValueChangedFcn回调执行当用户更改日期输入文本字段或扩大日期选择器和选择一个日期。

这个回调函数可以访问特定用户的交互信息和日期选择器。MATLAB中传递这些信息ValueChangedData回调函数对象作为第二个参数。在应用程序设计,论证事件。可以使用点符号对象属性。例如,event.PreviousValue得到了先前选定的日期。的ValueChangedData对象不可用回调函数指定为特征向量。

下表列出的属性ValueChangedData对象。

财产 价值
价值 新选择的日期
PreviousValue 先前选定的日期
组件执行回调
EventName “ValueChanged”

ValueChangedFcn回调不执行当用户重新选择或输入当前选中日期。回调时也不执行价值通过编程方式属性更改。

有关创建回调的更多信息在应用程序设计师,看看回调程序设计师

倒塌的日期选择器的位置和大小相对于父容器,指定为一个向量的形式(左底宽高)。此表描述向量中每个元素。

元素 描述
父容器的内部左边缘的距离外左边缘的日期选择器
的距离内底边缘父容器的外底日期选择器的边缘
宽度 左、右外边缘之间的距离的日期选择器
高度 距离顶部和底部日期选择器的外边缘

所有的测量都是在像素单元。

版本历史

介绍了R2018a

全部展开

另请参阅

功能

属性