Methods

Methods are called on a datepicker by calling the datepicker function with a string first argument, followed by any arguments the method takes

$('.datepicker').datepicker('method', arg1, arg2);

destroy

Arguments: None

Remove the datepicker. Removes attached events, internal attached objects, and added HTML elements.

Alias: remove

show

Arguments: None

Show the picker.

hide

Arguments: None

Hide the picker.

update

Arguments:

  • date (String|Date, optional)

Update the datepicker with given argument or the current input value.

If date is provided and is a Date object, it is assumed to be a “local” date object, and will be converted to UTC for internal use.

$('.datepicker').datepicker('update');
$('.datepicker').datepicker('update', '2011-03-05');
$('.datepicker').datepicker('update', new Date(2011, 2, 5));

To reset the datepicker and clear the selected date, pass an empty string with update:

$('.datepicker').datepicker('update', '');

setDate

Arguments:

  • date (Date)

Sets the internal date. date is assumed to be a “local” date object, and will be converted to UTC for internal use.

setUTCDate

Arguments:

  • date (Date)

Sets the internal date. date is assumed to be a UTC date object, and will not be converted.

setDates

Arguments:

  • date[, date[, …]] (Date)

or

  • [date[, date[, …]]] (Array)

Sets the internal date list; accepts multiple dates or a single array of dates as arguments. Each date is assumed to be a “local” date object, and will be converted to UTC for internal use. For use with multidate pickers.

clearDates

Arguments: None

Clear dates.

setUTCDates

Arguments:

  • date[, date[, …]] (Date)

or

  • [date[, date[, …]]] (Array)

Sets the internal date list. Each date is assumed to be a UTC date object, and will not be converted. For use with multidate pickers.

getDate

Arguments: None

Returns a localized date object representing the internal date object of the first datepicker in the selection. For multidate pickers, returns the latest date selected.

getUTCDate

Arguments: None

Returns the internal UTC date object, as-is and unconverted to local time, of the first datepicker in the selection. For multidate pickers, returns the latest date selected.

getDates

Arguments: None

Returns a list of localized date objects representing the internal date objects of the first datepicker in the selection. For use with multidate pickers.

getUTCDates

Arguments: None

Returns the internal list of UTC date objects, as they are and unconverted to local time, of the first datepicker in the selection. For use with multidate pickers.

getStartDate

Arguments: None

Returns the lower date limit on the datepicker.

getEndDate

Arguments: None

Returns the upper date limit on the datepicker.

setStartDate

Arguments:

  • startDate (Date)

Sets a new lower date limit on the datepicker. See showOnFocus for valid values.

Omit startDate (or provide an otherwise falsey value) to unset the limit.

setEndDate

Arguments:

  • endDate (Date)

Sets a new upper date limit on the datepicker. See disableTouchKeyboard for valid values.

Omit endDate (or provide an otherwise falsey value) to unset the limit.

setDatesDisabled

Arguments:

  • datesDisabled (String|Array)

Sets the days that should be disabled. See defaultViewDate for valid values.

Omit datesDisabled (or provide an otherwise falsey value) to unset the disabled days.

setDaysOfWeekDisabled

Arguments:

  • daysOfWeekDisabled (String|Array)

Sets the days of week that should be disabled. See datesDisabled for valid values.

Omit daysOfWeekDisabled (or provide an otherwise falsey value) to unset the disabled days.

setDaysOfWeekHighlighted

Arguments:

  • daysOfWeekHighlighted (String|Array)

Sets the days of week that should be highlighted. See daysOfWeekHighlighted for valid values.

Omit daysOfWeekHighlighted (or provide an otherwise falsey value) to unset the disabled days.