a angular datetime-picker

Downloads in past


1.0.35 years ago5 years agoMinified + gzip package size for ui.bootstrap.datetimepicker in KB


AngularJs directive to use a date and/or time picker as a dropdown from an input. Demo


To use the directive you must have the following angular-ui bootstrap directives included already
  • DatePicker
  • TimePicker
You should already have the ui.bootstrap dependancy included in your app.js file like below, You then need to add ui.bootstrap.datetimepicker, as so ``` angular.module('app', 'ui.bootstrap', 'ui.bootstrap.datetimepicker'); ``` Download the source from dist/datetime-picker.min.js file and include it in your project. Or use Bower (thank you krico for setup) ``` bower install --save bootstrap-ui-datetime-picker ``` and link with bower_components/bootstrap-ui-datetime-picker/dist/datetime-picker.min.js


You have the following properties available to use with the directive. All are optional unless stated otherwise
  • ngModel (required) - Your date object
  • isOpen - (true/false)
  • closeOnDateSelection (true/false)
  • closeOnTimeNow (true/false)
  • enableDate (true/false)
  • enableTime (true/false)
  • buttonBar (object)
  • initialPicker ('date'/'time')
  • reOpenDefault (false/'date'/'time') - NOTE: true not supported
  • datepickerOptions (object)
  • timepickerOptions (object)
  • defaultTime (string)
  • saveAs (boolean|function|'ISO'|'json'|'number')
  • readAs (boolean|function)
Whether the popup/dropdown is visible or not. Defaults to false
Close popup once a date has been chosen. TimePicker will stay open until user closes.
Close popup once a time has been chosen via now button.
Whether you would like the user to be able to select a date. Defaults to true
Whether you would like the user to be able to select a time. Defaults to true
To show or hide the button bar, or any of the buttons inside it. Defaults to the uiDatetimePickerConfig. Only specify the elements that you want to override, as each button defaults to the uiDatetimePickerConfig setup, if it is not configured on scope of the datetimePicker
The initial picker to open when the control is first pressed
The picker to set as the picker to open once the control has already been opened at least once. Setting to false will default to the date picker if both date and time are enabled, or just the enabled control if only time or date is in use.
Object to configure settings for the datepicker (can be found on angularUI site)
Object to configure settings for the timepicker (can be found on angularUI site)
Initial time when a new date is selected (e.g. "14:00:00" or "2:00 pm")
An callback function to call when the picker dropdown is closed. See demo for more details.
A boolean value to switch saving the Date to the model as a string, or a ngModel.$parsers function to take over the transformation from the Date object to a string. Possible values:
  • true
  • false
  • 'ISO' (Date.toISOString())
  • 'json' (Date.toJSON())
  • 'number' (Date.valueOf())
  • a function accepting a value parameter and returning the converted value to save to the model.
Note: If using an html5 input type, the default parser will use Date.toLocaleString() to convert to a string. To override this, provide a function with your desired formatted conversion. Otherwise all other input types will use the supplied date format.
A boolean value to convert a string (or Date.valueOf()) value back to a Date object from the ngModel, or a ngModel.$formatters function to take over the transformation completely.


Now datetimePicker options are globally set by default. If you do not state the values within the declaration, the config options are used instead. Here are the default options ``` .constant('uiDatetimePickerConfig', {
dateFormat: 'yyyy-MM-dd HH:mm',
defaultTime: '00:00:00',
html5Types: {
date: 'yyyy-MM-dd',
'datetime-local': 'yyyy-MM-ddTHH:mm:ss.sss',
'month': 'yyyy-MM'
initialPicker: 'date',
reOpenDefault: false,
enableDate: true,
enableTime: true,
buttonBar: {
show: true,
now: {
show: true,
text: 'Now',
cls: 'btn-sm btn-default'
today: {
show: true,
text: 'Today',
cls: 'btn-sm btn-default'
clear: {
show: true,
text: 'Clear',
cls: 'btn-sm btn-default'
date: {
show: true,
text: 'Date',
cls: 'btn-sm btn-default'
time: {
show: true,
text: 'Time',
cls: 'btn-sm btn-default'
close: {
show: true,
text: 'Close',
cls: 'btn-sm btn-default'
closeOnDateSelection: true,
closeOnTimeNow: true,
appendToBody: false,
altInputFormats: [],
ngModelOptions: {},
saveAs: false,
readAs: false
}) ```


Personally i dont like the look of the angular-ui calendar itself, this is because the buttons are configured to use the btn-default style. To get round this there are 3 css classes applied to the datetimepicker and depending on the picker that is being shown. These classes surround the div element that contains the angular-ui datepicker and timepicker. Using these classes you can change the style of the calendar. The class are ``` .datetime-picker-dropdown ``` Applied to the dropdown that the pickers are contained within ``` .datetime-picker-dropdown > li.date-picker-menu ``` Applied when the date picker is visible ``` .datetime-picker-dropdown > li.time-picker-menu ``` Applied when the time picker is visible. The buttons in the buttonBars can be overridden by setting the css classes as stated above
For example, if i add this css code, you will see the difference to the calendar in the images below ``` .datetime-picker-dropdown > li.date-picker-menu div > table .btn-default {
border: 0;
} ```
alt tag
alt tag


Here is an example to use the directive with a bootstrap input, displaying a calendar button



<input type="text" class="form-control" datetime-picker="dd MMM yyyy HH:mm" ng-model="myDate" is-open="isOpen"  />
<span class="input-group-btn">
<button type="button" class="btn btn-default" ng-click="openCalendar($event, prop)"><i class="fa fa-calendar"></i></button>



``` app.controller('MyController', function() {
var that = this;
this.isOpen = false;
this.openCalendar = function(e) {
that.isOpen = true;
}); ```


If you do find a bug, can you please create a plunkr to replicate the error before raising an issue. Attach the plunkr as a link to the issue so i can replicate the error and work out a solution.

Pull Requests

If you submit a PR, please test your changes against the demo page to make sure no functionality has been broken.


This was developed using angular-ui bootstrap Version: 1.2.0 - 2016-04-07. If you have a bug, please check what version of angular-ui you are using. If you are using a version prior to this, then please upgrade if you can and try it. If the problem persists, please let me know. I do have a day job but will try to get back to you asap. If you can fix the bug, then let me know how, or even better, submit a pull request.