exponenta event banner

uidatepicker

Создать компонент средства выбора дат

Описание

d = uidatepicker создает средство выбора даты на новом рисунке и возвращает значение DatePicker объект. MATLAB ® вызывает uifigure для создания фигуры.

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

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

пример

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

Примеры

свернуть все

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

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

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

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

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

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

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

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

function mydateapp
fig = uifigure('Position',[340 400 415 300]);
d = uidatepicker(fig,'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 отображает диалоговое окно подтверждения и определяет, какую кнопку пользователь нажимает в этом диалоговом окне. Выбор даты возвращается к предыдущей дате, если пользователь нажимает кнопку Отмена.

Запустите программу и щелкните дату для просмотра диалогового окна подтверждения.

mydateapp

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

свернуть все

Родительский контейнер, указанный как Figure объект, созданный с помощью uifigure функцию или один из ее дочерних контейнеров: Tab, Panel, ButtonGroup, или GridLayout. Если родительский контейнер не указан, MATLAB вызывает uifigure для создания новой функции Figure объект, который служит родительским контейнером.

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

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

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

Примечание

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

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

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

Пример: d = uidatepicker('Value',datetime('today'))

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

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

Указанный формат должен использовать допустимые идентификаторы букв, соответствующие стандарту языка разметки данных языка (LDML) Unicode ® для дат и времени. Для разделения полей можно использовать символы, не содержащие букв, такие как дефис, пробел, двоеточие или любые символы, не относящиеся к ASCII.

Пример: d = uidatepicker('DisplayFormat','dd/MM/yy')

Примеры общих форматов

В этой таблице перечислены общие форматы отображения. В примерах показаны отформатированные выходные данные для даты, среды, 9 апреля 2014 г.

Значение FormatПример
'yyyy-MM-dd'2014-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 объект в качестве второго аргумента функции обратного вызова. В App Designer аргумент называется event. Свойства объекта можно получить с помощью точечной нотации. Например, event.PreviousValue получает ранее выбранную дату. ValueChangedData недоступен для функций обратного вызова, указанных как векторы символов.

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

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

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

Дополнительные сведения о создании обратных вызовов в App Designer см. в разделе Запись обратных вызовов в App Designer.

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

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

Все измерения представлены в единицах пикселей.

См. также

Функции

Свойства

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