主要内容

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]);

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

无花果= uifigure (“位置”,[500 500 320 280]);d = uidatepicker(图,“位置”,[18 235 150 22]);d.DisplayFormat =“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月时,一年的第一天和所有星期日都是禁用的。

创建一个名为mydateapp.m使用。创建图形和日期选择器ValueChangedFcn回调。

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

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

运行程序,并单击日期以查看确认对话框。

mydateapp

输入参数

全部折叠

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

名称-值参数

指定可选的逗号分隔的对名称,值参数。的名字参数名和价值为对应值。的名字必须出现在引号内。可以以任意顺序指定多个名称和值对参数Name1, Value1,…,的家

例子:d = uidatepicker(“价值”,datetime('今天'))创建一个日期选择器,在UI中选择今天的日期。

请注意

这里列出的属性只是一个子集。有关完整列表,请参见DatePicker属性

选定日期,指定为datetime对象的范围内的限制财产。若要使所选日期不指定,请将此属性设置为NaT

如果指定的datetime对象中包含时间信息,仅保留日期信息价值财产。

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

数据类型:datetime

显示日期选择器文本字段的格式,指定为字符向量或字符串标量。默认格式取决于运行应用程序的系统的语言环境。

指定的格式必须使用与Unicode对应的有效字母标识符®地区数据标记语言(LDML)用于日期和时间的标准。要分隔字段,可以包含非字母字符,如连字符、空格、冒号或任何非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... Year,使用的数字至少与实例的数字一样多“y” 2014年,“多”显示2014,而“yyyyy”显示02014
uuu,…… 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 Day,首字母大写 W

请注意

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

  • 如果用户在运行的应用程序中指定了一年中的一天,并且格式包含了这一天的标识符(D)及公历年(y),然后datetime可能无法正确读取年月日的数字。使用国际标准化组织年份(u代替y

  • 使用一个或多个u字符,而不是y当处理接近零的年份时,用字符表示年份。

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

  • 一个处理函数。

  • 单元格数组,其中第一个元素是函数句柄。cell数组中的后续元素是要传递给回调函数的参数。

  • 包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。

ValueChangedFcn当用户通过在文本字段中输入或展开日期选择器并选择日期来更改日期时,将执行回调。

这个回调函数可以访问关于用户与日期选择器交互的特定信息。MATLAB将这个信息传递到ValueChangedData对象作为回调函数的第二个参数。在App Designer中,参数被调用事件.你可以使用点符号来获得对象属性。例如,事件。PreviousValue获取先前选定的日期。的ValueChangedData对象不可用于指定为字符向量的回调函数。

控件的属性如下表所示ValueChangedData对象。

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

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

有关在应用程序设计器中创建回调的更多信息,请参见在应用程序设计器中编写回调

折叠日期选择器相对于父容器的位置和大小,指定为窗体的向量[左下角宽度高度].该表描述了向量中的每个元素。

元素 描述
从父容器的左内边缘到日期选择器的左外边缘的距离
从父容器的内底边到日期选择器的外底边的距离
宽度 日期选择器左右外缘之间的距离
高度 日期选择器上外缘和下外缘之间的距离

所有的测量都以像素为单位。

另请参阅

功能

属性

介绍了R2018a