HexagonJS
About
InstallationCore ConceptsChangelog[Migration (1.x -> 2.x)]
Tutorials
Getting StartedPrint Styles
Demos
Component Demo Page
Css Components
BaseButtonBadgeError PagesFormInputsInput GroupLabelLayoutLogoNoticeSpinnerTable
Js Components
Alerts and MessagesAutocomplete PickerAutocompleteButton GroupCardCollapsibleColor PickerCrumbtrailData TableDate PickerDate Time PickerDrag ContainerDrawingDropdownDropdown ButtonExtended TableFile InputFluidForm BuilderInline EditableInline PickerInline SelectMenuMeterModalMore ButtonNotifyNumber PickerPaginatorPickerPivot TablePlotProgress BarSide CollapsibleSidebarSingle SelectSliderStepperSticky Table HeadersTabsTag InputTime PickerTime SliderTitlebarToggle ButtonToggleTooltipTreeVisualization Bar
Utilities
AnimateClick DetectorColor ScaleColorComponentEvent EmitterFast ClickFilterFormatInterpolateListMapMorph SectionMorphsPalettePointer EventsPreferencesRequestResize EventsSearch DomSelectSelectionSetSortTransitionUser Facing TextUtilView
Date Picker Changelog
2.5.3
Bugfix
Resolve an issue with localisation where non DD/MM/YYYY locales could not have a date entered via the input.
2.1.0
hx.DatePickeroptionsObject
options
dateDate
Added
The date to initialise the date picker with
hx.datePickeroptionsObject
options
v2Features
useInputBoolean
Added
A boolean to toggle the use of an <input> instead of a <div> for the node to apply the datepicker to.
1.18.1
hx.DatePickerextendsEventEmitter
Updated
Updated in preparation for the next major release.
hx.DatePickeroptionsObject
options
v2Features
Added
Added several flags that enable functionality that will be default in version 2.0.0 of Hexagon.
hx.DatePickeroptionsObject
options
allowViewChangeBoolea
Added
Added an option to toggle the ability to view the calendar by year/decade
1.17.0
hx.DatePickeroptionsObject
options
range
Added
#350
Added the ability to set the range when constructing a date picker
hx.DatePickeroptionsObject
options
validRange
Added
#350
Added the ability to set the valid range when constructing a date picker
hx.DatePicker
localeString
Updated
#468
Updated the locale method to allow per-instance locales and un-deprecated the locale methods
1.16.0
Bugfix
Fixed an issue where the default calendar display was showing Sunday as the week start instead of Monday as dictated by ISO standards and an issue where momentjs was using the browser locale instead of the currently set locale to calculate the week start.
1.15.0
Bugfix
Fixed an issue where IE was displaying the datepicker calendar in compact mode
1.13.0
Bugfix
Resolved an issue with the styles that was causing the 'year' selection to display incorrectly
1.11.0
Bugfix
#378
Resolved an issue with how the timezones worked when not in UTC
1.1.0
Bugfix
#35
Update the icon styles for range pickers so they aren't inconsistent
hx.DatePickerextendsEventEmitter
Updated
#23#24
Date pickers now listen for changes in hx.preferences.locale and hx.preferences.timezone and automatically update
1.0.0
hx.DatePicker
disableDatePicker
Removed
Use disabled(true) instead.
hx.DatePicker
enableDatePicker
Removed
Use disabled(false) instead.
hx.datePickerSelection
Added
Fluid api version of DatePicker
0.15.3
hx.DatePicker
disableDatePicker
Deprecated
Use disabled(true) instead.
hx.DatePicker
enableDatePicker
Deprecated
Use disabled(false) instead.
0.15.2
hx.DatePickeroptionsObject
options
disabledBoolean
Updated
Added the ability to disable a date picker in the options
hx.DatePicker
disableDatePicker
Deprecated
Use disabled(true) instead.
hx.DatePicker
enableDatePicker
Deprecated
Use disabled(false) instead.
hx.DatePicker
disabledDatePicker
Added
Added the ability to disable/enable a date picker
hx.DatePicker
disabledBoolean
Added
Added the ability to get the disabled state of a date picker
0.14.1
Bugfix
Fixed an issue where the events were firing out of order.
0.14.0
hx.DatePicker
Removed
Use hx.DatePicker(selector, options) instead.
hx.DatePicker
showMonthDatePicker
Removed
Use datepicker.visibleMonth instead (method has been renamed to make its purpose clearer)
hx.DatePicker
addDaysDatePicker
Removed
Use datepicker.day(datepicker.day() + days) instead
hx.DatePicker
addMonthsDatePicker
Removed
Use datepicker.month(datepicker.month() + months) instead
hx.DatePicker
addYearsDatePicker
Removed
Use datepicker.year(datepicker.year() + years) instead
hx.DatePicker
updateDatePicker
Removed
Use locale(locale) instead.
hx.DatePicker
dateDatePicker
Removed
The suppressCallback parameter has been deprecated. Use datepicker.suppressed(eventName, suppress) to suppress events. This is part of the Event Emitter api.
The dontSetupInput paramater has been deprecated. There is no alternative to this parameter.
hx.DatePicker
dayDatePicker
Removed
The suppressCallback parameter has been deprecated. Use datepicker.suppressed(eventName, suppress) to suppress events. This is part of the Event Emitter api
hx.DatePicker
monthDatePicker
Removed
The suppressCallback parameter has been deprecated. Use datepicker.suppressed(eventName, suppress) to suppress events. This is part of the Event Emitter api
hx.DatePicker
yearDatePicker
Removed
The suppressCallback parameter has been deprecated. Use datepicker.suppressed(eventName, suppress) to suppress events. This is part of the Event Emitter api
hx.DatePicker
rangeDatePicker
Removed
Use range(range, dontSetupInput) instead.
hx.DatePicker
validRangeDatePicker
Removed
Use validRange(obj) instead
0.13.0
hx.DatePickerextendsEventEmitter
Updated
Updated the internals of the datepicker to make it more consistent (and less confusing). As part of this, multiple api changes have been made, including changes to the way events are suppressed and handled.
hx.DatePicker
Updated
Added options for initialising the datepicker as disabled or preventing the inbuilt datepicker.
hx.DatePickeroptionsObject
options
allowInbuiltPickerBoolean
Added
Whether to allow the inbuilt datepicker for touch devices. Generally this should be allowed as the inbuilt picker is generally more suited to the device.
hx.DatePicker
showMonthDatePicker
Deprecated
Use datepicker.visibleMonth instead (method has been renamed to make its purpose clearer)
hx.DatePicker
addDaysDatePicker
Deprecated
Use datepicker.day(datepicker.day() + days) instead
hx.DatePicker
addMonthsDatePicker
Deprecated
Use datepicker.month(datepicker.month() + months) instead
hx.DatePicker
addYearsDatePicker
Deprecated
Use datepicker.year(datepicker.year() + years) instead
hx.DatePicker
updateDatePicker
Deprecated
Use locale(locale) instead.
hx.DatePicker
dateDatePicker
Deprecated
The suppressCallback parameter has been deprecated. Use datepicker.suppressed(eventName, suppress) to suppress events. This is part of the Event Emitter api.
The dontSetupInput paramater has been deprecated. There is no alternative to this parameter.
hx.DatePicker
dayDatePicker
Deprecated
The suppressCallback parameter has been deprecated. Use datepicker.suppressed(eventName, suppress) to suppress events. This is part of the Event Emitter api
hx.DatePicker
monthDatePicker
Deprecated
The suppressCallback parameter has been deprecated. Use datepicker.suppressed(eventName, suppress) to suppress events. This is part of the Event Emitter api
hx.DatePicker
yearDatePicker
Deprecated
The suppressCallback parameter has been deprecated. Use datepicker.suppressed(eventName, suppress) to suppress events. This is part of the Event Emitter api
hx.DatePicker
rangeDatePicker
Deprecated
Use range(range, dontSetupInput) instead.
hx.DatePicker
validRangeDatePicker
Deprecated
Use validRange(obj) instead
hx.DatePicker
visibleMonthDatePicker
Added
A function used to show the month specified without affecting the date selection
hx.DatePicker
visibleMonthObject
Added
A function used to show the month specified without affecting the date selection
hx.DatePicker
showDatePicker
Added
Shows the datepicker dropdown
hx.DatePicker
hideDatePicker
Added
Hides the datepicker dropdown
hx.DatePicker
validRangeDatePicker
Added
Sets the range in which dates can be selected. For calendar pickers, this will grey out any dates that are outside the range. For datepickers, this will prevent the dates from being entered or selected with the up/down buttons. 
datepicker.validRange({start: new Date}); // User can select any date after today
datepicker.validRange({start: undefined, end: new Date()}); // User can select any date before today
datepicker.validRange({start: new Date(), end: new Date()}); // User can only select today
datepicker.validRange({}); // Clear valid range (all dates are valid)
hx.DatePicker
validRangeObject
Added
Gets the currently set valid range for this date picker.
hx.DatePicker
rangeDatePicker
Added
A method for setting the selected date range when the selectRange argument was passed into the constructor.
When providing dates, the order of the dates is not relevant. The date picker will decide which is the start and which is the end date and set the range accordingly.
hx.DatePicker
localeDatePicker
Added
A function for updating the locale used in the date picker.
By default, the locale used is 'en-gb' which cannot be changed unless moment.js with the relevant locales is present on the page. 
datepicker.locale('pl') // sets the datepicker's locale to Poland
hx.DatePicker
localeString
Added
A method for getting the currently set locale.
hx.DatePicker
dateDatePicker
Added
A function used to set the currently selected date.
hx.DatePicker
dayDatePicker
Added
A function used to set the currently selected day.
hx.DatePicker
monthDatePicker
Added
Sets the currently selected month.
hx.DatePicker
yearDatePicker
Added
Sets the currently selected year.
hx.DatePicker
change
Added
Emitted when the date is changed.
hx.DatePicker
Deprecated
Use hx.DatePicker(selector, options) instead.
0.12.10
hx.DatePicker
Deprecated
Use hx.DatePicker(selector, options) instead.
0.12.9
hx.DatePickerextendsEventEmitter
Bugfix
Fixed a bug with moment.js causing 'inbuilt' date pickers not to work properly by disabling the inbuilt functionality when moment is present.
hx.DatePicker
Deprecated
Use hx.DatePicker(selector, options) instead.
0.12.8
hx.DatePicker
Deprecated
Use hx.DatePicker(selector, options) instead.
0.12.7
hx.DatePicker
Deprecated
Use hx.DatePicker(selector, options) instead.
0.12.6
hx.DatePickerextendsEventEmitter
Bugfix
Fixed an issue where the date picker was throwing an error when changing the input value of a 'datepicker' type.
Updated
Updated the inbuilt localiser so it is no longer browser dependent. The date picker will display in DD/MM/YYYY with UK day/month names by default. Localisation with moment.js is still possible.
hx.DatePicker
Deprecated
Use hx.DatePicker(selector, options) instead.
0.12.5
hx.DatePickerextendsEventEmitter
Bugfix
Added fixes for 'inbuilt' datepickers that are shown on devices that support the 'date' attribute and the 'touch' event (e.g. mobile devices, iPads etc.)
hx.DatePicker
Deprecated
Use hx.DatePicker(selector, options) instead.
0.12.4
hx.DatePicker
Deprecated
Use hx.DatePicker(selector, options) instead.
0.12.3
hx.DatePicker
Deprecated
Use hx.DatePicker(selector, options) instead.
0.12.2
hx.DatePickerextendsEventEmitter
Updated
Updated the date picker to allow 'zooming out' to year/decade view by clicking the header and converted to use options object instead of multiple arguments.
hx.DatePicker
Deprecated
Use hx.DatePicker(selector, options) instead.
hx.DatePicker
Added
0.12.0
hx.DatePicker
setDate
Removed
hx.DatePicker
setDay
Removed
hx.DatePicker
setMonth
Removed
hx.DatePicker
setYear
Removed
hx.DatePicker
setRange
Removed
hx.DatePicker
getDateDate
Removed
hx.DatePicker
getRangeObject
Removed
hx.DatePicker
disableDatePicker
Added
A method for disabling a date picker so the user can't enter values.
hx.DatePicker
enableDatePicker
Added
A method for enabling a date picker so the user can enter values.
0.11.0
hx.DatePickerextendsEventEmitter
Updated
All instances of supressCallback have been converted to suppressCallback.
Bugfix
Fixed an issue where setting the values for the date picker and then getting the value would result in the wrong value being returned.
hx.DatePicker
showMonthDatePicker
Updated
Converted the month property to be 1-based instead of 0-based.
hx.DatePicker
setDate
Deprecated
Use date(date, dontSetupInput, suppressCallback) instead.
hx.DatePicker
setDay
Deprecated
Use day(day, suppressCallback) instead.
hx.DatePicker
setMonth
Deprecated
Use month(month, suppressCallback) instead.
hx.DatePicker
setYear
Deprecated
Use year(year, suppressCallback) instead.
hx.DatePicker
setRange
Deprecated
Use range(date1, date2, dontSetupInput, suppressCallback) instead.
hx.DatePicker
getDateDate
Deprecated
Use date() instead.
hx.DatePicker
getRangeObject
Deprecated
Use range() instead.
hx.DatePicker
dateDate
Added
A function to return the current date
hx.DatePicker
dateDatePicker
Added
A function used to set the currently selected date.
hx.DatePicker
dayNumber
Added
A function to return the currently selected day of the month.
hx.DatePicker
dayDatePicker
Added
A function used to set the currently selected day.
hx.DatePicker
monthNumber
Added
A function to return the currently selected month.
hx.DatePicker
monthDatePicker
Added
Sets the currently selected month.
hx.DatePicker
yearNumber
Added
A function to return the currently selected year.
hx.DatePicker
yearDatePicker
Added
Sets the currently selected year.
hx.DatePicker
rangeObject
Added
A function to return the selected date range when the selectRange argument was passed into the constructor.
hx.DatePicker
rangeDatePicker
Added
A method for setting the selected date range when the selectRange argument was passed into the constructor.
When providing dates, the order of the dates is not relevant. The date picker will decide which is the start and which is the end date and set the range accordingly.
hx.DatePicker
validRangeDatePicker
Added
Added the ability to specify a valid range for date pickers.