jquery.timepicker is a timepicker plugin for jQuery inspired by Google Calendar. It supports both mouse and keyboard navigation.
- jQuery (>= 1.6 recommended; jquery-timepicker has not been tested on 1.5)
$('.some-time-inputs').timepicker(options);
options
is an optional javascript object with parameters explained below.
-
className A class name to apply to the HTML element that contains the timepicker dropdown. default: null
-
minTime The time that should appear first in the dropdown list. default: 12:00am
-
maxTime The time that should appear last in the dropdown list. Can be used to limit the range of time options. default: 24 hours after minTime
-
showDuration Shows the relative time for each item in the dropdown.
minTime
ordurationTime
must be set. default: false -
durationTime The time against which
showDuration
will compute relative times. default: minTime -
step The amount of time, in minutes, between each item in the dropdown. default: 30
-
timeFormat How times should be displayed in the list and input element. Uses PHP's date() formatting syntax. default: 'g:ia'
-
scrollDefaultNow If no time value is selected, set the dropdown scroll position to show the current time. default: false
-
getTime Get the time using a Javascript Date object, relative to today's date.
$('#getTimeExample').timepicker('getTime');
You can get the time as a string using jQuery's built-in
val()
function:$('#getTimeExample').val();
-
getSecondsFromMidnight Get the time as an integer, expressed as seconds from 12am.
$('#getTimeExample').timepicker('getSecondsFromMidnight');
-
setTime Set the time using a Javascript Date object.
$('#setTimeExample').timepicker('setTime', new Date());
-
showTimepicker Called when the timepicker is shown.
-
hideTimepicker Called when the timepicker is closed.
-
changeTime Called when a time value is selected. default: null
This software is made available under the open source MIT License. © 2012 Jon Thornton, contributions from Anthony Fojas, Vince Mi, Nikita Korotaev, Spoon88, elarkin