date_picker 0.0.6 → 0.0.7

data/test/dummy/vendor/assets/components/eonasdan-bootstrap-datetimepicker/docs/ContributorsGuide.md

@@ -0,0 +1,126 @@
+This guide is aimed to contributors wishing to understand the internals of the code in order to change/evolve the component. 
+
+**Note:** this guide refers to **version 4** which is currently in beta and will be updated as we progress
+
+## Introduction
+This component consists actually of 2 subcomponent UI widgets one for the date and one for the time selection process. The developers can configure which of those are needed and also the granularity that the component will allow the users to select a date/time. Developers also choose the format that the selected datetime will be displayed in the input field.
+The component uses on `jQuery`, `moment.js` and `bootstrap` libraries.
+
+## Code
+### Private variables
+
+* `element` - Holds the DOM element this instance is attached to
+
+* `options` - Holds an object with the curently set options for the specific instance of the component. Don't directly change the properties of that object use the public API methods instead. DO NOT expose this object or its properties outside of the component.
+
+* `picker` - Reference variable to the created instance `(this)`
+
+* `date` - Holds the moment object for the model value of the component. **DON'T** directly change this variable unless you **REALLY** know what you are doing. Use `setValue()` function to set it. It handles all component logic for updating the model value and emitting all the appropriate events
+
+* `viewDate` - Holds the currently selected value that the user has selected through the widget. This is not the model value this is the view value. Changing this usually requires a subsequent call to `update()` function
+
+* `unset` - A `boolean` variable that holds wheather the components model value is set or not. Model's value starts as `unset = true` and if is either set by the user or programmatically through the api to a valid value then it is set to `false`. If subsequent events lead to an invalid value then this variable is set to `true` again. Setting this variable usually takes place in the `setValue()` function.
+
+* `input` - Hold the DOM input element this instance is attached to
+
+* `component` - Holds a reference to the .input-group DOM element that the widget is attached or false if it is attached directly on an input field
+
+* `widget` - Holds a reference to the DOM element containing the widget or `false` if the widget is hidden
+
+* `use24hours` - Holds whether the component uses 24 hours format or not. This is initialized on the `format()` function
+
+* `minViewModeNumber` - Holds the Numeric equivelant of the options.minViewMode parameter
+
+* `format` - Holds the current format string that is used for formating the date model value. Note this is not the same thing as the `options.format` as the second could be set to `false` in which case the first takes the locale's `L` or `LT` value
+
+* `currentViewMode` - Hold the state of the current viewMode for the DatePicker subcomponent
+
+* `actions` - An object containing all the functions that can be called when the users clicks on the widget
+
+* `datePickerModes` - An array of objects with configuration parameters for the different views of the DatePicker subcomponent
+
+* `viewModes` - An array of strings containing all the possible strings that `options.viewMode` can take through `viewMode()` public api function
+
+* `directionModes` - An array of strings containing all the possible strings that `options.direction` can take through `direction()` public api function
+
+* `orientationModes` - An array of strings containing all the possible strings that `options.orientation` can take through `orientation()` public api function
+
+### Private functions
+
+#### Widget related
+
+* `getDatePickerTemplate()` - returns a string containing the html code for the date picker subcomponent
+
+* `getTimePickerTemplate()` - returns a string containing the html code for the time picker subcomponent
+
+* `getTemplate()` - returns a string with containing the html code for all the DateTimePicker component
+
+* `place()` - handles the placement of the widget's dropdown
+
+* `updateMonths()` - updates the html subpage related to the months for Date picker view
+
+* `updateYears()` - updates the html subpage related to the years for Date picker view
+
+* `fillDate()` - updates the html subpage related to the days for Date picker view
+
+* `fillHours()` - Creates the hours spans for the hours subview of the Time subcomponent
+
+* `fillMinutes()` - Creates the minutes spans for the hours subview of the Time subcomponent
+
+* `fillSeconds()` - Creates the seconds spans for the hours subview of the Time subcomponent
+
+* `fillTime()` - Creates the main subview of the Time subcomponent
+
+* `update()` - updates the UI of part of the widget
+
+* `fillDow()` - Creates the day names in the days subview on the Date subcomponent
+
+* `fillMonths()` - Creates the month spans for the months subview of the Date subcomponent
+
+* `createWidget()` - creates the UI widget end attaches widget event listeners
+
+* `destroyWidget()` - destroys the UI widget DOM element and detaches widget event listeners
+
+* `showMode(dir)` - toggles between the various subpage related views of the DateTimePicker
+
+#### Events related
+
+* `notifyEvent(e)` - Use this function when you want to send en event to listener this could be used as a filter later
+
+* `stopEvent(e)` - Shortcut for stopping propagation of events
+
+* `doAction(e)` - Proxy function to call all the UI related click events
+
+* `keydown(e)` - Function to trap 
+
+* `change(e)` - Listener function to track change events occuring on the `input` dom element the component is attached to
+
+* `attachDatePickerElementEvents()` - Attaches listeners to the existing DOM elements the component is attached to. Called upon construction of each datetimepicker instance
+
+* `detachDatePickerElementEvents()` - Detaches listeners from the DOM element the component is attached to. Called on `destroy()`
+
+* `attachDatePickerWidgetEvents()` - Attaches listeners on the components widget. Called on `show()`
+
+* `detachDatePickerWidgetEvents()` - Detaches listeners on the components widget. Called on `hide()`
+
+#### Model related
+
+* `setValue(targetMoment)` - Sets the model value of the component takes a moment object. An `error` event will be emmited if the `targetMoment` does not pass the configured validations. Otherwise the `date` variable will be set and the relevant events will be fired.
+
+* `isValid(targetMoment, granularity)` - returns `true` if the `targetMoment` moment object is valid according to the components set validation rules (`min/maxDates`, `disabled/enabledDates` and `daysOfWeekDisabled`). You may pass a second variable to check only up the the specific granularity `year, month, day, hour, minute, second`
+
+#### Utilities
+
+* `indexGivenDates (givenDatesArray)` - Function that takes the array from `enabledDates()` and `disabledDates()` public functions and stores them as object keys to enable quick lookup
+
+* `isInEnableDates(date)` - Checks whether if the given moment object exists in the `options.enabledDates` object
+
+* `isInDisableDates(date)` - Checks whether if the given moment object exists in the `options.disabledDates` array
+
+* `dataToOptions()` - Parses `data-date-*` options set on the input dom element the component is attached to and returns an object with them
+
+* `isInFixed()` - Checks if the dom element or its parents has a fixed position css rule.
+
+* `parseInputDate(date)` - Parses a date parameter with moment using the component's `options.format` and `options.useStrict`. It returns a `moment` object or false if `parsedMoment#isValid()` returns `false`. Use this to parse date inputs from outside the component (public API calls).
+
+* `init()` - Initializes the component. Called when the component instance is created

data/test/dummy/vendor/assets/components/eonasdan-bootstrap-datetimepicker/docs/Events.md

@@ -0,0 +1,96 @@
+## Events
+
+### dp.hide
+
+Fired when the widget is hidden.
+
+Parameters:
+
+```
+e = {
+    date //the currently set date. Type: moment object (clone)
+}
+```
+
+Emitted from:
+
+* toggle()
+* hide()
+* disable()
+
+----------------------
+
+### dp.show
+
+Fired when the widget is shown.
+
+Parameters:
+
+No parameters are include, listen to `dp.change` instead
+
+Emitted from:
+
+* toggle()
+* show()
+
+----------------------
+
+### dp.change
+
+Fired when the date is changed.
+
+Parameters:
+
+```
+e = {
+    date, //date the picker changed to. Type: moment object (clone)
+    oldDate //previous date. Type: moment object (clone) or false in the event of a null
+}
+```
+
+Emitted from:
+
+* toggle() **Note**: Only fired when using `useCurrent`
+* show() **Note**: Only fired when using `useCurrent` or when or the date is changed to comply with date rules (min/max etc)
+* date(newDate)
+* minDate(minDate)
+* maxDate(maxDate)
+* daysOfWeekDisabled()
+
+----------------------
+
+### dp.error
+
+Fired when a selected date fails to pass validation.
+
+Parameters:
+
+```
+e = {
+    date //the invalid date. Type: moment object (clone)
+}
+```
+
+Emmited from:
+
+* minDate(minDate)
+* maxDate(maxDate)
+* daysOfWeekDisabled()
+* setValue() *private function*
+
+----------------------
+
+### dp.update
+
+<small>4.14.30</small>
+
+Fired (in most cases) when the `viewDate` changes. E.g. Next and Previous buttons, selecting a year.
+
+Parameters:
+
+```
+e = {
+   change, //Change type as a momentjs format token. Type: string e.g. yyyy on year change
+   viewDate //new viewDate. Type: moment object
+}
+```

data/test/dummy/vendor/assets/components/eonasdan-bootstrap-datetimepicker/docs/Extras.md

@@ -0,0 +1,95 @@
+# Extras
+
+Guides for making the picker work better with rails, IE, etc
+
+## Rails 3
+
+by [dhulihan](https://github.com/dhulihan)
+
+You can easily override the default rails form helpers (`date_select` and `datetime_select`) with bootstrap-datetimepicker for a much nicer experience. 
+
+```rb
+# Add to config/initializers/form.rb or the end of app/helpers/application_helper.rb
+module ActionView
+  module Helpers
+    class FormBuilder 
+      def date_select(method, options = {}, html_options = {})
+        existing_date = @object.send(method) 
+        formatted_date = existing_date.to_date.strftime("%F") if existing_date.present?
+        @template.content_tag(:div, :class => "input-group") do    
+          text_field(method, :value => formatted_date, :class => "form-control datepicker", :"data-date-format" => "YYYY-MM-DD") +
+          @template.content_tag(:span, @template.content_tag(:span, "", :class => "glyphicon glyphicon-calendar") ,:class => "input-group-addon")
+        end
+      end
+
+      def datetime_select(method, options = {}, html_options = {})
+        existing_time = @object.send(method) 
+        formatted_time = existing_time.to_time.strftime("%F %I:%M %p") if existing_time.present?
+        @template.content_tag(:div, :class => "input-group") do    
+          text_field(method, :value => formatted_time, :class => "form-control datetimepicker", :"data-date-format" => "YYYY-MM-DD hh:mm A") +
+          @template.content_tag(:span, @template.content_tag(:span, "", :class => "glyphicon glyphicon-calendar") ,:class => "input-group-addon")
+        end
+      end
+    end
+  end
+end
+```
+
+The time format used here is ActiveRecord-friendly, which means it will be parsed correctly when passed in through `params` to your record.
+
+That's all there is to it! Now all of your forms that use `datetime_select` or `date_select` will be automatically updated:
+
+```erb
+<% form_for @post do |f| %>
+	<div class="form-group">
+		<label>Published At</label>
+		<%= f.datetime_select :published_at %>
+	</div>
+<% end %>
+```
+
+## IE 7
+
+by [EquilibriumCST](https://github.com/EquilibriumCST)
+
+I succeed to run this widget under IE7.
+Here is what I did.
+
+1. gliphicons are not working under IE7 so add [this css file](https://github.com/coliff/bootstrap-ie7). And this enables the icons.
+
+2. Z-index problem with IE 7. I added position: relative and `z-index: 10` to the parent container. Otherwise popup is shown under the next elements.
+
+3. JS events were not working well. 
+
+If you open the datetimepicker widget and click on some button or date inside it, widget is automatically closed.
+So I added `debug: true` as an option when initializing the widget. Why I did this? I saw on line 1121 from bootsrap-datetimepicker.js the code `'blur': options.debug ? '' : hide`. 
+And now widget window is not closed on every click inside it, but now you can't close it anyway :) 
+And closing should be done manually. I've added this document click handler. If you click something outside the widget, now closing works.
+
+```
+$(document).click(function(e){
+			var target = $(e.target);
+			if(target.parents('.bootstrap-datetimepicker-widget').length < 1 && !target.hasClass('datetimepickerInput') && !target.hasClass('datepickerIcon') && !target.hasClass('clockpickerIcon')){
+				if($('.bootstrap-datetimepicker-widget').length > 0){
+					$('#startDate').data('DateTimePicker').hide();
+					$('#startTime').data('DateTimePicker').hide();
+					$('.datetimepickerInput').blur();
+				}
+			}
+		});
+```
+
+
+But if you have more than one widget on the page like I did, clicking on one widget does'n close the other. Added below lines and now all works fine.
+
+```
+$('#widget1').on("dp.show",function (e) {
+	$('#widget2).data('DateTimePicker').hide();
+});
+
+$('#widget2').on("dp.show",function (e) {
+	$('#widget1).data('DateTimePicker').hide();
+});
+```
+
+I hope this will help to the others who are fighting with the old IE versions :)

data/test/dummy/vendor/assets/components/eonasdan-bootstrap-datetimepicker/docs/FAQ.md

@@ -0,0 +1,22 @@
+# FAQs
+
+# How do I disable the date or time element
+<small>How do I format ...; How do I add seconds; etc.</small>
+
+The picker uses the `format` option to decide what components to show. Set `format` to `LT`, `LTS` or another valid [MomentJs format string](http://momentjs.com/docs/#/displaying/format/) to display certain components
+
+# How do I change the language/locale
+
+The picker uses MomentJs to determine the language string. You can use `moment-with-locales` or you can include whatever local file you need. Set the picker's `locale` option to `de` or whatever the locale string is.
+
+# How do I change the styles? The picker closes.
+
+Set `debug:true` which will force the picker to stay open, even `onBlur`. You can hide the picker manually by calling `hide()`
+
+# How do I change the start of the week?
+
+Start of the week is based on the [`locale` provided](Options.md#locale). This is defined by moment's locales. If you want to change it, create your own locale file or override. [See moment's docs](http://momentjs.com/docs/#/i18n/).
+
+# How I use the picker as birthday picker?
+
+Use the [`viewMode`](Options.md#viewmode) option to `'years'`

data/test/dummy/vendor/assets/components/eonasdan-bootstrap-datetimepicker/docs/Functions.md

@@ -0,0 +1,670 @@
+## Functions
+
+<div class="alert alert-info">
+    <strong>Note</strong>
+    All functions are accessed via the <code>data</code> attribute e.g. <code>$('#datetimepicker').data("DateTimePicker").FUNCTION()</code>
+</div>
+
+###destroy()
+
+Destroys the widget and removes all attached event listeners
+
+----------------------
+
+### toggle()
+
+Shows or hides the widget
+
+#### Emits
+
+* `dp.hide` - if the widget is hidden after the toggle call
+
+* `dp.show` - if the widget is show after the toggle call
+
+* `dp.change` - if the widget is opened for the first time and the input element is empty and `options.useCurrent != false`
+
+----------------------
+
+### show()
+
+Shows the widget
+
+#### Emits
+
+* `dp.show` - if the widget was hidden before that call
+
+* `dp.change` - if the widget is opened for the first time and the useCurrent is set to true or to a granularity value and the input element the component is attached to has an empty value
+
+----------------------
+
+### hide()
+
+Hides the widget
+
+#### Emits
+
+* `dp.hide` - if the widget was visible before that call
+
+----------------------
+
+### disable()
+
+Disables the input element, the component is attached to, by adding a `disabled="true"` attribute to it. If the widget was visible before that call it is hidden.
+
+#### Emits
+
+* `dp.hide` - if the widget was visible before that call
+
+----------------------
+
+### enable()
+
+Enables the input element, the component is attached to, by removing `disabled` attribute from it.
+
+----------------------
+
+
+### date
+
+####date()
+
+ Returns the component's model current date, a `moment` object or `null` if not set.
+
+####date([newDate])
+
+ Takes `string, Date, moment, null` parameter and sets the components model current moment to it. Passing a `null` value unsets the components model current moment. Parsing of the newDate parameter is made using moment library with the `options.format` and `options.useStrict` components configuration.
+
+##### Throws
+
+* `TypeError` - in case the `newDate` cannot be parsed
+
+##### Emits
+
+* `dp.change` - In case `newDate` is different from current moment
+
+### en/disabledDates
+
+#### disabledDates()
+
+Returns an array with the currently set disabled dates on the component.
+
+#### disabledDates(dates)
+
+Takes an `[` `string` or `Date` or `moment` `]` of values and disallows the user to select those days. Setting this takes precedence over `options.minDate`, `options.maxDate` configuration. Also calling this function removes the configuration of options.enabledDates if such exist.
+
+**Note:** These values are matched with `Day` granularity.
+
+----------------------
+
+#### enabledDates()
+
+Returns an array with the currently set enabled dates on the component.
+
+
+#### enabledDates(dates)
+
+Takes an `[` `string` or `Date` or `moment` `]` of values and allows the user to select only from those days. Setting this takes precedence over `options.minDate`, `options.maxDate` configuration. Also calling this function removes the configuration of options.disabledDates if such exist.
+
+**Note:** These values are matched with `Day` granularity.
+
+----------------------
+
+### defaultDate
+
+#### defaultDate()
+
+Returns a `moment` with the `options.defaultDate` option configuration or `false` if not set
+
+#### defaultDate(defaultDate)
+
+Takes a `string, Date, moment, boolean:false`. Will set the picker's inital date. If a `boolean:false` value is passed the `options.defaultDate` parameter is cleared. 
+
+* `TypeError` - if the provided date pass validation, including `disabledDates`, `enabledDates`, `minDate`, `maxDate`, and `daysOfWeekDisabled`
+
+* `TypeError` - if the provided date cannot be parsed by momentjs
+
+----------------------
+
+### useCurrent
+
+#### useCurrent()
+
+Returns a `boolean` or `string` with the `options.useCurrent` option configuration
+
+#### useCurrent(boolean or string)
+
+Takes a `boolean` or `string`. If a `boolean` true is passed and the components model moment is not set (either through `setDate` or through a valid value on the input element the component is attached to) then the first time the user opens the datetimepicker widget the value is initialized to the current moment of the action. If a false `boolean` is passed then no initialization happens on the input element. You can select the granularity on the initialized moment by passing one of the following strings (`'year', 'month', 'day', 'hour', 'minute'`) in the variable.
+
+If for example you pass `'day'` to the `setUseCurrent` function and the input field is empty the first time the user opens the datetimepicker widget the input text will be initialized to the current datetime with day granularity (ie if currentTime = `2014-08-10 13:32:33` the input value will be initialized to `2014-08-10 00:00:00`)
+
+**Note:** If the `options.defaultDate` is set or the input element the component is attached to has already a value that takes precedence and the functionality of `useCurrent` is not triggered!
+
+----------------------
+
+### min/maxDate
+
+#### minDate()
+
+Returns the currently set moment of the `options.minDate` or `false` if not set
+
+#### minDate(minDate)
+
+Takes a minDate `string, Date, moment, boolean:false` parameter and disallows the user to select a moment that is before that moment. If a `boolean:false` value is passed the `options.minDate` parameter is cleared and there is no restriction to the miminum moment the user can select. 
+
+**Note:** If the minDate parameter is after the currently selected moment the currently selected moment changes to minDate parameter
+
+##### Throws
+
+* `TypeError` - if minDate parameter cannot be parsed using the `options.format` and `options.useStrict` configuration settings
+
+* `TypeError` - if minDate parameter is after `options.maxDate`
+
+##### Emits
+
+* `dp.change` - if the new minDate is after currently selected moment (waiting for #472 to close in order to finalize this part)
+
+* `dp.error` - if the new minDate is after currently selected moment (waiting for #472 to close in order to finalize this part)
+
+----------------------
+
+#### maxDate()
+
+Returns the currently set moment of the `options.maxDate` or `false` if not set
+
+
+#### maxDate(maxDate)
+
+Takes a maxDate `string, Date, moment, boolean:false` parameter and disallows the user to select a moment that is after that moment. If a `boolean:false` value is passed `options.maxDate` is cleared and there is no restriction to the maximum moment the user can select.
+
+**Note:** If maxDate is before the currently selected moment the currently selected moment changes to maxDate
+
+##### Throws
+
+* `TypeError` - if maxDate parameter cannot be parsed using the `options.format` and `options.useStrict` configuration settings
+
+* `TypeError` - if maxDate parameter is before `options.minDate`
+
+##### Emits
+
+* `dp.change` - if the new maxDate is after currently selected moment  (waiting for #472 to close in order to finalize this part)
+
+* `dp.error` - if the new maxDate is after currently selected moment  (waiting for #472 to close in order to finalize this part)
+
+----------------------
+
+### daysOfWeekDisabled
+
+#### daysOfWeekDisabled()
+
+Returns an array with the `options.daysOfWeekDisabled` configuration setting of the component.
+
+#### daysOfWeekDisabled(daysOfWeek)
+
+Takes an `[` `Number`:`0` to `6` `]` and disallow the user to select weekdays that exist in this array. This has lower priority over the `options.minDate`, `options.maxDate`, `options.disabledDates` and `options.enabledDates` configuration settings.
+
+##### Emits
+
+* `dp.change` - if the currently selected moment falls in the values passed on the daysOfWeek parameter. (waiting for #472 to close in order to finalize this part)
+
+* `dp.error` - if the currently selected moment falls in the values passed on the daysOfWeek parameter. (waiting for #472 to close in order to finalize this part)
+
+----------------------
+
+### options
+
+####options()
+
+Returns the components current options object. Note that the changing the values of the returned object does not change the components actual configuration. Use `options(options)` to set the components options massively or the other methods for setting config options individually.
+
+
+#### options([options])
+
+Takes an object variable with option key:value properties and configures the component. Use this to update multiple options on the component.
+
+----------------------
+
+### format
+
+#### format()
+
+Returns the component's `options.format` `string`
+
+
+#### format(format)
+
+Takes a [moment.js](http://momentjs.com/docs/#/displaying/format/) format `string` and sets the components  `options.format`. This is used for displaying and also for parsing input strings either from the input element the component is attached to or the `date()` function.
+The parameter can also be a `boolean:false` in which case the format is set to the locale's `L LT`.
+
+**Note:** this is also used to determine if the TimePicker sub component will display the hours in 12 or 24 format. (if 'a' or 'h' exists in the passed `string` then a 12 hour mode is set)
+
+----------------------
+
+### extraFormats
+
+#### extraFormats()
+
+Returns a `boolean` or array with the `options.extraFormats` option configuration
+
+#### extraFormats(formats)
+
+Takes an array of valid input moment format options.  See PR #666
+
+----------------------
+
+### locale
+
+#### locale()
+
+Returns the currently set locale of the `options.locale`
+
+#### locale(newLocale)
+
+Takes a `string` of any valid [moment locale](https://github.com/moment/moment/tree/develop/locale) e.g. `de` for German.
+
+##### Throws
+
+* `TypeError` - if the locale is not loaded via a separate script or `moment-with-locales`
+
+----------------------
+
+### stepping
+
+#### stepping()
+
+Returns a `number` with the `options.stepping` option configuration
+
+
+#### stepping(number)
+
+Takes a `number`. This be the amount the up/down arrows move the minute value with a time picker.
+
+----------------------
+
+### sideBySide and collapse
+
+#### sideBySide()
+
+Returns a `boolean` of the `options.sideBySide`.
+
+
+#### sideBySide(sideBySide)
+
+Takes a `boolean`. If `sideBySide` is `true` and the time picker is used, both components will display side by side instead of collapsing.
+
+----------------------
+
+#### collapse()
+
+Returns a `boolean` with the `options.collapse` option configuration
+
+#### collapse(collapse)
+
+Takes a `boolean`. If set to `false` the picker will display similar to `sideBySide` except vertical.
+
+----------------------
+
+### icons
+
+#### icons()
+
+Returns an `Ojbect` of `options.icons` 
+
+#### icons(icons)
+
+Takes an `Ojbect` of `strings`.
+
+##### Throws
+
+* `TypeError` - if icons parameter is not an `Ojbect`
+
+----------------------
+
+### useStrict
+
+#### useStrict()
+
+Returns a `boolean` of the `options.useStrict`
+
+#### useStrict(useStrict)
+
+Takes a `boolean`. If `useStrict` is `true`, momentjs parsing rules will be stricter when determining if a date is valid or not.
+
+----------------------
+
+### widgetPositioning
+
+#### widgetPositioning()
+
+Returns the currently set `options.widgetPositioning` object containing two keys `horizontal` and `vertical`
+
+
+#### widgetPositioning(positioningObject)
+
+Takes an object parameter that can contain two keys `vertical` and `horizontal` each having a value of `'auto', 'top', 'bottom'` for `vertical` and `'auto', 'left', 'right'` for `horizontal` which defines where the dropdown with the widget will appear relative to the input element the component is attached to.
+
+`'auto'` is the default value for both `horizontal` and `vertical` keys and it tries to automatically place the dropdown in a position that is visible to the user. Usually you should not override those options unless you have a special need in your layout.
+
+----------------------
+
+### viewMode
+
+#### viewMode()
+
+Returns a `string` of the `options.viewMode`.
+
+#### viewMode(newViewMode)
+
+Takes a `string`. Valid values are `'days'`, `'months'`, `'years'` and `'decades'`
+
+##### Throws
+
+* `TypeError` - if `newViewMode` parameter is not an a `string` or if `newViewMode` is not a valid value
+
+----------------------
+
+### calendarWeeks
+
+#### calendarWeeks()
+
+Returns a `boolean` with the current `options.calendarWeeks` option configuration
+
+#### calendarWeeks(boolean)
+
+Takes a `boolean` variable to set if the week numbers will appear to the left on the days view
+
+----------------------
+
+### showClear
+
+#### showClear()
+
+Returns a `boolean` variable with the currently set `options.showClear` option.
+
+#### showClear(boolean)
+
+Takes a `boolean` variable to set if the clear date button will appear on the widget
+
+----------------------
+
+### showTodayButton
+
+#### showTodayButton()
+
+Returns a `boolean` variable with the currently set `options.showTodayButton` option.
+
+
+#### showTodayButton(boolean)
+
+Takes a `boolean` variable to set if the Today button will appear on the widget
+
+----------------------
+
+### toolbarplacement
+
+#### toolbarplacement()
+
+Returns a `string` variable with the currently set `options.toolbarplacement` option.
+
+#### toolbarplacement(string)
+
+Takes a `string` value. Valid values are `'default'`, `'top'` and `'bottom'`.
+
+Changes the placement of the toolbar where the today, clear, component switch icon are located.
+
+----------------------
+
+### dayViewHeaderFormat
+
+#### dayViewHeaderFormat()
+
+Returns a `string` variable with the currently set `options.dayViewHeaderFormat` option.
+
+#### dayViewHeaderFormat(string)
+
+Takes a `string` value.
+
+Used to customize the header of the day view.
+
+----------------------
+
+### keyBinds
+
+#### keyBinds()
+
+Returns a `string` variable with the currently set `options.keyBinds` option.
+
+#### keyBinds(object)
+
+Takes an `object` value.
+
+Allows for several keyBinding functions to be specified for ease of access or accessibility. See the options page for defaults.
+
+----------------------
+
+### clear()
+
+Clears the datepicker by setting the value to `null`
+
+----------------------
+
+### inline
+
+#### inline()
+
+Returns a `boolean` variable with the currently set `options.inline` option.
+
+#### inline(boolean)
+
+Takes a `boolean` value.
+
+Used to customize the header of the day view.
+
+----------------------
+
+### ignoreReadonly
+
+#### ignoreReadonly()
+
+Returns a `boolean` variable with the currently set `options.ignoreReadonly` option.
+
+#### ignoreReadonly(boolean)
+
+Takes a `boolean` value.
+
+Set this to `true` to allow the picker to be used even if the input field is `readonly`. This will **not** bypass the `disabled` property
+
+----------------------
+
+### showClose
+
+#### showClose()
+
+Returns a `boolean` variable with the currently set `options.showClose` option.
+
+#### showClose(boolean)
+
+Takes a `boolean` value.
+
+If `true`, an icon will be displayed on the toolbar that will hide the picker
+
+----------------------
+
+### debug
+
+For the moment this function will only prevent the picker from calling `hide()` on `blur` so that the picker can be inspected.
+
+----------------------
+
+### keepInvalid
+
+<small>4.7.14</small>
+
+#### keepInvalid()
+
+Returns a `string` variable with the currently set `options.keepInvalid` option.
+
+#### keepInvalid(boolean)
+
+Takes a `boolean` value.
+
+If `true`, invalid dates will not be reverted to a previous selection or changed.
+
+----------------------
+
+### allowInputToggle
+
+ <small>4.7.14</small>
+
+#### allowInputToggle()
+
+Returns a `boolean` variable with the currently set `options.allowInputToggle` option.
+
+#### allowInputToggle(boolean)
+
+Takes a `boolean` value.
+
+If `true`, the picker will show on textbox focus and icon click when used in a button group
+
+----------------------
+
+### focusOnShow
+
+<small>4.14.30</small> PR #884
+
+#### focusOnShow()
+
+Returns a `boolean` variable with the currently set `options.focusOnShow` option.
+
+#### focusOnShow(boolean)
+
+Takes a `boolean` value.
+
+If `false`, the textbox will not be given focus when the picker is shown
+
+
+----------------------
+
+### disabledTimeIntervals
+
+<small>4.14.30</small> Issue: #644
+
+#### disabledTimeIntervals()
+
+Returns an `array` variable with the currently set `options.disabledTimeIntervals` option.
+
+#### disabledTimeIntervals(array)
+
+Takes a `array` value.
+
+The array **must** be in the following format `[moment(),moment()]`
+
+For example:
+
+    disabledTimeIntervals: [[moment({ h: 0 }), moment({ h: 8 })], [moment({ h: 18 }), moment({ h: 24 })]]
+
+Will disable times between 12-8am and 6-12pm today
+
+----------------------
+
+### en/disabledHours
+
+<small>4.14.30</small> Issue: #851
+
+#### disabledHours()
+
+Returns an `array` variable with the currently set `options.en/disabledHours` option.
+
+#### disabledHours(boolean)
+
+Takes a `array` value.
+
+Must be in 24 hour format. Will allow or disallow hour selections (much like `disabledTimeIntervals`) but will affect all days.
+
+Like `en/disabledDates`, these options are mutually exclusive and will reset one of the options back to false.
+
+    disabledHours: [0, 1, 2, 3, 4, 5, 6, 7, 8, 18, 19, 20, 21, 22, 23, 24]
+    enabledHours: [9, 10, 11, 12, 13, 14, 15, 16]
+
+----------------------
+
+### viewDate
+
+<small>4.14.30</small> Issue #872
+
+#### viewDate()
+
+Returns a `moment` variable with the currently set `options.viewDate` option.
+
+#### viewDate(viewDate)
+
+Takes a `string, moment or Date` value.
+
+This will change the `viewDate` without changing or setting the selected date.
+
+### parseInputDate
+<small>4.14.30</small> Issue #1095
+
+#### parseInputDate()
+
+Returns a `function` with the currently set `options.parseInputDate`
+
+#### parseInputDate(function)
+
+Takes a `function`
+
+Allows custom input formatting For example: the user can enter 'yesterday' or '30 days ago'.
+
+Example:
+
+```
+var parseRelativeDate = function(relativeDate) {
+
+    switch (relativeDate) {
+        case 'today':
+            return moment()
+        case 'yesterday':
+            return moment().subtract(1, 'day');
+        default:
+            return moment()
+                .subtract(Number(relativeDate.replace("days ago", "").trim()), 'days');
+    }
+}
+
+var parseInputDate = function(inputDate) {
+    var relativeDatePattern = /today|yesterday|[0-9]+\s+(days ago)/,
+        resultDate;
+
+    if (moment.isMoment(inputDate) || inputDate instanceof Date) {
+        resultDate = moment(inputDate);
+    } else {
+        var relativeDate = inputDate.match(relativeDatePattern),
+            parseDate = null;
+
+        if (relativeDate !== null) 
+          parseDate = this.parseRelativeDate(inputDate.match(relativeDatePattern)[0]);
+        else 
+          parseDate = moment();
+
+        resultDate = moment(parseDate, "YYYY-MM-DD");
+    }
+
+    return resultDate;
+}
+```
+
+----------------------
+
+### tooltips
+<small>4.14.30</small> 
+
+#### tooltips()
+
+Returns an `Ojbect` of `options.tooltips` 
+
+#### tooltips(tooltips)
+
+Takes an `Ojbect` of `strings`.
+
+##### Throws
+
+* `TypeError` - if tooltips parameter is not an `Ojbect`