Exponenta Banner

uidatepicker

(App Designer) Создает компонент средства выбора даты

свернуть все на странице

Используйте только с App Designer, или с фигурами, созданными с функцией uifigure. GUIDE и фигуры, созданные с функцией figure, не поддерживают средства выбора даты.

Синтаксис

d = uidatepicker
d = uidatepicker(Name,Value)
d = uidatepicker(parent)
d = uidatepicker(parent,Name,Value)

Описание

d = uidatepicker создает средство выбора даты в новой фигуре и возвращает объект DatePicker. MATLAB® вызывает функцию uifigure, чтобы создать фигуру.

d = uidatepicker(Name,Value) задает значения свойств DatePicker с помощью одного или нескольких аргументов пары Name,Value.

d = uidatepicker(parent) создает средство выбора даты в заданном родительском контейнере. Родительский элемент может быть созданным использованием Figure функции uifigure или одного из ее дочерних контейнеров.

пример

d = uidatepicker(parent,Name,Value) создает средство выбора даты в заданном контейнере и устанавливает одни или несколько значений свойств DatePicker.

Примеры

свернуть все

Создайте средство выбора даты в левом верхнем углу фигуры.

f = uifigure('Position',[500 500 320 280]);
d = uidatepicker(f,'Position',[18 235 150 22]);

Создайте средство выбора даты, которое отображает дату в текстовом поле с помощью формата dd-MM-yyyy. Водяной знак в запущенном приложении отображает новый формат, и все выбранные даты используют тот формат.

f = uifigure('Position',[500 500 320 280]);
d = uidatepicker(f,'Position',[18 235 150 22]);
d.DisplayFormat = 'dd-MM-yyyy';

Создайте средство выбора даты, которое отключает воскресенья и Новый год 2018.

f = uifigure('Position',[500 500 375 280]);
d = uidatepicker(f,'Position',[18 225 150 22]);
d.DisabledDaysOfWeek = 1;
d.DisabledDates = datetime(2018,1,1);

Когда вы расширяете средство выбора даты и обзор до января 2018, первый день года и всех воскресений отключен.

Создайте программный файл под названием mydateapp.m, который создает фигуру и средство выбора даты с обратным вызовом ValueChangedFcn.

function mydateapp
f = uifigure('Position',[340 400 415 300]);
d = uidatepicker(f,'DisplayFormat','MM-dd-yyyy',...
    'Position',[130 190 150 22],...
    'Value',datetime(2014,4,9),...
    'ValueChangedFcn', @datechange);

    function datechange (src,event)
        lastdate = char(event.PreviousValue);
        newdate = char(event.Value);
        msg = ['Change date from ' lastdate ' to ' newdate '?'];
        % Confirm new date
        selection = uiconfirm(f,msg,'Confirm Date');
        
        if (strcmp(selection,'Cancel'))
            % Revert to previous selection if cancelled
            d.Value = event.PreviousValue;
        end
    end
end

Функция datechange отображает поле диалогового окна подтверждения и определяет, которые снабжают кнопками пользовательские нажатия кнопки в том диалоговом окне. Средство выбора даты возвращается на предыдущую дату, если пользователь нажимает Cancel.

Запустите программу и кликните по дате, чтобы видеть поле диалогового окна подтверждения.

mydateapp

Входные параметры

свернуть все

Родительский контейнер, заданный как Figure, создал использование функции uifigure или одного из ее дочерних контейнеров: Tab, Panel, ButtonGroup или GridLayout.

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Имя должно появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: d = uidatepicker ('Значение', datetime ('сегодня')) создает средство выбора даты с сегодняшней датой, выбранной в пользовательском интерфейсе.

Примечание

Перечисленные здесь свойства являются только подмножеством. Для полного списка смотрите DatePicker Properties.

Выбранная дата, заданная как объект datetime в области значений свойства Limits. Чтобы сделать выбранную дату незаданной, установите это свойство на NaT.

Если заданный объект datetime содержит информацию времени, только информация о дате сохраняется в свойстве Value.

Пример: d = uidatepicker ('Значение', datetime ('сегодня'))

Типы данных: datetime

Формат отображения для текстового поля средства выбора даты, заданного как вектор символа или скаляр строки. Формат по умолчанию зависит от локали системы, запускающей приложение.

Формат, который вы задаете, должен использовать допустимые идентификаторы буквы, которые соответствуют Unicode® Locale Data Markup Language (LDML) стандарт в течение многих дат и времен. Чтобы разделить поля, можно включать символы небуквы, такие как дефис, пробел, двоеточие или любые символы неASCII.

Пример: d = uidatepicker ('DisplayFormat', 'дд/мм/гг')

Примеры распространенных форматов

Эта таблица приводит общие форматы отображения. Примеры показывают отформатированный вывод для даты среда, 9 апреля 2014.

Значение FormatПример
yyyymmdd2014-04-09
'dd/MM/yyyy'09/04/2014
'dd.MM.yyyy'09.04.2014
'yyyy年 MM月 dd日'2014年 04月 09日
'MMMM d, yyyy'April 9, 2014

Все форматы даты и времени

Используйте эти идентификаторы буквы, чтобы создать формат отображения. Третий столбец этой таблицы показывает вывод для даты среда, 9 апреля 2014.

Обозначьте буквами идентификаторОписаниеОтображение
GЭраCE
yГод, без начальных нулей.2014
yyГод, с помощью последних двух цифр.14
yyy, yyyy...Год, с помощью, по крайней мере, столько же цифр сколько существует экземпляры 'y'В течение года 2014, 'yyy' отображает 2014, в то время как 'yyyyy' отображает 02014.
u, uu...Год ISO, единственный номер, определяющий год.2014
QЧетверть, с помощью одной цифры2
QQЧетверть, с помощью двух цифр02
QQQЧетверть, сокращеннаяQ2
QQQQЧетверть, полное имя2nd quarter
MМесяц, числовой, с помощью одной или двух цифр4
MMМесяц, числовой, с помощью двух цифр04
MMMМесяц, сокращенное имяApr
MMMMМесяц, полное имяApril
MMMMMМесяц, использованный для своей выгоды сначала, обозначает буквамиA
WНеделя месяца, с помощью одной цифры2
dДень месяца, с помощью одной или двух цифр9
ddДень месяца, с помощью двух цифр09
DДень года, с помощью один, два, или три цифры99
DDДень года, с помощью двух цифр99
DDDДень года с помощью трех цифр099
eДень недели, числовой, с помощью одной или двух цифр4, где воскресенье является первым днем недели
eeДень недели, числовой, с помощью двух цифр04
eeeДень, сокращенное имяWed
eeeeДень, полное имяWednesday
eeeeeДень, использованный для своей выгоды сначала, обозначает буквамиW

Примечание

  • Поле редактирования в запущенном приложении принимает разграниченные числовые значения, даже когда DisplayFormat включает слова. Например, если формат месяца задан как 'MMMM', приложение принимает числовой месяц, такой как 04, но отобразит имя месяца, такое как 'April'.

  • Если пользователь задает номер дня года в запущенном приложении, и формат содержит идентификаторы и в течение дня года (D) и в течение Грегорианский год (y), то datetime не может считать номер дня года правильно. Используйте год ISO (u) вместо y.

  • Используйте один или несколько символов u вместо символов y, чтобы представлять год при работе с числами года около нуля.

Значение измененная функция, заданная как одно из следующего:

  • Указатель на функцию.

  • Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.

  • Вектор символа, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.

Обратный вызов ValueChangedFcn выполняется, когда пользователь изменяет дату путем ввода в текстовом поле или путем расширения средства выбора даты и выбора даты.

Эта функция обратного вызова может получить доступ к определенной информации о взаимодействии пользователя со средством выбора даты. MATLAB передает эту информацию в объекте ValueChangedData в качестве второго аргумента к вашей функции обратного вызова. In App Designer, the argument is called event. можно получить свойства объектов с помощью записи через точку. Например, event.PreviousValue получает ранее выбранную дату. Объект ValueChangedData не доступен функциям обратного вызова, заданным как векторы символов.

В следующей таблице перечислены свойства объекта ValueChangedData.

СвойствоЗначение
ЗначениеНовая выбранная дата
PreviousValueРанее выбранная дата
SourceКомпонент, который выполняет обратный вызов
EventName'ValueChanged'

Обратный вызов ValueChangedFcn не выполняется, когда пользовательские повторные выборы или перепечатывают в настоящее время выбранную дату. Обратный вызов также не выполняется, когда свойство Value изменяется программно.

Для получения дополнительной информации о создании обратных вызовов в App Designer, смотрите Обратные вызовы Записи в App Designer.

Местоположение и размер свернутого средства выбора даты относительно родительского контейнера, заданного как вектор формы [left bottom width height]. В этой таблице описываются каждый элемент в векторе.

ЭлементОписание
leftРасстояние от внутреннего левого края родительского контейнера к внешнему левому краю средства выбора даты
bottomРасстояние от внутреннего базового края родительского контейнера к внешнему базовому краю средства выбора даты
widthРасстояние между правыми и левыми внешними краями средства выбора даты
высотаРасстояние между верхними и нижними внешними краями средства выбора даты

Все измерения указаны в пикселях.

Выходные аргументы

свернуть все

Объект DatePicker. Используйте d, чтобы установить свойства в день средство выбора после создания его.

Смотрите также

Функции

Свойства

Представленный в R2018a

Была ли эта тема полезной?
Документация MATLAB
Поддержка