date-fns Release Notes & Changelog

v5 focuses on reducing the date-fns package size. Compared to v4.3.0, this version reduces the zipped package size from 5.83 MB down to 2.89 MB.

It removes the CDN scripts from the date-fns package and moves them to a separate @date-fns/cdn package.

It is just the first step in optimizing the package size. Expect further size reduction in the future versions.

Changed

• BREAKING: The CDN scripts are now available via the @date-fns/cdn npm package instead of date-fns. Users relying on the latest CDN version (e.g., https://cdn.jsdelivr.net/npm/date-fns/cdn.min.js) would be served a polyfill that

…

Kudos to @ImRodry and @puneetdixit200 for their contributions.

Fixed

• Fixed missing modularized optimization fallback (for Next.js and others). See #4193.
• Fixed pt locale first day of week to be Sunday. See #4195 by @ImRodry.
• Fixed zh-CN, zh-HK, and zh-TW locale month parsing for October, November, and December. See #4194 by @puneetdixit200.

Fixed

• Fixed type definitions missing in v4.2.0 due to TypeScript misconfiguration.

This is a minor release in all senses, it only includes documentation updates (first of many) that points to the new You Don't Need date-fns* page.

* Not really

Changed

• Added Temporal API references to the JSDoc annotations of add, addBusinessDays, and addDays.

This release adds time zone support to format functions (that I somehow missed when working on the feature) and fixes a few bugs.

Make sure also upgrade TZDate to v1.0.2 as it includes a bunch of critical bug fixes.

Fixed

• Fixed internal constructFrom throwing an exception on null arguments. While null isn't allowed, the functions should rather return Invalid Date or NaN in such cases. See #3885.

Added

• Added missing time zone support to format, formatISO, formatISO9075, formatRelative and formatRFC3339. See #3886.

I have great news! First, ten years after its release, date-fns finally gets first-class time zone support.

Another great news is that there aren't many breaking changes in this release. All of them are type-related and will affect only those explicitly using internal date-fns types. Finally, it has been less than a year since the last major release, which is an improvement over the previous four years between v2 and v3. I plan on keeping the pace and minimizing breaking changes moving forward.

Read more about the release in the announcement blog post.

- Sasha @kossnocorp

…

On this release worked @kossnocorp and @world1dan. Also, thanks to @seated for sponsoring me.

Fixed

• Fixed weeks in the Belarisuan locale's formatDistance.

Added

• Added CDN versions of modules compatible with older browsers. See the CDN guide.

Kudos to @fturmel, @kossnocorp, @makstyle119, @tan75, @marcreichel, @tareknatsheh and @audunru for working on the release. Also, thanks to @seated for sponsoring me.

Fixed

• Fixed functions that use current date internally and made them work with date extensions like UTCDate.
• Fixed daysToWeeks returning negative 0.
• Fixed German grammar for the "half a minute" string.

Added

• Added the Northern Sámi (se) locale.
• Added the constructNow function that creates the current date using the passed reference date's constructor.

Kudos to @kossnocorp, @sakamossan, and @Revan99 for working on the release. Also, thanks to @seated for sponsoring me.

Added

• Added roundToNearestHours function.
• Added Central Kurdish (ckb) locale.