datepicker - виджет Datepicker

datepicker([methodName, option, value])
datepicker([methodName, param_obj])
datepicker([param_obj])
// локализация
$('#inline').datepicker($.datepicker.regional["uk"]);

$('#datep').datepicker({
    buttonImage: "right.png",
    buttonImageOnly: true,
    changeMonth: true,
    changeYear: true,
    constrainInput: true,
    maxDate: "+1",
    minDate: "-3",
    numberOfMonths: [1, 3],
    showCurrentAtPos: 1,
    showOn: 'both',
    showOtherMonths: true,
    showWeek: true,
    yearRange: "-1:+2",
    weekHeader: "Неделя",

    onClose: function(date, datepicker){
        ...
    },
    onSelect: function(date, datepicker){
        ...
    },
    onChangeMonthYeаr: function(year, month, datepicker){
        ...
    }

});
  • methodName

    • destroy - Полностью удаляет функциональность виджета Datepicker из базового элемента
    • disable - Приостанавливает работу виджета Datepicker для базовогоэлемента
    • enable - Возобновляет работу ранее приостановленного виджета Datepicker для базового элемента
    • option - Позволяет получить или установить значения одной или не­скольких опций виджета Datepicker
    • isDisabled - Возвращает true, если виджет Datepicker отключен
    • hide - Скрывает всплывающий календарь, если он видимый
    • show - Отображает всплывающий календарь, если он невидимый
    • refresh - Обновляет календарь для отражения выполненных в базовом элементе изменений
    • getDate - Получает дату, выбранную в календаре
    • setDate - Устанавливает указанное значение в качестве выбранной даты календаря
  • param_obj

    • altField - Позволяет задать дополнительное поле, которое будет обновляться при выборе да­ты в календаре

    • appendText - Задает текст подсказки, содержащий дополнительную информацию, например пояснения относительно форматирования даты, который будет вставлен в до­кумент после элемента input

    • buttonImageOnly - Указывает, что вместо вспомогательной кнопки, позволяющей открыть календарь, должно использоваться изображение, заданное опцией buttonimage

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

    • buttonText - Определяет текст, который будет отображаться на кнопке открытия всплывающего календаря. Текстом по умолчанию является многоточие ( … )

    • changeMonth - Если эта опция равна true, то в календаре отображается раскрывающийся список, обеспечивающий возможность непосредственной навигации по меся­цам. Значение по умолчанию — false

    • changeYear - Если эта опция равна true, то в календаре отображается раскрывающийся список, обеспечивающий возможность непосредственной навигации по годам. Значение по умолчанию — false

    • closeText - Задает текст для кнопки закрытия календаря, отображающейся на панели вспомогательных кнопок, если она включена. Значение по умолчанию — За­крыть

    • constrainInput - Если эта опция равна true, то виджет Datepicker проверяет соответствие содержимого поля ввода заданному формату даты. Значение по умолчанию — true

    • create - Происходит при создании экземпляра Datepicker

    • currentText - Задает текст для кнопки возврата к текущему месяцу, отображающейся на па­нели вспомогательных кнопок, если она включена. Значение по умолчанию — Сегодня

    • defaultDate - Позволяет установить дату, которая будет подсвечена при открытии календаря

      • null - текущая дата
      • Date - явная дата
      • +/-дни - смещение дат относительно текущей
      • +1d +7w -1m +1y
    • disabled - Указывает, должен ли виджет быть первоначально отключен. Значение по умолча­нию — false

    • duration - Задает скорость или длительность выполнения анимации, заданной опцией showAnim. Значение по умолчанию — normal.

    • gotoCurrent - Если эта опция равна true, то кнопка сегодня, находящаяся на панели вспомогательных кнопок, если она включена, будет осуществлять возврат к вы­бранной, а не к текущей дате. Значение по умолчанию — false

    • hideIfNoPrevNext - Если эта опция равна true, то значки, позволяющие перемещаться по кален­дарю вперед и назад относительно отображаемой даты, полностью скрываются, а не просто отключаются. Значение по умолчанию — false

    • maxDate - Определяет максимальную дату, доступную для выбора. По умолчанию это ограничение отсутствует

    • minDate - Определяет минимальную дату, доступную для выбора. По умолчанию это ограничение отсутствует

    • numberOfMonths - Определяет количество месяцев, одновременно отображаемых в календаре. Значение по умолчанию — 1

    • onChangeMonthYeаr - Происходит при создании экземпляра Datepicker

    • onClose - Происходит при закрытии всплывающего календаря

    • onSelect - Происходит, когда пользователь выбирает дату

    • selectOtherMonths - Если эта опция равна true, то становятся доступными для выбора даты, отображаемые в результате установки равным true значения опции showOtherMonths

    • showAnim - Определяет тип анимации, используемой для отображения и сокрытия всплы­вающих календарей. Значение по умолчанию — false

    • showButtonPanel - Если эта опция равна true, то в календаре будет отображаться вспомога­тельная панель с кнопками, с помощью которых пользователь сможет перехо­дить к текущей дате и (если используется всплывающий виджет) закрывать ка­лендарь. Значение по умолчанию — false

    • showCurrentAtPos - Если для календаря задано одновременное отображение нескольких месяцев, то данная опция определяет номер позиции, в которой должен отображаться текущий или заданный по умолчанию месяц. Значение по умолчанию — 0

    • showOn - Определяет действие, инициирующее открытие всплывающего календаря

      • focus - Всплывающий календарь открывается при получении фокуса ввода элементом input. Это значение используется по умолчанию.
      • button - Всплывающий календарь открывается щелчком на кнопке.
      • both - Всплывающий календарь отображается как после щелчка на кнопке, так и после получения фокуса элементом input.
    • showOptions - Задает опции анимации, указанной опцией showAnim.

    • showOtherMonths - Если эта опция равна true, то пустые поля в календарной сетке будут запол­няться датами из предыдущих и последующих месяцев. Значение по умолча­нию — false

    • showWeek - Если значение этой опции равно true, то в календаре будет отображаться столбец с номерами недель. Значение по умолчанию — false

    • stepMonths - Определяет, на сколько месяцев вперед или назад должна сдвигаться отобра­жаемая в календаре дата при щелчке на кнопке перехода вперед или назад во времени

    • yearRange - Определяет диапазон лет, доступных для выбора в раскрывающемся списке, добавляемом с помощью опции changeYear. По умолчанию этот список включает десять предыдущих и десять последующих лет, а также текущий год

    • weekHeader - Задает заголовок столбца календаря с номерами недель, включенной с помощью опции showWeek. Значение по умолчанию — Нед