Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@atlaskit/datetime-picker

atlassian75.7kApache-2.017.0.2TypeScript support: included

A date time picker allows the user to select an associated date and time.

readme

Datetime-picker

A React component for picking date/time values.

Installation

yarn add @atlaskit/datetime-picker

Usage

Detailed docs and example usage can be found here.

changelog

@atlaskit/datetime-picker

17.0.2

Patch Changes

  • Updated dependencies

17.0.1

Patch Changes

17.0.0

Major Changes

  • #129617 0afd40c7a88c1 - Migrated from @emotion/react to @compiled/react in order to improve performance, align with the rest of the Atlaskit techstack, and support React 18 Streaming SSR.

    Please note, in order to use this version of @atlaskit/datetime-picker, you will need to ensure that your bundler is configured to handle .css imports correctly. Most bundlers come with built-in support for .css imports, so you may not need to do anything. If you are using a different bundler, please refer to the documentation for that bundler to understand how to handle .css imports.

    For more information on the migration, please refer to RFC-73 Migrating our components to Compiled CSS-in-JS.

16.2.3

Patch Changes

  • Updated dependencies

16.2.2

Patch Changes

  • Updated dependencies

16.2.1

Patch Changes

16.2.0

Minor Changes

  • #129522 e1b2aef9e7c6c - DateTimePicker now uses disabled border and background color tokens when disabled.

16.1.1

Patch Changes

  • Updated dependencies

16.1.0

Minor Changes

  • #115611 5f9efb77e9d97 - Adds a new prop to allow wrapping the DatePicker calendar, for internal use only.

16.0.3

Patch Changes

  • Updated dependencies

16.0.2

Patch Changes

  • Updated dependencies

16.0.1

Patch Changes

  • Updated dependencies

16.0.0

Major Changes

Patch Changes

  • Updated dependencies

15.13.1

Patch Changes

  • Updated dependencies

15.13.0

Minor Changes

  • #103629 60472f23c74f1 - Finish conversion of datetime picker components from class components to functional components, and cleaning up feature flags.

15.12.2

Patch Changes

  • Updated dependencies

15.12.1

Patch Changes

  • Updated dependencies

15.12.0

Minor Changes

Patch Changes

  • Updated dependencies

15.11.2

Patch Changes

15.11.1

Patch Changes

15.11.0

Minor Changes

  • #102000 3e1546043c1c3 - We are testing adding year buttons to the calendar behind a feature flag. If this fix is successful it will be available in a later release.

Patch Changes

  • Updated dependencies

15.10.6

Patch Changes

  • Updated dependencies

15.10.5

Patch Changes

15.10.4

Patch Changes

  • #177875 d0c3d27216b7c - Clean up props for select new improvement on theme and customized components
  • Updated dependencies

15.10.3

Patch Changes

15.10.2

Patch Changes

  • Updated dependencies

15.10.1

Patch Changes

  • Updated dependencies

15.10.0

Minor Changes

15.9.6

Patch Changes

  • Updated dependencies

15.9.5

Patch Changes

  • #166087 3ab7d7da348ab - Adds side-effect config to support Compiled css extraction in third-party apps

15.9.4

Patch Changes

  • Updated dependencies

15.9.3

Patch Changes

15.9.2

Patch Changes

  • #163831 bdee2726c1e39 - Fix bug in calendar date selection caused by underlying react-select mousedown event.

15.9.1

Patch Changes

15.9.0

Minor Changes

15.8.0

Minor Changes

15.7.1

Patch Changes

15.7.0

Minor Changes

15.6.0

Minor Changes

Patch Changes

  • Updated dependencies

15.5.2

Patch Changes

  • Updated dependencies

15.5.1

Patch Changes

  • #156121 6e87dd7dd8d3a - When shouldShowCalendarButton is true, ensures that input text properly overflows via controlling an underlying select component.
  • #156147 a5c2ba68d297d - We are testing converting the datetime picker from a class component to a functional component behind a feature flag. If this fix is successful it will be available in a later release.

15.5.0

Minor Changes

Patch Changes

  • Updated dependencies

15.4.3

Patch Changes

  • Updated dependencies

15.4.2

Patch Changes

15.4.1

Patch Changes

15.4.0

Minor Changes

  • aa20e64143c46 - DatePicker rewrited to be a functional component

15.3.1

Patch Changes

  • Updated dependencies

15.3.0

Minor Changes

Patch Changes

15.2.0

Minor Changes

  • 6f45e454d44fe - [ux] Adds a dedicated button to open the calendar.

15.1.4

Patch Changes

  • #143559 56dfbfe361f96 - Upgrade react-select from 5.4 to 5.8 and replace it with internal atlaskit/react-select
  • Updated dependencies

15.1.3

Patch Changes

  • Updated dependencies

15.1.2

Patch Changes

15.1.1

Patch Changes

  • Updated dependencies

15.1.0

Minor Changes

15.0.3

Patch Changes

  • #146278 c3cf99e129677 - Make default value from inner pickers work correctly with datetime picker values.
  • #145891 b4b387856090d - Ensure inner picker event blur and focus handlers don't interfere or replace internal logic.

15.0.2

Patch Changes

  • Updated dependencies

15.0.1

Patch Changes

  • #145902 7d95e270ddda2 - Ensure provided onChange handlers on in *PickerProps run alongside internal parsing logic instead of overriding it.

15.0.0

Major Changes

14.1.2

Patch Changes

14.1.1

Patch Changes

14.1.0

Minor Changes

  • #142807 e4b42ed1ea941 - These two props that were removed on 14.0.0 and no longer impacted the functionality of the DateTimePicker were misrepresented in the type interface as options and have been fully removed now.

    • timeIsEditable
    • times

    We recommend running the codemod provided in major change 14.0.0. If you have already run this once, it does not need to be run again.

14.0.5

Patch Changes

14.0.4

Patch Changes

14.0.3

Patch Changes

  • #137357 023251c8a0af7 - Converting the time picker from a class component into a functional component.

14.0.2

Patch Changes

14.0.1

Patch Changes

14.0.0

Major Changes

  • #133339 eb8297ababb74 - Refactors the API and ratchets down on props in the selectProps in favor of top-level alternatives. This ensures that there is one way to do each things and there is a clear encapsulation of what prop goes to which picker. A codemod is included which will automate all of the changes for you.

13.11.3

Patch Changes

13.11.2

Patch Changes

13.11.1

Patch Changes

  • #130485 d7ffb64c0d672 - Deprecated props that are either unused or where the usage causes accessibility issues. These will be removed in the next major upgrade.

13.11.0

Minor Changes

  • #129307 8f67a01e4e56f - Fix internal type issues with regard to forwarding types from underlying select package.

13.10.1

Patch Changes

  • Updated dependencies

13.10.0

Minor Changes

  • #128236 84388abdd587a - The platform.design-system-team.date-picker-input-a11y-fix_cbbxs feature flag has been removed.

13.9.0

Minor Changes

  • #127511 db30e29344013 - Widening range of react and react-dom peer dependencies from ^16.8.0 || ^17.0.0 || ~18.2.0 to the wider range of ^16.8.0 || ^17.0.0 || ^18.0.0` (where applicable).

    This change has been done to enable usage of `react@18.3as well as to have a consistent peer dependency range forreactandreact-domfor/platform` packages.

Patch Changes

  • Updated dependencies

13.8.1

Patch Changes

  • Updated dependencies

13.8.0

Minor Changes

13.7.6

Patch Changes

  • #125675 56a62aafb8d80 - Refactoring to make locally defined variables that were assigned as spread props explicit.

13.7.5

Patch Changes

13.7.4

Patch Changes

  • 974d1508085ce - Accessibility changes. Add ability to change focus to the current date using ArrowUp and ArrowDown keys while the focus is on the input.
  • Updated dependencies

13.7.3

Patch Changes

  • #121570 6026292f28f06 - [ux] Allows aria-describedby on all pickers. This will ensure messages from the form's field component will be applied properly.

13.7.2

Patch Changes

13.7.1

Patch Changes

13.7.0

Minor Changes

13.6.1

Patch Changes

  • Updated dependencies

13.6.0

Minor Changes

  • #111878 223959ef57c80 - Explicitly set jsxRuntime to classic via pragma comments in order to avoid issues where jsxRuntime is implicitly set to automatic.

Patch Changes

  • Updated dependencies

13.5.3

Patch Changes

  • #109381 8e216367262ea - [ux] Correct outside border of date time picker to 2px when focused
  • Updated dependencies

13.5.2

Patch Changes

  • #102225 95ec6562dae8 - Removal of feature flag platform.design-system-team-date-picker-input-focus-fix_awmzp

13.5.1

Patch Changes

  • Updated dependencies

13.5.0

Minor Changes

13.4.0

Minor Changes

  • #94675 5d9e1dccacca - [ux] Update input border color token to meet 3:1 color contrast ratioLight theme: color.border.input: #091E4224 → #8590A2Dark mode: color.border.input: #A6C5E229 → #738496

Patch Changes

  • Updated dependencies

13.3.6

Patch Changes

  • Updated dependencies

13.3.5

Patch Changes

  • #95171 22defdb991da - [ux] Open date picker calendar when enter or space is pressed while input is focused and calendar is closed.

13.3.4

Patch Changes

  • #93577 af88f34ad1bc - This removes the platform.design-system-team.move-onblur-event-to-input-container_3z82c feature flag. The blur event on DatePicker should fire after the calendar is closed.

13.3.3

Patch Changes

  • #94805 cf93487006a9 - [ux] Return focus to the date picker input on date selection
  • Updated dependencies

13.3.2

Patch Changes

  • #91429 3a4be575c5b5 - Updated TypeScript types for the default props of DateTimePicker to improve compatibility with React 18

13.3.1

Patch Changes

13.3.0

Minor Changes

  • #68248 22e0fd4f6694 - Move the onBlur event from the input to the input container in DatePicker. Add the type aria-describedby in to Field component.

13.2.3

Patch Changes

13.2.2

Patch Changes

13.2.1

Patch Changes

13.2.0

Minor Changes

  • #80805 427c2dd9e0d6 - [ux] Update input border width from 2px to 1px with darker color to meet 3:1 color contrast

Patch Changes

  • Updated dependencies

13.1.0

Minor Changes

  • #79261 d679c084e0a9 - Add optional label prop to DatePicker and TimePicker to supply an accessible name via aria-label

13.0.12

Patch Changes

13.0.11

Patch Changes

  • #74787 c19c3790e6f1 - Cleaning up date picker component by exporting internal utilities.

13.0.10

Patch Changes

13.0.9

Patch Changes

13.0.8

Patch Changes

  • #70959 689672b7c5b0 - [ux] Returns focus to input after pressing Esc when inside the calendar popup in a date picker.

13.0.7

Patch Changes

13.0.6

Patch Changes

13.0.5

Patch Changes

  • #61141 57a79a328287 - Revert the solution with the hidden span in the Label which was merged in scope of DST-11061.

13.0.4

Patch Changes

13.0.3

Patch Changes

  • #59147 f12e489f23b0 - Re-build and deploy packages to NPM to resolve React/Compiled not found error (HOT-106483).

13.0.2

Patch Changes

  • #58458 536478cdcf0b - Made some tiny tweaks to the weekday header so its height is now an integer.

13.0.1

Patch Changes

  • #40391 4300c9d6f18 - Associate the label with the Date / Time picker and the clear button. Add hidden span to the Label component. This allows to associate a label with a clear button. Unit tests update.

13.0.0

Major Changes

  • #43269 c7ab5b9501c - This fixes it so that <TimePicker timeEditable timeFormat="hh:mm:ss"> will return seconds when the timeformat includes seconds whereas previously it would strictly return HH:mm and not account for the timeFormat. It is still not flexible and does not return time in your timeFormat to avoid causing unexpected breaking changes as that HH:mm format has been there for so long.

    There's a theoretical risk that HH:mm formats are expected back when HH:mm:ss format are used and unsed improperly, but any typical parsing of datetime should handle this change perfectly fine, with zero breaking change expected.

Patch Changes

  • Updated dependencies

12.10.6

Patch Changes

  • Updated dependencies

12.10.5

Patch Changes

  • Updated dependencies

12.10.4

Patch Changes

12.10.3

Patch Changes

12.10.2

Patch Changes

12.10.1

Patch Changes

12.10.0

Minor Changes

  • #39964 6c0c0407eb1 - This cleans up the feature flag references for the keyboard accessibility changes, making them fully available for all users.

12.9.0

Minor Changes

12.8.2

Patch Changes

  • #39447 829d92bcf37 - Remove out of date lifecycle methods in favor of up to date methods.

12.8.1

Patch Changes

12.8.0

Minor Changes

  • #38521 0ab32310305 - [ux] We are testing adding keyboard accessibility to the datepicker change behind a feature flag. If this fix is successful it will be available in a later release.

12.7.12

Patch Changes

12.7.11

Patch Changes

12.7.10

Patch Changes

12.7.9

Patch Changes

  • #38569 6f1daf0e449 - Prevent calander from overlaying input when at the bottom of viewport

12.7.8

Patch Changes

  • #37610 e8bb91da805 - [ux] Ensure menu doesn't close when focus moves within it. Makes future keyboard accessibility possible.

12.7.7

Patch Changes

  • #36759 ba50169844e - Remove lookahead and lookbehind in format util to support browsers without that functionality.

12.7.6

Patch Changes

  • #35904 6d8ce8bb48a - Revert PR using regex that is not supported by Safari 16.4 and below and can crash a session

12.7.5

Patch Changes

12.7.4

Patch Changes

  • #35441 599bfe90ee3 - Internal change to use shape tokens. There is no expected visual change.

12.7.3

Patch Changes

  • 758165c64f6 - Fixes bug that made escapes not work correctly in format strings.

12.7.2

Patch Changes

12.7.1

Patch Changes

  • #34881 774ed69ecef - Internal changes to use space tokens for spacing values. There is no visual change.

12.7.0

Minor Changes

  • #34373 1d5cd2e273c - [ux] We are testing an input behavior change in date picker behind a feature flag. Now when entering a date in the input this value will persist after selecting a date instead of being cleared, acting like a standard input. If this fix is successful it will be available in a later release.

12.6.1

Patch Changes

  • #32935 b1bdec7cce2 - Internal change to enforce token usage for spacing properties. There is no expected visual or behaviour change.

12.6.0

Minor Changes

  • #33475 6e51e0d5358 - [ux] update border width from 2px to 1px and add 1px box-shadow when focus or error

Patch Changes

  • Updated dependencies

12.5.3

Patch Changes

  • #34051 49b08bfdf5f - Migrated use of gridSize to space tokens where possible. There is no expected visual or behaviour change.

12.5.2

Patch Changes

12.5.1

Patch Changes

12.5.0

Minor Changes

Patch Changes

  • Updated dependencies

12.4.0

Minor Changes

  • #33163 e976f3cebd0 - Remove excessive aria-labelledby prop, remove incorret documentation.

12.3.13

Patch Changes

  • #32350 c71b0ac8222 - [ux] Add default label to time picker element of datetime picker. Update documentation for more accessible examples and guidelines.

12.3.12

Patch Changes

  • #32424 e754545d460 - [ux] Ensure no duplicate ID's when using selectProps on any of the DateTime Picker components.

12.3.11

Patch Changes

  • #31891 b50c6475079 - Make clear button in datetime picker a button element that is out of the tab order. This mimics the native input element's clear behavior in Safari/Edge.
  • c0fb88b3af6 - [ux] style(calendar): update icon color token from text.subtlest to color.icon

12.3.10

Patch Changes

  • #30882 1fc7949b336 - [ux] Fixes a bug where the background for the calendar element was incorrectly set to 'elevation.surface'

12.3.9

Patch Changes

  • #29470 5546747df1e - Refactoring of code to clean tech debt and make future maintenance easier
  • Updated dependencies

12.3.8

Patch Changes

  • Updated dependencies

12.3.7

Patch Changes

  • #28932 98891267a5e - [ux] Dates entered with 5+ digit years will no longer throw a RangeError

12.3.6

Patch Changes

  • Updated dependencies

12.3.5

Patch Changes

  • Updated dependencies

12.3.4

Patch Changes

  • Updated dependencies

12.3.3

Patch Changes

  • #26712 cb8f8e76d25 - Update types for react-select and @atlaskit/select upgrade Update commerce-ui entrypoints that caused a pipeline issue.
  • Updated dependencies

12.3.2

Patch Changes

  • Updated dependencies

12.3.1

Patch Changes

  • #27289 051095c0d82 - [ux] Changed the Date Picker controller icon to use color.icon.disabled token when in disabled state.

12.3.0

Minor Changes

  • #24968 b8841384da6 - Disabled background and border styles should not be applied to components that have either no background or transparent background to begin with. Textfield and textarea variants that do not have backgrounds (sublte or none) have no backgrounds or borders applied when disabled. As such, any comopnents that consume these will also be affected.

12.2.1

Patch Changes

12.2.0

Minor Changes

  • #24004 a91fbaf0552 - Updates @emotion/core to @emotion/react; v10 to v11. There is no expected behavior change.

Patch Changes

  • 0fbb2840aba - Add isInvalid prop to @atlastkit/Select. The prop indicates whether if the component is in the error state. If true, it visually shows a red border around the input.

    This replaces validationState to make Select more consistent like other components that uses isInvalid prop.

  • Updated dependencies

12.1.4

Patch Changes

12.1.3

Patch Changes

  • #24008 299e4104e10 - [ux] Added appearance 'none' option to component and adopts appearance handling from @atlaskit/select
  • Updated dependencies

12.1.2

Patch Changes

  • #23381 df3d5287649 - Internal code change turning on new linting rules.
  • 429a576a4b2 - fix change-event firing for invalid inputs in datetime-picker select.
  • 84afee665fc - [ux] Implemented missing functionality to submit forms on enter press after a date has been selected in DatePicker
  • 2a2dcc1cf91 - Updated styles to use new input design tokens. Fixed bug where border radius on datePicker rendered incorrectly.
  • Updated dependencies

12.1.1

Patch Changes

  • #23350 3fa327b5d01 - [ux] Border on a subtle appearance date-picker will now persist after a date is selected and field is in focus

12.1.0

Minor Changes

  • #22642 58d4cd75f7a - Removed deprecated hideIcon prop from DateTimePicker because it is unused and serves no functionality. Removed the deprecation notice for the formatDisplayLabel prop in TimePicker

Patch Changes

  • c3a1b950d49 - DSP-3301 specifies label to input id
  • c2f866d31d1 - [ux] Fix timepicker clear icon alignment
  • 7566be18f20 - [ux] Time picker no longer loses focus to the document when tabbing through it in a popup.
  • 574b6c8ba7f - [ux] DSP-2987 Add code to catch console error
  • Updated dependencies

12.0.0

Major Changes

  • #22029 27d4f1e7121 - [ux] Updating tokens
  • d7542d1a7c2 - [ux] Update Tokens in the code with those that are a better fit. New tokens will be visible only in applications configured to use the new Tokens API (currently in alpha).These changes are intended to be interoperable with the legacy theme implementation. Legacy dark mode users should expect no visual or breaking changes.
  • c19fb116172 - [ux] Update Tokens in the code with those that are a better fit. New tokens will be visible only in applications configured to use the new Tokens API (currently in alpha).These changes are intended to be interoperable with the legacy theme implementation. Legacy dark mode users should expect no visual or breaking changes.

Minor Changes

  • 6f7a4353204 - Added ability to provide custom aria-labels for next- and previous-month buttons using nextMonthLabel and previousMonthLabel

Patch Changes

  • 3ec9ed2c4d0 - Fixed handling of custom times that included whitespace characters
  • Updated dependencies

11.1.11

Patch Changes

  • #21570 558cc136503 - Bump moment dependency version
  • e7438659c2e - Updated dependency '@types/react-select' to fix type error
  • Updated dependencies

11.1.10

Patch Changes

  • Updated dependencies

11.1.9

Patch Changes

11.1.8

Patch Changes

  • Updated dependencies

11.1.7

Patch Changes

  • Updated dependencies

11.1.6

Patch Changes

  • Updated dependencies

11.1.5

Patch Changes

  • #16752 19d72473dfb - Updates usage of deprecated token names so they're aligned with the latest naming conventions. No UI or visual changes
  • 19d72473dfb - Fix bug in inline-edit and Form which prevented date selection in datetimepicker using the keyboard.
  • Updated dependencies

11.1.4

Patch Changes

  • Updated dependencies

11.1.3

Patch Changes

11.1.2

Patch Changes

  • #15998 f460cc7c411 - Builds for this package now pass through a tokens babel plugin, removing runtime invocations of the tokens() function and improving bundle size.
  • Updated dependencies

11.1.1

Patch Changes

11.1.0

Minor Changes

  • #14777 354ef86cca0 - Instrumented datetime-picker with the new theming package, @atlaskit/tokens.

    New tokens will be visible only in applications configured to use the new Tokens API (currently in alpha). These changes are intended to be interoperable with the legacy theme implementation. Legacy dark mode users should expect no visual or breaking changes.

Patch Changes

  • 2b98dfda0a6 - Removes @emotion/styled in favour of @emotion/core.
  • Updated dependencies

11.0.2

Patch Changes

  • Updated dependencies

11.0.1

Patch Changes

  • #13864 b90c0237824 - Update package.jsons to remove unused dependencies.
  • Updated dependencies

11.0.0

Major Changes

  • #9328 414b6216adf - [ux] BREAKING CHANGE: Datetime picker now uses date-fns@2.17 (previously <2.0). This change has tightened the requirements of users to provide ISO dates. This was never explicitly supported, but now will cause an error to be thrown for non-ISO dates. For an abundance of caution we're calling this a breaking change to protect users relying on the previous behaviour.

    To upgrade you'll need to ensure any dates passed to the DateTimePicker are in ISO format.

10.4.2

Patch Changes

10.4.1

Patch Changes

10.4.0

Minor Changes

  • #12328 b162da59aac -

    New Features:

    Three props were added to @atlaskit/calendar and @atlaskit/datetime-picker to make disabling dates more practical, performant and expressive:

    • minDate for the minimum valid date
    • maxDate for the maximum valid date
    • disabledDateFilter, a function that takes a date string, and returns whether or not it should be disabled.

    Bugs

    • DatePicker: Disabled dates that lie outside of the currently selected month now have correct hover styles

Patch Changes

  • c406245d637 - [ux] Prevents the clear button appearing on disabled DateTimePickers.
  • 4db7f1e42b2 - [ux] Fixed a bug which caused clicks on disabled date pickers to modify internal state. This led to an issue where clicking on a disabled date picker, and then enabling it, would result in an opened date picker.
  • Updated dependencies

10.3.0

Minor Changes

  • #12170 f6b951a51f2 - Removes usage of styled-components in favour of standardising on emotion

Patch Changes

  • Updated dependencies

10.2.1

Patch Changes

10.2.0

Minor Changes

  • #10230 1ad2a658d5d - [ux] Added weekStartDay prop which gets passed to the underlying Calendar instance.

Patch Changes

  • Updated dependencies

10.1.0

Minor Changes

  • #9510 069538e03c6 - Prefixes the testId passed down to the nested Calendar component with '${testId}--calendar' to ensure testIds are namespaced correctly. This change only affects calendar testIds when used within a DatePicker context.

10.0.12

Patch Changes

  • Updated dependencies

10.0.11

Patch Changes

  • #9299 471e2431a7c - Downgrade back to date-fns 1.30.1 We discovered big bundle size increases associated with the date-fns upgrade. We're reverting the upgarde to investigate

10.0.10

Patch Changes

10.0.9

Patch Changes

  • #8644 79c23df6340 - Use injected package name and version for analytics instead of version.json.
  • c20be966f07 - Internal change

    • Change @atlaskit/calendar ref type import name from CalendarInternalRef to CalendarRef.
    • Change prop name which is being passed to @atlaskit/calendar from internalRef to calendarRef.
  • Updated dependencies

10.0.8

Patch Changes

  • #7762 9c020a0e05f - Replaced @atlaskit/calendar exported types to access its navigate() api

    • Replaced CalendarClassType & ArrowKeys types with CalendarInternalRef type.
    • Also replaced ref prop with internalRef prop for accessing navigate() api.
  • Updated dependencies

10.0.7

Patch Changes

10.0.6

Patch Changes

  • #5497 5f58283e1f - Export types using Typescript's new "export type" syntax to satisfy Typescript's --isolatedModules compiler option. This requires version 3.8 of Typescript, read more about how we handle Typescript versions here: https://atlaskit.atlassian.com/get-started Also add typescript to devDependencies to denote version that the package was built with.

10.0.5

Patch Changes

  • Updated dependencies

10.0.4

Patch Changes

10.0.3

Patch Changes

  • #3885 6c525a8229 - Upgraded to TypeScript 3.9.6 and tslib to 2.0.0

    Since tslib is a dependency for all our packages we recommend that products also follow this tslib upgrade to prevent duplicates of tslib being bundled.

10.0.2

Patch Changes

  • #3823 6262f382de - Use the 'lodash' package instead of single-function 'lodash.*' packages
  • 39e130698b - Fixes an issue in DatePicker, DateTimePicker and TimePicker where they all had a circular dependency between a type declaration and default props which led to TypeScript marking props with default values as required props. This will no longer occur.
  • Updated dependencies

10.0.1

Patch Changes

  • #3428 23f968def3 - Earlier value returned from DateTimePicker component was inconsistent, like for the first time it was without zone offset and after that with zone offset. Now it is consistent with zone offset every-time.
  • db053b24d8 - Update all the theme imports to be tree-shakable

10.0.0

Major Changes

Patch Changes

  • Updated dependencies

9.4.7

Patch Changes

9.4.6

Patch Changes

  • #2443 a39ef6582c - Marks default pops as optional in interface (TimePicker & DatePicker)

9.4.5

Patch Changes

  • #2866 54a9514fcf - Build and supporting files will no longer be published to npm

9.4.4

Patch Changes

9.4.3

Patch Changes

  • #2490 ccd9c51bd3 - Fixes date picker being affected by an invalid emotion theme provider.

9.4.2

Patch Changes

  • Updated dependencies

9.4.1

Patch Changes

  • #1891 d2876ee14f - FIX: Add hideIcon prop back for backwards compatibility in MINOR

9.4.0

Minor Changes

  • [minor]449ef134b3:

    Add a clear icon for datepicker, timepicker and datetimepicker

Patch Changes

9.3.0

Minor Changes

  • [minor]5d8fc8d0ec:

    Remove the calendar icon from the datetimepicker

Patch Changes

9.2.9

Patch Changes

9.2.8

Patch Changes

9.2.7

Patch Changes

9.2.6

Patch Changes

9.2.5

Patch Changes

9.2.4

Patch Changes

9.2.3

Patch Changes

9.2.2

Patch Changes

9.2.1

Patch Changes

  • [patch]30acc30979:

    @atlaskit/select has been converted to Typescript. Typescript consumers will now get static type safety. Flow types are no longer provided. No API or behavioural changes.

9.2.0

Minor Changes

  • [minor]c423fbf5eb:

    Adding an optional prop testId that will set the attribute value data-testid. It will help products to write better integration and end to end tests.

9.1.0

Minor Changes

  • [minor]17a07074e8:

    Fix padding to be consistent with other Atlaskit form fields. This change includes removing padding from around the icon itself, and adding padding to the icon container, as well as altering the padding around the input container.

9.0.1

Patch Changes

  • [patch]35d2229b2a:

    Adding missing license to packages and update to Copyright 2019 Atlassian Pty Ltd.

9.0.0

Major Changes

  • [major]d1444cc6ef:

    Converting datetime-picker to typescript. Dropping support for flow

8.1.2

Patch Changes

  • [patch]a2d0043716:

    Updated version of analytics-next to fix potential incompatibilities with TS 3.6

8.1.1

8.1.0

Minor Changes

  • [minor]e3d466543f:

    Add locale support for Calendar/DateTimePicker/DatePicker/TimePicker:

    • New prop locale enables localization for date/time format in DatePicker, TimePicker and DateTimePicker, and months/days in Calendar.
    • Deprecated dateFormat, timeFormat and formatDisplayLabel props. Please use locale instead. If provided, these props will override locale.
    • Default date/time placeholders now use locale to format the date.
    • The default date parser for DatePicker has been changed from date-fns.parse to one based on the locale prop and accept text in a format that matches the placeholder.

8.0.17

Patch Changes

  • [patch]8784191ef6:

    Date, Time, and DateTime pickers now correctly clear their value when the Backspace or Delete key is pressed

8.0.16

Patch Changes

  • [patch]097b696613:

    Components now depend on TS 3.6 internally, in order to fix an issue with TS resolving non-relative imports as relative imports

8.0.15

Patch Changes

8.0.14

Patch Changes

  • [patch]708028db86:

    Change all the imports to theme in Core to use multi entry points

8.0.13

Patch Changes

  • [patch]de35ce8c67:

    Updates component maintainers

8.0.12

8.0.11

8.0.10

Patch Changes

  • [patch]9f8ab1084b:

    Consume analytics-next ts type definitions as an ambient declaration.

8.0.9

8.0.8

Patch Changes

  • [patch]19d9d0f13f:

    Fixing a rare bug in Safari and malformed date string.

8.0.7

8.0.6

Patch Changes

  • [patch]4615439434:

    index.ts will now be ignored when publishing to npm

8.0.5

8.0.4

Patch Changes

  • [patch]8d54773dea:

    Remove meridian time in parseInputValue in TimePicker

8.0.3

8.0.2

  • [patch]06819642ba:

    • Internal refactor and clean up

8.0.1

  • [patch]21854842b5:

    • Clean couple of TODO's that were already done

8.0.0

  • [major]7c17b35107:

    • Updates react and react-dom peer dependencies to react@^16.8.0 and react-dom@^16.8.0. To use this package, please ensure you use at least this version of react and react-dom.

7.0.5

7.0.4

7.0.3

7.0.2

  • [patch]98e11001ff:

    • Removes duplicate babel-runtime dependency

7.0.1

7.0.0

  • [major]76299208e6:

    • Drop ES5 from all the flow modules

    Dropping CJS support in all @atlaskit packages

    As a breaking change, all @atlaskit packages will be dropping cjs distributions and will only distribute esm. This means all distributed code will be transpiled, but will still contain import and export declarations.

    The major reason for doing this is to allow us to support multiple entry points in packages, e.g:

    import colors from `@atlaskit/theme/colors`;

    Previously this was sort of possible for consumers by doing something like:

    import colors from `@atlaskit/theme/dist/esm/colors`;

    This has a couple of issues. 1, it treats the file system as API making internal refactors harder, we have to worry about how consumers might be using things that aren't actually supposed to be used. 2. We are unable to do this internally in @atlaskit packages. This leads to lots of packages bundling all of theme, just to use a single color, especially in situations where tree shaking fails.

    To support being able to use multiple entrypoints internally, we unfortunately cannot have multiple distributions as they would need to have very different imports from of their own internal dependencies.

    ES Modules are widely supported by all modern bundlers and can be worked around in node environments.

    We may choose to revisit this solution in the future if we find any unintended condequences, but we see this as a pretty sane path forward which should lead to some major bundle size decreases, saner API's and simpler package architecture.

    Please reach out to #fabric-build (if in Atlassian) or create an issue in Design System Support (for external) if you have any questions or queries about this.

6.5.1

6.5.0

  • [minor]a48dddb43c:

    • onChange will only be fired when a complete datetime is supplied by the user

6.4.2

  • [patch]0cd7f505b3:

    • Iso date parsing on IE11 and Edge is now consistent with other browsers

6.4.1

  • [patch]348d3aed19:

    • Datepicker will now reset the focused date on the calendar every time it is opened

6.4.0

  • [minor]52827feffb:

    • onChange is now called only when the user selects or clears a value. The date passed to onChange will always be a valid date

6.3.25

6.3.24

  • [patch]55e0a3a:

    • Fixes keyboard entry bug
  • [patch]075dfa2:

    • Allowing control of input value in datetime-picker

6.3.23

  • [patch]4c4bdc5:

    • AK-5672 - Refactor parseTime by separating logic and concerns into smaller, testable functions. Fixes meridiem issues.
  • [patch]58a40bf:

    • Factoring in meridiem for 24hr time in editable

6.3.22

  • [patch]5c548ea:

    • Removing extraneous wrapping span around icons which was causing an accessibility error

6.3.21

6.3.20

6.3.19

6.3.18

6.3.17

  • [patch]b332c91:

    • upgrades verison of react-scrolllock to SSR safe version

6.3.16

  • [patch] Datetime Picker modal sticks to bottom, if needed 0149735

6.3.15

  • [patch] Added logic to onCalendarChange for impossibly large dates. These dates now get converted to the last day of the month, as opposed to default js behaviour. '2018-02-31' now converts to '2018-02-28' as opposed to '2018-03-02' 4b23458

6.3.14

  • [patch] Fixing blank state for datetime-picker in Firefox. 0e6d838

6.3.13

6.3.12

  • [patch] Adds missing implicit @babel/runtime dependency b71751b

6.3.11

6.3.10

6.3.9

  • [patch] Fixes bug on next and prev month navigation. c4770a0

6.3.8

  • [patch] TimePicker not longer throws console error when input cleared dba1bb0

6.3.7

6.3.6

6.3.5

  • [patch] Adds sideEffects: false to allow proper tree shaking b5d6d04

6.3.3

  • [patch] Updating datetime-picker and select styles 981b96c

6.3.2

6.3.1

6.3.0

  • [minor] added formatDisplayLabel prop to timePicker and datePicker to enable configuration of the label string rendered in the input bce02a8
  • [none] Updated dependencies bce02a8

6.2.0

  • [minor] Added parseDateValue prop to datetimepicker which accepts a function that takes an iso datestring, a date value, a time value and a zone value and returns an object containing a formatted dateValue, timeValue and zoneValue. The defaultProp uses date-fn's parse and format functions under the hood. 6249709
  • [none] Updated dependencies 6249709

6.1.2

  • [patch] Replace @atlaskit/layer in date time picker with @atlaskit/popper, changed configuration of flipBehaviour modifier to use viewport as the element boundary rather than the window. 4286672
  • [patch] Updated datetime-picker to use @atlaskit/popper internally instead of @atlaskit/layer. Minor fix to @atlaskit/popper, boundariesElement for flipbehaviour is now viewport and not window. f2159f4
  • [patch] Updated dependencies 4286672
  • [none] Updated dependencies f2159f4

6.1.1

6.1.0

  • [minor] Added parseInputValue prop to datePicker and timePicker, which allows for the customisation of logic around parsing input values into the requisite date object. Also added datePickerProps and timePickerProps props to dateTimePicker to expose these two (and later other datePicker and timePicker explicit props) at the dateTimePicker level 9a75b8b
  • [none] Updated dependencies 9a75b8b

6.0.3

6.0.2

6.0.1

6.0.0

5.4.5

5.4.4

  • [patch] atlaskit/select now invokes a makeAnimated function to wrap passed in components in default animated behaviour. As this invocation returns a new set of react components each time, we've also implemented a lightweight component cache using memoize-one and react-fast-compare. Additionally updates made to datetime-picker to not instantiate a new component on render everytime (for performance reasons as well as to satisfy our caching logic), we now also pass relevant state values through the select as props to be ingested by our custom components, instead of directly capturing them within lexical scope. 9b01264
  • [patch] Updated dependencies 9b01264

5.4.3

  • [patch] Fix disabled dates could be selected with keyboard 832b4ab
  • [patch] Updated dependencies 832b4ab

5.4.2

5.4.1

5.4.0

5.3.3

5.3.2

5.3.1

  • [patch] TimePicker timesIsEditable invalid values are set to empty strings b710290
  • [patch] Updated dependencies b710290

5.3.0

  • [minor] Backspace now clears input & fixed tab clearing input 5783a8d
  • [minor] Updated dependencies 5783a8d

5.2.1

5.2.0

5.1.0

  • [minor] Fixed DatetimePicker not clearing input on ESC c58f3db

5.0.1

5.0.0

4.1.1

  • [patch] Fix DateTimePicker not setting TimePicker value 0c073e6

4.1.0

4.0.4

  • [patch] Fixes for parsing & formatting of values 0c843bc

4.0.3

4.0.2

  • [patch] Fix create option being displayed when timeIsEditable is false 7e99ba3

4.0.1

4.0.0

3.1.1

3.1.0

  • [minor] Add dateFormat prop to customise the display format of dates 3daced9

3.0.5

  • [patch] Fixed subtle appearance on focus 2b1e018

3.0.4

  • [patch] Better styles for disabled dates 866c497

3.0.3

  • [patch] Added appearance prop to enable subtle (no icon) appearance c10fd5d

3.0.2

  • [patch] Remove unused dependencies 3cfb3fe

3.0.1

  • [patch] Added isInvalid prop to DateTimePicker DatePicker & TimePicker 101c306

2.0.6

  • [patch] Added timeIsEditable prop to enable user created times 4695e5d

2.0.3

  • [patch] Change pickers to use fixed positioning and scroll lock to allow them to break out of modals. d4981fe

2.0.2

  • [patch] Fix datetime picker without a value and defaultValue not working a88aee0

2.0.0

  • [major] Bump to React 16.3. 4251858

1.0.1

  • [patch] Fix picker value not being able to be set programatically 17c7a15
  • [patch] Fix isDisabled not restricting pickers from opening f396f2e

1.0.0

  • [major] QoL and consistency changes to the calendar and datetime-picker APIs. Added the ability to specify a string to the DateTimePicker component. Remove stateless components and make each component stateless or stateful using the controlled / uncontrolled pattern. Misc prop renames for consistency. ab21d8e

0.7.1

  • [patch] Re-releasing due to potentially broken babel release 9ed0bba

0.7.0

  • [minor] Update styled-components dependency to support versions 1.4.6 - 3 ceccf30

0.6.2

0.6.1

  • [patch] Packages Flow types for elements components 3111e74

0.6.0

  • [minor] Make all internal state able to be controlled or uncontrolled obviating the need for the usage of stateless components. 3d81d42

0.5.0

  • [minor] Add React 16 support. 12ea6e4

0.4.0

  • [minor] datetime picker will take full width if width is not passes 7a9add1

0.3.3

  • [patch] Update dependencies 623f8ca

0.3.2

  • [patch] calling onchange on hook when datepickers is set to empty state 9e288cc

0.3.0

  • [minor] add autoFocus prop to DateTimePicker c8de434

0.2.0

  • [minor] DateTimePicker is now controlled. 1318f4e
  • [minor] Add DateTimePickerStateless component. Fix issue where DateTimePicker tries to call selectField on the dualPicker, which didn't exist. Add ability to have a controlled DateTimePicker. 4bd0167
  • [minor] Add DateTimePickerStateless and refactor DateTimePicker to use that internally, and expose DateTimePickerStateless as public API. bbbadf5

0.1.2

  • [patch] bump icon dependency da14956

0.1.0

  • [minor] Added TimePicker and DateTimePicker. Improved docs and examples. 4b49f4d

0.0.5

  • [patch] Use correct dependencies 7b178b1
  • [patch] Adding responsive behavior to the editor. e0d9867