snipe-it/bower_components/bootstrap-datepicker/docs/methods.rst
2017-01-11 03:05:06 -08:00

222 lines
4.2 KiB
ReStructuredText

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 :ref:`startdate` 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 :ref:`enddate` 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 :ref:`datesDisabled` 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 :ref:`daysofweekdisabled` 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 :ref:`daysOfWeekHighlighted` for valid values.
Omit daysOfWeekHighlighted (or provide an otherwise falsey value) to unset the disabled days.