38  /  103

UI.DatePicker.show

Просмотров: 1524 (Статистика ведётся с 06.02.2017)

Описание:

Функция для показа контрола выбора даты и времени.

Синтаксис:

BXMobileApp.UI.DatePicker.show();
Для показа контрола выбора дат нужно предварительно задать параметры через:
BXMobileApp.UI.DatePicker.setParams(pickerParams);
АргументыОписание

pickerParams

Объект описания пикера:

Ключи описания пикера:
  • start_date - начальное значение даты, времени или даты и времени. Если не задается, отображается текущая дата (время);
  • min_date - позволяет задать минимально возможную для выбора дату;
  • max_date - позволяет задать максимально возможную для выбора дату;
  • format - формат даты и времени. В этом формате нужно передавать start_date, min_date и max_date. В этом формате пикер вернет выбранную дату в функцию обратного вызова;
  • callback - обработчик события выбора даты и времени. Первым аргументом в обработчик передается выбранная дата в формате format;
  • type - тип пикера. Используются следующие типы отображения:
    • datetime - дата и время;
    • time - время;
    • date - позволяет задать максимально возможную для выбора дату.

Внимание! Формат даты должен соответствовать переданному типу пикера.

Пример отображения для выбора только времени:

//Отображение пикера времени, с заданным начальным временем:
BXMobileApp.UI.DatePicker.setParams({                
               type: "time",
               start_date: "09:12",
               format: "h:mm",
               callback: function (d)
               {
                 app.alert({title:"time", text:JSON.stringify(d)});        
               }
             }
);
BXMobileApp.UI.DatePicker.show();

Пример для отображения контрола выбора только даты:

//Отображение пикера даты, с заданной начальной датой:
BXMobileApp.UI.DatePicker.setParams({                
               type: "date",
               start_date: "29.06.1998",
               format: "dd.MM.yyyy",
               callback: function (d)
               {
                 app.alert({title:"date", text:JSON.stringify(d)});        
               }
             }
);
BXMobileApp.UI.DatePicker.show();

Пример пример отображения контрола для выбора даты и времени:

//Отображение пикера даты и времени, с заданной начальной датой и временем. В iOS год не отображается для выбора, но передается, с выбранной датой и временем:
BXMobileApp.UI.DatePicker.setParams({                
               type: "datetime",
               start_date: "29.06.1998, 09:12",
               format: "dd.MM.yyyy, h:mm",
               callback: function (d)
               {
                 app.alert({title:"datetime", text:JSON.stringify(d)});        
               }
             }
);
BXMobileApp.UI.DatePicker.show();

Пример с ограничением выбора даты:

//Задаем минимально возможную для выбора дату. В данном примере задана дата - 09.01.2014. На платформе iOS, в случае выбора даты меньше, чем 09.01.2014, пикер отобразит минимально возможную дату, а именно 09.01.2014:
BXMobileApp.UI.DatePicker.setParams({                
               type: "date",
               format: "dd.MM.yyyy",
               min_date: "09.01.2014",
               callback: function (d)
               {
                 app.alert({title:"datetime", text:JSON.stringify(d)});        
               }
             });
BXMobileApp.UI.DatePicker.show();

Пример:

//Задаем максимально возможную для выбора дату. В данном примере задана дата - 02.03.2015. На платформе iOS, в случае выбора даты больше, чем 02.03.2015, пикер отобразит максимально возможную дату, а именно 02.03.2015:
BXMobileApp.UI.DatePicker.setParams({                
               type: "date",
               format: "dd.M.yyyy",
               max_date: "02.03.2015",
               callback: function (d)
               {
                 app.alert({title:"datetime", text:JSON.stringify(d)});        
               }
             });
BXMobileApp.UI.DatePicker.show();

Пример:

//Использование изначально заданной даты и времени, с ограничением выбора по установленной максимальной дате и времени (начально заданная дата и временя, должны быть одинакового формата с максимально возможной для выбора датой и временем). В данном примере заданы дата и время - 01.03.2015, 09:12. На платформе iOS, в случае выбора даты и времени больше, чем 01.03.2015, 09:12, пикер отобразит максимально возможную дату и время, а именно 01.03.2015, 09:12:

BXMobileApp.UI.DatePicker.setParams({                
               type: "datetime",
               start_date: "01.03.2015, 09:12",
               format: "dd.MM.yyyy, h:mm",
               max_date: "02.03.2015, 09:00",
               callback: function (d)
               {
                 app.alert({title:"datetime", text:JSON.stringify(d)});        
               }
             });       
BXMobileApp.UI.DatePicker.show();

Видео:

iOS


2
Курсы разработаны в компании «1С-Битрикс»

Если вы нашли неточность в тексте, непонятное объяснение, пожалуйста, сообщите нам об этом в комментариях.
Развернуть комментарии