117 KiB
Change Log
All notable changes to this project will be documented in this file. This project adheres to Semantic Versioning.
This change log follows the format documented in Keep a CHANGELOG.
v4.1.0 - 2024-09-17
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
constructFromthrowing an exception onnullarguments. Whilenullisn't allowed, the functions should rather returnInvalid DateorNaNin such cases. See #3885.
Added
- Added missing time zone support to
format,formatISO,formatISO9075,formatRelativeandformatRFC3339. See #3886.
v4.0.0 - 2024-09-16
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.
Added
-
Added time zones support via
@date-fns/tz'sTZDateclass andtzhelper function. See its README for the details about the API. -
All relevant functions now accept the context
inoption, which allows to specify the time zone to make the calculations in. If the function also returns a date, it will be in the specified time zone:import { addDays, startOfDay } from "date-fns"; import { tz } from "@date-fns/tz"; startOfDay(addDays(Date.now(), 5, { in: tz("Asia/Singapore") })); //=> "2024-09-16T00:00:00.000+08:00"In the example,
addDayswill get the current date and time in Singapore and add 5 days to it.startOfDaywill inherit the date type and return the start of the day in Singapore.
Changed
-
The function arguments, as well as
Interval'sstartandend, now can be of different types, allowing you to mixUTCDate,TZDate,Date, and other extensions, as well as primitives (strings and numbers).The functions will normalize these values, make calculations, and return the result in the same type, preventing any bugs caused by the discrepancy. If passed, the type will be inferred from the context
inoption or the first encountered argument object type. TheInterval'sstartandendwill be considered separately, starting fromstart.In the given example, the result will be in the
TZDateas the first argument is a number, and thestarttakes precedence over theend.clamp(Date.now(), { start: new TZDate(start, "Asia/Singapore"), end: new UTCDate(), }); //=> TZDate -
BREAKING: This release contains a bunch of types changes that should not affect the library's expected usage. The changes are primarily internal and nuanced, so rather than listing them here, I recommend you running the type checker after the upgrade. If there are unfixable problems, please open an issue.
-
BREAKING: The package now is ESM-first. The CommonJS is still support and It should not affect most users, but it might break in certains environments. If you encounter any issues, please report them.
Fixed
- Fixed CDN build compatibility with jQuery and other tools that expose
$by properly wrapping the code in an IIFE.
v3.6.0 - 2024-03-18
On this release worked @kossnocorp and @world1dan. Also, thanks to @seated for sponsoring me.
Fixed
Added
v3.5.0 - 2024-03-15
Kudos to @fturmel, @kossnocorp, @makstyle119, @tan75, @marcreichel, @tareknatsheh and @audunru for working on the release. Also, thanks to @seated for sponsoring me.
Fixed
Added
-
Added the
constructNowfunction that creates the current date using the passed reference date's constructor.
v3.4.0 - 2024-03-11
Kudos to @kossnocorp, @sakamossan and @Revan99 for working on the release. Also, thanks to @seated for sponsoring me.
Added
v3.3.1 - 2024-01-22
Kudos to @kossnocorp and @fturmel for working on the release.
Fixed
-
Fixed DST issue in
getOverlappingDaysInIntervals, resulting in an inconsistent number of days returned for intervals starting and ending in different DST periods. -
Fixed functions incorrectly using
truncinstead ofround. The bug was introduced in v3.3.0. The affected functions:differenceInCalendarDays,differenceInCalendarISOWeeks,differenceInCalendarWeeks,getISOWeek,getWeek, andgetISOWeeksInYear.
v3.3.0 - 2024-01-20
On this release worked @kossnocorp, @TheKvikk, @fturmel and @ckcherry23.
Fixed
-
Fixed the bug in
getOverlappingDaysInIntervalscaused by incorrect sorting of interval components that led to 0 for timestamps of different lengths. -
Fixed bugs when working with negative numbers caused by using
Math.floor(-1.1→-2) instead ofMath.trunc(-1.1→-1). Most of the conversion functions (i.e.,hoursToMinutes) were affected when passing some negative fractional input. Also, some other functions that could be possibly affected by unfortunate timezone/date combinations were fixed.The functions that were affected:
format,parse,getUnixTime,daysToWeeks,hoursToMilliseconds,hoursToMinutes,hoursToSeconds,milliseconds,minutesToMilliseconds,millisecondsToMinutes,monthsToYears,millisecondsToHours,millisecondsToSeconds,minutesToHours,minutesToSeconds,yearsToQuarters,yearsToMonths,yearsToDays,weeksToDays,secondsToMinutes,secondsToHours,quartersToYears,quartersToMonthsandmonthsToQuarters. -
Fixed the Czech locale's
formatDistanceto include1informatDistance. -
Fixed
differenceInSecondsand other functions relying on rounding options that can produce a negative 0. -
Added a preprocessor to the locales API, enabling fixing a long-standing bug in the French locale. (#1391)
-
Added missing
yearsToDaysto the FP submodule. -
Made functions using rounding methods always return
0instead of-0.
Added
v3.2.0 - 2024-01-09
This release is brought to you by @kossnocorp, @fturmel, @grossbart, @MelvinVermeer, and @jcarstairs-scottlogic.
Fixed
-
Fixed types compatibility with Lodash's
flowand fp-ts'spipe. (#3641)
Added
- Added exports of
format,lightFormat, andparseinternals that enable 3rd-parties to consume those.
v3.1.0 - 2024-01-05
This release is brought to you by @kossnocorp, @makstyle119 and @dmgawel.
Fixed
Added
-
Added warning about using protected tokens like
YorDwithout passing a corresponding option. See #2950.
v3.0.6 - 2023-12-22
On this release worked @imwh0im, @jamcry and @tyrw.
Fixed
v3.0.5 - 2023-12-21
This release is brought to you by @goku4199.
Fixed
v3.0.4 - 2023-12-21
This release is brought to you by @kossnocorp.
Fixed
- Fixed isWithinInterval bug caused by incorrectly sorting dates (#3623).
v3.0.3 - 2023-12-21
Fixed
- Rolled back pointing ESM types to the same
d.tsfiles. Instead now it copies the content to avoid the Masquerading as CJS problem reported by "Are the types wrong?".
v3.0.2 - 2023-12-21
Fixed
-
Fixed yet another issue caused by ESM types by pointing to the same
d.tsfiles. -
Added
package.jsonto exports to provide access to tooling. -
Fixed TypeScript 5.4 build break by using the latest type names.
v3.0.1 - 2023-12-20
Fixed
- Fixed an error in certain environments caused by
d.mtsfiles exporting only types.
v3.0.0 - 2023-12-18
Changed
-
BREAKING: date-fns is now a dual-package with the support of both ESM and CommonJS. The files exports are now explicitly in the
package.json. The ESM files now have.mjsextension. -
BREAKING: The package now has a flat structure, meaning functions are now named
node_modules/date-fns/add.mjs, locales arenode_modules/date-fns/locale/enUS.mjs, etc. -
BREAKING: Now all file content’s exported via named exports instead of
export default, which will require change direct imports i.e.const addDays = require(‘date-fns/addDays’)toconst { addDays } = require(‘date-fns/addDays’). -
BREAKING: TypeScript types are now completely rewritten, check out the
d.tsfiles for more information. -
BREAKING:
constantsnow is not exported via the index, so to import one useimport { daysInYear } from "date-fns/constants";. It improves compatibility with setups that modularize imports like Next.js. -
BREAKING: Functions now don’t check the number of passed arguments, delegating this task to type checkers. The functions are now slimmer because of this.
-
BREAKING The arguments are not explicitly converted to the target types. Instead, they are passed as is, delegating this task to type checkers.
-
BREAKING: Functions that accept
Intervalarguments now do not throw an error if the start is before the end and handle it as a negative interval. If one of the properties in anInvalid Date, these functions also do not throw and handle them as invalid intervals.-
areIntervalsOverlappingnormalize intervals before comparison, so{ start: a, end: b }is practically equivalent to{ start: b, end: a }. When comparing intervals with one of the properties beingInvalid Date, the function will return false unless the others are valid and equal, given theinclusiveoption is passed. Otherwise, and when even one of the intervals has both properties invalid, the function will always returnfalse. -
getOverlappingDaysInIntervalsnow normalizes intervals before comparison, so{ start: a, end: b }is practically equivalent to{ start: b, end: a }. If any of the intervals’ properties is anInvalid Date, the function will always return 0. -
isWithinIntervalnow normalizes intervals before comparison, so{ start: a, end: b }is practically equivalent to{ start: b, end: a }. If any of the intervals’ properties is anInvalid Date, the function will always return false. -
intervalToDurationnow returns negative durations for negative intervals. If one or both of the interval properties are invalid, the function will return an empty object. -
The eachXOfInterval functions (
eachDayOfInterval,eachHourOfInterval,eachMinuteOfInterval,eachMonthOfInterval,eachWeekendOfInterval,eachWeekendOfMonth,eachWeekendOfYear,eachWeekOfInterval,eachYearOfInterval) now return a reversed array if the passed interval’s start is after the end. Invalid properties will result in an empty array. Functions that accept thestepoption now also allow negative, 0, and NaN values and return reversed results if the step is negative and an empty array otherwise.
-
-
BREAKING:
intervalToDurationnow skips 0 values in the resulting duration, resulting in more compact objects with only relevant properties. -
BREAKING:
roundToNearestMinutesnow returnsInvalid Dateinstead of throwing an error whennearestTooption is less than 1 or more than 30. -
BREAKING: IE is no longer supported.
-
BREAKING: Now all functions use
Math.truncrounding method where rounding is required. The behavior is configurable on a per-function basis. -
BREAKING: Undocumented
onlyNumericoption was removed fromnnandsvlocales. If you relied on it, please contact me. -
BREAKING: Flow is not supported anymore. If you relied on it, please contact me.
-
BREAKING: The locales now use regular functions instead of the UTC version, which should not break any code unless you used locales directly.
Added
-
All functions that accept date arguments now also accept strings.
-
All functions now export options interfaces.
-
Now functions allow passing custom Date extensions like UTCDate. They will detect and use the arguments constructor to generate the result of the same class.
-
eachMonthOfInterval,eachQuarterOfInterval,eachWeekOfInterval, andeachYearOfIntervalnow accept thestepoption like most of the eachXOfInterval functions. -
A new
intervalfunction that validates interval, emulating the v2 interval functions behavior. -
differenceInXfunctions now accept options and allow setting uproundingMethodthat configures how the result is rounded.Math.truncis the default method.
v2.30.0
Kudos to @kossnocorp and @Andarist for working on the release.
Changes
- Fixed increased build size after enabling compatibility with older browsers in the previous release. This was done by adding @babel/runtime as a dependency. See more details.
v2.29.3 - 2022-09-13
This release is prepared by our own @leshakoss.
Fixed
v2.29.2 - 2022-08-18
This release is brought to you by @nopears, @vadimpopa and @leshakoss.
Fixed
v2.29.1 - 2022-08-18
Thanks to @fturmel for working on the release.
Fixed
v2.29.0 - 2022-07-22
On this release worked @tan75, @kossnocorp, @nopears, @Balastrong, @cpapazoglou, @dovca, @aliasgar55, @tomchentw, @JuanM04, @alexandresaura, @fturmel, @aezell, @andersravn, @TiagoPortfolio, @SukkaW, @Zebreus, @aviskarkc10, @maic66, @a-korzun, @Mejans, @davidspiess, @alexgul1, @matroskin062, @undecaf, @mprovenc, @jooola and @leshakoss.
Added
Fixed
-
Fixed long formatters in the South African English locale (
en-ZA). -
Fixed weekday format for
formatRelativein the Portuguese locale (pt). -
Fixed issue parsing months in Croatian (
hr), Georgian (ka) and Serbian (srandsr-Latn) locales.
Changed
v2.28.0 - 2021-12-28
Kudos to @tan75, @fturmel, @arcanar7, @jeffjose, @helmut-lang, @zrev2220, @jooola, @minitesh, @cowboy-bebug, @mesqueeb, @JuanM04, @zhirzh, @damon02 and @leshakoss for working on the release.
Added
Fixed
v2.27.0 - 2021-11-30
Kudos to @tan75, @hg-pyun, @07akioni, @razvanmitre, @Haqverdi, @pgcalixto, @janziemba, @fturmel, @JuanM04, @zhirzh, @seanghay, @bulutfatih, @nodeadtree, @cHaLkdusT, @a-korzun, @fishmandev, @wingclover, @Zacharias3690, @kossnocorp and @leshakoss for working on the release.
Fixed
-
Fixed translation for quarters in
formatin Chinese Simplified locale (zh-CN). -
Fixed regular expressions for
parsein Estonian locale (er). -
Fixed the format of zeros in
formatDurationin Czech locale (cs). -
Fixed constants not having proper TypeScript and Flow types.
-
Fixed
eachMinuteOfIntervalnot handling intervals less than a minute correctly.
Added
v2.26.0 - 2021-11-19
Thanks to @kossnocorp, @leshakoss, @tan75, @gaplo, @AbdAllahAbdElFattah13, @fturmel, @kentaro84207, @V-Gutierrez, @atefBB, @jhonatanmacazana, @zhirzh, @Haqverdi, @mandaputtra, @micnic and @rikkalo for working on the release.
Fixed
Changed
Added
v2.25.0 - 2021-10-05
This release is brought to you by @kossnocorp, @gierschv, @fturmel, @redbmk, @mprovenc, @artyom-ivanov and @tan75.
Added
v2.24.0 - 2021-09-17
Kudos to Sasha Koss, Lucas Silva, Jan Ziemba, Anastasia Kobzar, Deepak Gupta, Jonas L, Kentaro Suzuki, Koussay Haj Kacem, fturmel, Tan75 and Adriaan Callaerts for working on the release.
Fixed
Changed
-
Used
1instead ofeinfor GermanformatDurationto make it consistent with other locales and formats. (#2505) -
Made Norwegian
formatDurationconsistent with other locales by using numeric representation instead of written. (#2469) -
Use the word "sekunda" instead of "vteřina" for second in the Czech locale.
-
Made Flemish short date format corresponds to the Flemish government.
Added
-
Added
roundingMethodoption todifferenceInHours,differenceInMinutes,differenceInQuarters,differenceInSecondsanddifferenceInWeekswithtruncas the default method. (#2555)
v2.23.0 - 2021-07-23
Thanks to Liam Tait, fturmel, Takuya Uehara, Branislav Lazic, Seyyed Morteza Moosavi, Felipe Armoni, Sasha Koss, Michael Mok, Tan75 and Maxim Topciu for working on the release.
Changed
Added
-
Added a new
clampfunction that allows to bound a date to an interval. -
Allowed passing
undefinedin the duration to add and sub functions.
v2.22.1 - 2021-05-28
Thanks to Sasha Koss for working on the release.
Fixed
- Fixed constant typings. (#2491)
v2.22.0 - 2021-05-28
Sasha Koss, Lucas Silva, Lay, jwbth, fturmel, Tan75 and Anastasia Kobzar worked on this release.
Fixed
Added
- Added 18 new conversion functions:
daysToWeekshoursToMillisecondshoursToMinuteshoursToSecondsmillisecondsToHoursmillisecondsToMinutesmillisecondsToSecondsminutesToHoursminutesToMillisecondsminutesToSecondsmonthsToQuartersmonthsToYearsquartersToMonthsquartersToYearssecondsToHourssecondsToMillisecondssecondsToMinutesweeksToDaysyearsToMonthsyearsToQuarters
v2.21.3 - 2021-05-08
This release is brought to you by Maxim Topciu.
Fixed
v2.21.2 - 2021-05-05
Kudos to Aleksei Korzun, Maxim Topciu, Jonas L, Mohammad ali Ali panah and Tan75 for working on the release.
Fixed
v2.21.1 - 2021-04-15
Thanks to Sasha Koss for working on the release.
Fixed
v2.21.0 - 2021-04-14
This release is brought to you by Aleksei Korzun, Tan75, Rubens Mariuzzo, Christoph Stenglein and Clément Tamisier.
Fixed
Added
v2.20.3 - 2021-04-13
Kudos to fturmel for working on the release.
Fixed
v2.20.2 - 2021-04-12
Kudos to Maxim Topciu for working on the release.
Fixed
v2.20.1 - 2021-04-09
This release is brought to you by Sasha Koss and Tan75.
Fixed
- Fixed
isDateFlow typings that we broke inv2.20.0.
v2.20.0 - 2021-04-08
This release is brought to you by Sasha Koss, Maxim Topciu, tu4mo, Tan75, Ardit Dine, Carl Rosell, Roman Mahotskyi, Mateusz Krzak, fgottschalk, Anastasia Kobzar, Bilguun Ochirbat, Lesha Koss, YuLe and guyroberts21.
Fixed
-
Made
formatDistanceStrictandformatDistanceToNowStrictalways return1 yearinstead of12 months. (#2388) -
Fixed
nextDay,nextMondayandnextTuesdaymissing in exports and type definitions. (#2325)
Added
v2.19.0 - 2021-03-05
Tan75 worked on this release.
Fixed
-
Assigned the correct
firstWeekContainsDatevalue (4) for the French locale. (#2148) -
Fixed a bug in
differenceInMonthsandintervalToDurationthat occurs when dealing with the 28th of February. (#2255)
Added
v2.18.0 - 2021-03-01
Thanks to Tan75 and Lesha Koss.
Fixed
Added
[2.17.0] - 2021-02-05
Kudos to @shaykav, @davidgape89, @rikkalo, @tan75, @talgautb, @owenl131, @kylesezhi, @inigoiparragirre, @gius, @Endeauvirr and @frankyston.
Fixed
-
Fixed
differenceInMonthsfor edge cases, such as the end of February dates. -
Fixed
formatDurationweek translation inptandpt-BRlocales. -
Made Japanese locale to use the correct value for the start of the week.
-
Fixed the short and medium date formats in the Czech locale.
Added
-
Added
intlFormata lightweight formatting function that uses Intl API. Eventually, it will become the default formatting function, so it's highly recommended for new code. -
Added an ability to format lowercase am/pm with
aaaandbbbtokens.
2.16.1 - 2020-07-31
Kudos to @aleksaps, @leedriscoll and @BanForFun for pull-requests!
Fixed
- Fixed a typo in Scottish Gaelic (gd) locale.
- Fixed typos in Serbian Latin locale.
- Fixed greek grammar for Saturday on
formatRelative. - Removed locale snapshots from the npm package making it lighter.
2.16.0 - 2020-08-27
Kudos to @jvpelt, @piotrl, @yotamofek, @dwaxweiler, @leedriscoll and @bradevans for working on the release. Also thanks to @PascalHonegger, @pickfire, @TheJaredWilcurt, @SidKH and @nfantone for improving the documentation.
Fixed
- Added correct translations for Welsh
1 minuteand2 days. - Fixed
formatRFC3339formatting timezone offset with minutes. - Added missing locale type definition for
formatDuration - Fixed Scottish Gaelic locale issues.
Changed
- Used shorter Hebrew alternative for "about".
- Improved string arguments warning after upgrading to v2.
Added
2.15.0 - 2020-07-17
Thanks to @belgamo, @Matsuuu, @Imballinst, @arsnyder16, @pankajupadhyay29, @DCBN, @leedriscoll, @gottsohn, @mukuljainx and @dtriana for working on the release. Also kudos to @KidkArolis, @imgx64, @fjc0k, @wmonk, @djD-REK, @dandv, @psimk and @brimworks for improving the documentation.
Fixed
- Fixed behavior of
addBusinessDayswhen input date is a weekend day. - Fixed
parseISOnot returningInvalid Dateon incorrect string when there are spaces in it. - Fixed
esround-tripping dates with Wednesday. - Fixed round-trip bug with
d/EEEEordering in tokens likePPPPP. - Fixed issues with parsing values in Japanese.
- Fixed Hungarian breaking IE11.
- Fixed Spanish accents in Saturday and Wednesday.
Changed
Added
- Added Swiss-French
fr-CHlocale. - Added Flemish
nl-BElocale. - Added Scottish Gaelic
gdlocale. - Added New Zealand English
en-NZlocale. - Added
isMatchfunction.
2.14.0 - 2020-05-18
Kudos to @julamb, @JacobSoderblom, @justingrant, @dragunoff, @jmate0321, @gbhasha, @rasck, @AlbertoPdRF, @sebastianhaberey and @giogonzo for working on the release!
Fixed
- Fixed DST issues with
add,addDaysandaddMonths. - Fixed "quarter" translation in the Bulgarian locale.
- Fixed
formatDistancestrings in the Hungarian locale. - Fixed Danish month abbreviations.
- Fixed parsing of mei in the Dutch locale.
- Fixed missing preposition in
formatLongin the Spanish locale. - Fixed
formatRelativein the Italian locale.
Added
- Added
eachQuarterOfInterval. - Added Basque (
eu) locale. - Added Indian English (
en-IN) locale. - Added
eachHourOfInterval.
2.13.0 - 2020-05-06
Thanks to @JorenVos, @developergouli, @rhlowe and @justingrant for working on the release!
Fixed
Added
2.12.0 - 2020-04-09
Kudos to @leshakoss, @skyuplam, @so99ynoodles, @dkozickis, @belgamo, @akgondber, @dcousens and @BoomDev for working on the release!
Fixed
- Fixed minulý štvrtok in Slovak locale.
- Fixed date ordinalNumber for ja/zh-CN/zh-TW and ko.
- Fixed quarters parsing.
- Fixed
setDaywithweekStartsOn!= 0. - Fixed differenceInDays across DST.
- Fixed required arguments exception message.
Added
2.11.1 - 2020-03-26
Fixed
- Rebuilt TypeScript and flow types.
2.11.0 - 2020-03-13
Kudos to @oakhan3, @Mukhammadali, @altrim, @leepowellcouk, @amatzon, @bryanMt, @kalekseev, @eugene-platov and @tjrobinson for working on the release.
Fixed
- Fixed a bug in
differenceInYearscausing incorrect results when the left date is a leap day. - Fixed
parseISOto work correctly around time shift dates. - Fixed
formatto work correctly with GMT-0752/GMT-0456 and similar timezones.
Changed
- Changed
getDaytypings to return0|1|2|3|4|5|6instead ofnumber. - Improved Chinese locale:
- Change date format to meet the national standard (GB/T 7408-2005).
- Improve
ordinalNumberfunction behavior. - Add prefix in
formatRelativedepending on if it's a current week or not.
Added
2.10.0 - 2020-02-25
Fixed
Fixed
- Fixed a bug in setDay when using weekStartsOn that is not 0
Added
- Added
weekstoDuration. - Added
weekssupport toaddandsub. - Added details message in
throwProtectedError.
2.9.0 - 2020-01-08
Thanks to @mborgbrant, @saintplay, @mrenty, @kibertoad, @levibuzolic, @Anshuman71, @talgautb, @filipjuza, @tobyzerner, @emil9453, @fintara, @pascaliske, @rramiachraf, @marnusw and @Imballinst for working on the release.
Fixed
- Fixed a bug with addBusinessDays returning the Tuesday when adding 1 day on weekends. Now it returns the Monday.
- Added missing timezone to
formatISO. - Removed dots from short day period names in the Kazakh locale.
- Fixed typo in formatDistance in the Czech locale.
- Fixed shortenings in the Bulgarian locale.
- Fixed regex for the May in the Portuguese locale.
Added
- Added
eachMonthOfIntervalandeachYearOfInterval. - Added
inclusiveoption to `areIntervalsOverlapping. - Added
isExistsfunction that checks if the given date is exists. - Added
addfunction to add seconds, minutes, hours, weeks, years in single call. - Added
subfunction, the opposite ofadd. - Added
Durationtype used inaddandsub. - Added Azerbaijani (az) locale.
- Added Moroccan Arabic (ar-MA) locale.
Changed
- Reduced the total minified build size by 1Kb/4%.
- Made all properties in
Localetype optional. - Added missing properties to
Localetype. - Add the locale code to
Localetype. - Added support of space time separator to
parseJSON. - Allowed up to 7 digits in milliseconds in
parseJSON.
2.8.1 - 2019-11-22
Thanks to @Imballinst for the bug fix!
Fixed
2.8.0 - 2019-11-19
Kudos to @NaridaL, @Zyten, @Imballinst, @leshakoss and @Neorth for working on the release.
Fixed
Added
- Added Malay (ms) locale.
- Added
formatISO,formatISO9075,formatRFC3339, andformatRFC7231functions.
2.7.0 - 2019-11-07
Thanks to @mzgajner, @NaridaL, @Zyten, @leshakoss, @fintara, @kpr-hellofresh for contributing to the release.
Fixed
- Fixed a mistake in the Slovenian locale.
- Fixed incorrect behavior of
parseISOin Firefox caused by differences ingetTimezoneOffset.
Changed
- Make object arguments types more elaborate in Flow type definitions.
- Get rid of deprecated Function in Flow type definitions.
- Allow
parseJSONto accept strings without trailing 'Z' symbol and with up to 6 digits in the milliseconds' field.
Added
2.6.0 - 2019-10-22
Kudos to @marnusw, @cdrikd and @rogyvoje for working on the release!
Added
- Added
parseJSON- lightweight function (just 411 B) that parses dates formatted withtoJSON. - Added the language code to each locale.
- Added
subBusinessDaysfunction. - Added both Serbian - cyrillic (sr) and latin (sr-Latn) locales.
2.5.1 - 2019-10-18
Thanks to @mitchellbutler for the bug fix!
Fixed
2.5.0 - 2019-10-16
Kudos to @dkozickis, @drugoi, @kranthilakum, @102, @gpetrioli and @JulienMalige for making the release happen.
Fixed
Added
- Added Kazakh (kk) locale.
- Added Telugu (te) locale.
- Added Canadian French (fr-CA) locale.
- Added Australian English (en-AU) locale.
- Exported
IntervalandLocaletypes from Flow typings.
2.4.1 - 2019-09-28
Thanks to @mrclayman for reporting the issue and @leshakoss for fixing it.
Fixed
2.4.0 - 2019-09-27
This release is brought to you by these amazing people: @lovelovedokidoki, @alexigityan, @kalekseev and @andybangs. You rock!
Fixed
- Fixed Vietnamese parsing patterns.
- Fixed Czech parsing regexes.
- Fixed offset for Eastern Hemisphere in
parseISO.
Added
2.3.0 - 2019-09-24
Huge thanks to @lovelovedokidoki who improved 8 (!) locales in an unstoppable open-source rampage and @VesterDe for fixing Slovenian locale 👏
Fixed
- Fixed the translation of "yesterday" in the Slovenian locale.
- Fixed French parsing issues with June and August.
- Improved Turkish parsing.
- Fixed "March" in Dutch parsing patterns.
- Fixed Hindi parsing patterns.
Added
- Added Finnish matching patterns.
- Accept abbreviated March, June, July in Norwegian locales.
- Added parsing for Greek months with long formatting.
2.2.1 - 2019-09-12
Kudos to date-fns contributors: @mzgajner, @sibiraj-s, @mukeshmandiwal, @SneakyFish5 and @CarterLi.
Added
- Added new
setfunction. - Updated Slovenian (sl) locale for v2.
- Added Tamil (ta) locale.
- Added Hindi (hi) locale.
- Added support of
\ninformat,lightFormatandparse.
2.1.0 - 2019-09-06
Thanks to date-fns contributors: @ManadayM, @illuminist, @visualfanatic, @vsaarinen and at last but not the least @leshakoss!
Fixed
- Set start of the week to Sunday for Thai locale.
- Fixed month matching in Polish locale.
- Fixed
eachWeekendOfIntervalskipping the first date in the supplied interval.
Added
2.0.1 - 2019-08-23
Fixed
- Fix
getWeekOfMonthwithoptions.weekStartsOnset to 1 not working for Sundays. Kudos to @waseemahmad31!
2.0.0 - 2019-08-20
If you're upgrading from v2 alpha or beta, see the pre-release changelog.
Fixed
-
Fixed the
toDatebug occurring when parsing ISO-8601 style dates (but not valid ISO format) with a trailing Z (e.g2012-01Z), it returned Invalid Date for FireFox/IE11 #510 -
Fixed
differenceIn...functions returning negative zero in some cases: #692 -
isDatenow works properly with dates passed across iframes #754. -
Fixed a few bugs that appeared in timezones with offsets that include seconds (e.g. GMT+00:57:44). See PR #789.
-
Fixed DST issue. See #972 and #992 for more details.
-
Fixed DST issue in
eachDayOfIntervalthat caused time in the days after DST change to have the shift as well. -
Fixed bug in Galician locale caused by incorrect usage of
getHoursinstead ofgetUTCHours.
Changed
-
BREAKING: now functions don't accept string arguments, but only numbers or dates. When a string is passed, it will result in an unexpected result (
Invalid Date,NaN, etc).From now on a string should be parsed using
parseISO(ISO 8601) orparse.In v1 we've used
new Date()to parse strings, but it resulted in many hard-to-track bugs caused by inconsistencies in different browsers. To address that we've implemented our ISO 8601 parser but that made library to significantly grow in size. To prevent inevitable bugs and keep the library tiny, we made this trade-off.See this post for more details.
// Before v2.0.0 addDays("2016-01-01", 1); // v2.0.0 onward addDays(parseISO("2016-01-01"), 1); -
BREAKING: new format string API for
formatfunction which is based on Unicode Technical Standard #35. See this post for more details.Unit v2 Pattern v1 Pattern Result examples Era G..GGG AD, BC GGGG Anno Domini, Before Christ GGGGG A, B Calendar year y 44, 1, 1900, 2017 yo 44th, 1st, 0th, 17th yy YY 44, 01, 00, 17 yyy 044, 001, 1900, 2017 yyyy YYYY 0044, 0001, 1900, 2017 yyyyy ... Local week-numbering year Y 44, 1, 1900, 2017 Yo 44th, 1st, 1900th, 2017th YY 44, 01, 00, 17 YYY 044, 001, 1900, 2017 YYYY 0044, 0001, 1900, 2017 YYYYY ... ISO week-numbering year R -43, 0, 1, 1900, 2017 RR GG -43, 00, 01, 1900, 2017 RRR -043, 000, 001, 1900, 2017 RRRR GGGG -0043, 0000, 0001, 1900, 2017 RRRRR ... Extended year u -43, 0, 1, 1900, 2017 uu -43, 01, 1900, 2017 uuu -043, 001, 1900, 2017 uuuu -0043, 0001, 1900, 2017 uuuuu ... Quarter (formatting) Q 1, 2, 3, 4 Qo 1st, 2nd, 3rd, 4th QQ 01, 02, 03, 04 QQQ Q1, Q2, Q3, Q4 QQQQ 1st quarter, 2nd quarter, ... QQQQQ 1, 2, 3, 4 Quarter (stand-alone) q Q 1, 2, 3, 4 qo Qo 1st, 2nd, 3rd, 4th qq 01, 02, 03, 04 qqq Q1, Q2, Q3, Q4 qqqq 1st quarter, 2nd quarter, ... qqqqq 1, 2, 3, 4 Month (formatting) M 1, 2, ..., 12 Mo 1st, 2nd, ..., 12th MM 01, 02, ..., 12 MMM Jan, Feb, ..., Dec MMMM January, February, ..., December MMMMM J, F, ..., D Month (stand-alone) L M 1, 2, ..., 12 Lo 1st, 2nd, ..., 12th LL MM 01, 02, ..., 12 LLL MMM Jan, Feb, ..., Dec LLLL MMMM January, February, ..., December LLLLL J, F, ..., D Local week of year w 1, 2, ..., 53 wo 1st, 2nd, ..., 53th ww 01, 02, ..., 53 ISO week of year I W 1, 2, ..., 53 Io Wo 1st, 2nd, ..., 53th II WW 01, 02, ..., 53 Day of month d D 1, 2, ..., 31 do Do 1st, 2nd, ..., 31st dd DD 01, 02, ..., 31 Day of year D DDD 1, 2, ..., 365, 366 Do DDDo 1st, 2nd, ..., 365th, 366th DD 01, 02, ..., 365, 366 DDD DDDD 001, 002, ..., 365, 366 DDDD ... Day of week (formatting) E..EEE Mon, Tue, Wed, ..., Su EEEE Monday, Tuesday, ..., Sunday EEEEE M, T, W, T, F, S, S EEEEEE Mo, Tu, We, Th, Fr, Sa, Su ISO day of week (formatting) i E 1, 2, 3, ..., 7 io do 1st, 2nd, ..., 7th ii 01, 02, ..., 07 iii ddd Mon, Tue, Wed, ..., Su iiii dddd Monday, Tuesday, ..., Sunday iiiii M, T, W, T, F, S, S iiiiii dd Mo, Tu, We, Th, Fr, Sa, Su Local day of week (formatting) e 2, 3, 4, ..., 1 eo 2nd, 3rd, ..., 1st ee 02, 03, ..., 01 eee Mon, Tue, Wed, ..., Su eeee Monday, Tuesday, ..., Sunday eeeee M, T, W, T, F, S, S eeeeee Mo, Tu, We, Th, Fr, Sa, Su Local day of week (stand-alone) c 2, 3, 4, ..., 1 co 2nd, 3rd, ..., 1st cc 02, 03, ..., 01 ccc Mon, Tue, Wed, ..., Su cccc Monday, Tuesday, ..., Sunday ccccc M, T, W, T, F, S, S cccccc Mo, Tu, We, Th, Fr, Sa, Su AM, PM a..aaa A AM, PM aaaa aa a.m., p.m. aaaaa a, p AM, PM, noon, midnight b..bbb AM, PM, noon, midnight bbbb a.m., p.m., noon, midnight bbbbb a, p, n, mi Flexible day period B..BBB at night, in the morning, ... BBBB at night, in the morning, ... BBBBB at night, in the morning, ... Hour [1-12] h 1, 2, ..., 11, 12 ho 1st, 2nd, ..., 11th, 12th hh 01, 02, ..., 11, 12 Hour [0-23] H 0, 1, 2, ..., 23 Ho 0th, 1st, 2nd, ..., 23rd HH 00, 01, 02, ..., 23 Hour [0-11] K 1, 2, ..., 11, 0 Ko 1st, 2nd, ..., 11th, 0th KK 1, 2, ..., 11, 0 Hour [1-24] k 24, 1, 2, ..., 23 ko 24th, 1st, 2nd, ..., 23rd kk 24, 01, 02, ..., 23 Minute m 0, 1, ..., 59 mo 0th, 1st, ..., 59th mm 00, 01, ..., 59 Second s 0, 1, ..., 59 so 0th, 1st, ..., 59th ss 00, 01, ..., 59 Fraction of second S 0, 1, ..., 9 SS 00, 01, ..., 99 SSS 000, 0001, ..., 999 SSSS ... Timezone (ISO-8601 w/ Z) X -08, +0530, Z XX -0800, +0530, Z XXX -08:00, +05:30, Z XXXX -0800, +0530, Z, +123456 XXXXX -08:00, +05:30, Z, +12:34:56 Timezone (ISO-8601 w/o Z) x -08, +0530, +00 xx ZZ -0800, +0530, +0000 xxx Z -08:00, +05:30, +00:00 xxxx -0800, +0530, +0000, +123456 xxxxx -08:00, +05:30, +00:00, +12:34:56 Timezone (GMT) O...OOO GMT-8, GMT+5:30, GMT+0 OOOO GMT-08:00, GMT+05:30, GMT+00:00 Timezone (specific non-locat.) z...zzz GMT-8, GMT+5:30, GMT+0 zzzz GMT-08:00, GMT+05:30, GMT+00:00 Seconds timestamp t X 512969520 tt ... Milliseconds timestamp T x 512969520900 TT ... Long localized date P 5/29/53 PP May 29, 1453 PPP May 29th, 1453 PPPP Sunday, May 29th, 1453 Long localized time p 12:00 AM pp 12:00:00 AM ppp 12:00:00 AM GMT+2 pppp 12:00:00 AM GMT+02:00 Combination of date and time Pp 5/29/53, 12:00 AM PPpp May 29, 1453, 12:00 AM PPPppp May 29th, 1453 at ... PPPPpppp Sunday, May 29th, 1453 at ... Characters are now escaped using single quote symbols (
') instead of square brackets.formatnow throws RangeError if it encounters an unescaped latin character that isn't a valid formatting token.To use
YYandYYYYtokens that represent week-numbering years, you should setuseAdditionalWeekYearTokensoption:format(Date.now(), "YY", { useAdditionalWeekYearTokens: true }); //=> '86'To use
DandDDtokens which represent days of the year, setuseAdditionalDayOfYearTokensoption:format(Date.now(), "D", { useAdditionalDayOfYearTokens: true }); //=> '364' -
BREAKING: function submodules now use camelCase naming schema:
// Before v2.0.0 import differenceInCalendarISOYears from "date-fns/difference_in_calendar_iso_years"; // v2.0.0 onward import differenceInCalendarISOYears from "date-fns/differenceInCalendarISOYears"; -
BREAKING: min and max functions now accept an array of dates rather than spread arguments.
// Before v2.0.0 var date1 = new Date(1989, 6 /* Jul */, 10); var date2 = new Date(1987, 1 /* Feb */, 11); var minDate = min(date1, date2); var maxDate = max(date1, date2); // v2.0.0 onward: var dates = [ new Date(1989, 6 /* Jul */, 10), new Date(1987, 1 /* Feb */, 11), ]; var minDate = min(dates); var maxDate = max(dates); -
BREAKING: make the second argument of
formatrequired for the sake of explicitness.// Before v2.0.0 format(new Date(2016, 0, 1)); // v2.0.0 onward format(new Date(2016, 0, 1), "yyyy-MM-dd'T'HH:mm:ss.SSSxxx"); -
BREAKING renamed ISO week-numbering year helpers:
addISOYears→addISOWeekYearsdifferenceInCalendarISOYears→differenceInCalendarISOWeekYearsdifferenceInISOYears→differenceInISOWeekYearsendOfISOYear→endOfISOWeekYeargetISOYear→getISOWeekYearisSameISOYear→isSameISOWeekYearlastDayOfISOYear→lastDayOfISOWeekYearsetISOYear→setISOWeekYearsubISOYears→subISOWeekYears
i.e. "ISO year" renamed to "ISO week year", which is short for ISO week-numbering year. It makes them consistent with locale-dependent week-numbering year helpers, e.g.,
startOfWeekYear. -
BREAKING: functions renamed:
areRangesOverlapping→areIntervalsOverlappingeachDay→eachDayOfIntervalgetOverlappingDaysInRanges→getOverlappingDaysInIntervalsisWithinRange→isWithinInterval
This change was made to mirror the use of the word "interval" in standard ISO 8601:2004 terminology:
2.1.3 time interval part of the time axis limited by two instantsAlso these functions now accept an object with
startandendproperties instead of two arguments as an interval. All these functions throwRangeErrorif the start of the interval is after its end or if any date in the interval isInvalid Date.// Before v2.0.0 areRangesOverlapping( new Date(2014, 0, 10), new Date(2014, 0, 20), new Date(2014, 0, 17), new Date(2014, 0, 21), ); eachDay(new Date(2014, 0, 10), new Date(2014, 0, 20)); getOverlappingDaysInRanges( new Date(2014, 0, 10), new Date(2014, 0, 20), new Date(2014, 0, 17), new Date(2014, 0, 21), ); isWithinRange( new Date(2014, 0, 3), new Date(2014, 0, 1), new Date(2014, 0, 7), ); // v2.0.0 onward areIntervalsOverlapping( { start: new Date(2014, 0, 10), end: new Date(2014, 0, 20) }, { start: new Date(2014, 0, 17), end: new Date(2014, 0, 21) }, ); eachDayOfInterval({ start: new Date(2014, 0, 10), end: new Date(2014, 0, 20), }); getOverlappingDaysInIntervals( { start: new Date(2014, 0, 10), end: new Date(2014, 0, 20) }, { start: new Date(2014, 0, 17), end: new Date(2014, 0, 21) }, ); isWithinInterval(new Date(2014, 0, 3), { start: new Date(2014, 0, 1), end: new Date(2014, 0, 7), }); -
BREAKING: functions renamed:
distanceInWords→formatDistancedistanceInWordsStrict→formatDistanceStrictdistanceInWordsToNow→formatDistanceToNow
to make them consistent with
formatandformatRelative. -
BREAKING: The order of arguments of
distanceInWordsanddistanceInWordsStrictis swapped to make them consistent withdifferenceIn...functions.// Before v2.0.0 distanceInWords( new Date(1986, 3, 4, 10, 32, 0), new Date(1986, 3, 4, 11, 32, 0), { addSuffix: true }, ); //=> 'in about 1 hour' // v2.0.0 onward formatDistance( new Date(1986, 3, 4, 11, 32, 0), new Date(1986, 3, 4, 10, 32, 0), { addSuffix: true }, ); //=> 'in about 1 hour' -
BREAKING:
partialMethodoption informatDistanceStrictis renamed toroundingMethod.// Before v2.0.0 distanceInWordsStrict( new Date(1986, 3, 4, 10, 32, 0), new Date(1986, 3, 4, 10, 33, 1), { partialMethod: "ceil" }, ); //=> '2 minutes' // v2.0.0 onward formatDistanceStrict( new Date(1986, 3, 4, 10, 33, 1), new Date(1986, 3, 4, 10, 32, 0), { roundingMethod: "ceil" }, ); //=> '2 minutes' -
BREAKING: in
formatDistanceStrict, ifroundingMethodis not specified, it now defaults toroundinstead offloor. -
BREAKING:
unitoption informatDistanceStrictnow accepts one of the strings: 'second', 'minute', 'hour', 'day', 'month' or 'year' instead of 's', 'm', 'h', 'd', 'M' or 'Y'// Before v2.0.0 distanceInWordsStrict( new Date(1986, 3, 4, 10, 32, 0), new Date(1986, 3, 4, 10, 33, 1), { unit: "m" }, ); // v2.0.0 onward formatDistanceStrict( new Date(1986, 3, 4, 10, 33, 1), new Date(1986, 3, 4, 10, 32, 0), { unit: "minute" }, ); -
BREAKING:
parsethat previously used to convert strings and numbers to dates now parses only strings in an arbitrary format specified as an argument. UsetoDateto coerce numbers andparseISOto parse ISO 8601 strings.// Before v2.0.0 parse("2016-01-01"); parse(1547005581366); parse(new Date()); // Clone the date // v2.0.0 onward parse("2016-01-01", "yyyy-MM-dd", new Date()); parseISO("2016-01-01"); toDate(1547005581366); toDate(new Date()); // Clone the date -
BREAKING:
toDate(previouslyparse) now doesn't accept string arguments but only numbers and dates.toDatecalled with an invalid argument will returnInvalid Date. -
BREAKING: new locale format. See docs/Locale. Locales renamed:
en→en-USzh_cn→zh-CNzh_tw→zh-TW
// Before v2.0.0 import locale from "date-fns/locale/zh_cn"; // v2.0.0 onward import locale from "date-fns/locale/zh-CN"; -
BREAKING: now
closestToandclosestIndexTodon't throw an exception when the second argument is not an array, and return Invalid Date instead. -
BREAKING: now
isValiddoesn't throw an exception if the first argument is not an instance of Date. Instead, argument is converted beforehand usingtoDate.Examples:
isValidargumentBefore v2.0.0 v2.0.0 onward new Date()truetruenew Date('2016-01-01')truetruenew Date('')falsefalsenew Date(1488370835081)truetruenew Date(NaN)falsefalse'2016-01-01'TypeErrorfalse''TypeErrorfalse1488370835081TypeErrortrueNaNTypeErrorfalseWe introduce this change to make date-fns consistent with ECMAScript behavior that try to coerce arguments to the expected type (which is also the case with other date-fns functions).
-
BREAKING: functions now throw
RangeErrorif optional values passed tooptionsare notundefinedor have expected values. This change is introduced for consistency with ECMAScript standard library which does the same. -
BREAKING:
format,formatDistance(previouslydistanceInWords) andformatDistanceStrict(previouslydistanceInWordsStrict) now throwRangeErrorif one of the passed arguments is invalid. It reflects behavior oftoISOStringand Intl API. See #1032. -
BREAKING: all functions now implicitly convert arguments by following rules:
date number string boolean 0 new Date(0) 0 '0' false '0' Invalid Date 0 '0' false 1 new Date(1) 1 '1' true '1' Invalid Date 1 '1' true true Invalid Date NaN 'true' true false Invalid Date NaN 'false' false null Invalid Date NaN 'null' false undefined Invalid Date NaN 'undefined' false NaN Invalid Date NaN 'NaN' false Notes:
- as before, arguments expected to be
Dateare converted toDateusing date-fns'toDatefunction; - arguments expected to be numbers are converted to integer numbers using our custom
toIntegerimplementation (see #765); - arguments expected to be strings are converted to strings using JavaScript's
Stringfunction; - arguments expected to be booleans are converted to boolean using JavaScript's
Booleanfunction.
nullandundefinedpassed to optional arguments (i.e. properties ofoptionsargument) are ignored as if no argument was passed.If any resulting argument is invalid (i.e.
NaNfor numbers andInvalid Datefor dates), an invalid value will be returned:falsefor functions that return booleans (expectisValid);Invalid Datefor functions that return dates;- and
NaNfor functions that return numbers.
- as before, arguments expected to be
-
BREAKING: all functions now check if the passed number of arguments is less than the number of required arguments and will throw
TypeErrorexception if so. -
BREAKING: all functions that accept numbers as arguments, now coerce values using
Number()and also round off decimals. Positive decimals are rounded usingMath.floor, decimals less than zero are rounded usingMath.ceil. -
BREAKING: The Bower & UMD/CDN package versions are no longer supported.
-
BREAKING:
nullnow is not a valid date.isValid(null)returnsfalse;toDate(null)returns an invalid date. SincetoDateis used internally by all the functions, operations overnullwill also return an invalid date. See #537 for the reasoning. -
toDate(previouslyparse) andisValidfunctions now acceptanytype as the first argument. -
Exclude
docs.jsonfrom the npm package. Kudos to @hawkrives.
Added
-
FP functions like those in lodash, that support currying, and, as a consequence, functional-style function composing.
Functions with options (
format,parse, etc.) have two FP counterparts: one that has the options object as its first argument and one that hasn't. The name of the former hasWithOptionsadded to the end of its name.In FP functions, the order of arguments is reversed.
See FP Guide for more information.
import addYears from "date-fns/fp/addYears"; import formatWithOptions from "date-fns/fp/formatWithOptions"; import eo from "date-fns/locale/eo"; // If FP function has not received enough arguments, it returns another function const addFiveYears = addYears(5); // Several arguments can be curried at once const dateToString = formatWithOptions({ locale: eo }, "d MMMM yyyy"); const dates = [ new Date(2017, 0 /* Jan */, 1), new Date(2017, 1 /* Feb */, 11), new Date(2017, 6 /* Jul */, 2), ]; const formattedDates = dates.map((date) => dateToString(addFiveYears(date))); //=> ['1 januaro 2022', '11 februaro 2022', '2 julio 2022'] -
Added support for ECMAScript Modules.
It allows usage with bundlers that support tree-shaking, like rollup.js and webpack:
// Without tree-shaking: import format from "date-fns/format"; import parse from "date-fns/parse"; // With tree-shaking: import { format, parse } from "date-fns";Also, ESM functions provide default export, they can be used with TypeScript to import functions in more idiomatic way:
// Before import * as format from "date-fns/format"; // Now import format from "date-fns/format"; -
formatRelativefunction. See formatRelative -
Flow typings for
index.js,fp/index.js,locale/index.js, and their ESM equivalents. See PR #558 -
New locale-dependent week-numbering year helpers:
-
getWeek -
getWeekYear -
setWeek -
setWeekYear -
startOfWeekYear
-
-
Added
eachWeekOfInterval, the weekly equivalent ofeachDayOfInterval -
Added
getUnixTimefunction. Kudos to @Kingwl. -
New decade helpers. Thanks to @y-nk!
-
getDecade -
startOfDecade -
endOfDecade -
lastDayOfDecade
-
-
New
roundToNearestMinutesfunction. Kudos to @xkizer. -
Added new function
fromUnixTime. Thanks to @xkizer. -
New interval, month, and year helpers to fetch a list of all Saturdays and Sundays (weekends) for a given date interval.
eachWeekendOfIntervalis the handler function while the other two are wrapper functions. Kudos to @laekettavong!-
eachWeekendOfInterval -
eachWeekendOfMonth -
eachWeekendOfYear
-
-
Build-efficient
lightFormatthat only supports the popular subset of tokens. See #1050. -
parseISOfunction that parses ISO 8601 strings. See #1023. -
Add constants that can be imported directly from
date-fnsor the submoduledate-fns/constants:-
maxTime -
minTime
-
-
New locales:
-
Added new function
differenceInBusinessDayswhich calculates the difference in business days. Kudos to @ThorrStevens! -
Added new function
addBusinessDays, similar toaddDaysbut ignoring weekends. Thanks to @ThorrStevens!
[1.30.1] - 2018-12-10
Fixed
-
Fixed DST issue. See #972 and #992 for more details. This fix was backported from v2.
-
Fix a few bugs that appear in timezones with offsets that include seconds (e.g. GMT+00:57:44). See PR #789. This fix was backported from v2.
-
Fixed misspelled January in the Thai locale. Thanks to @ratchapol-an!
Added
-
Added Serbian locale. Kudos to @mawi12345!
-
Added Belarusian locale. Kudos to @mawi12345 again!
Changed
- Improved ja translation of distanceInWords. Thanks to @kudohamu!
[1.30.0] - 2018-12-10
⚠️ The release got failed.
[1.29.0] - 2017-10-11
Fixed
- Fixed Italian translations for
formatDistance. (see the issue: #550; see the PR: #552) Thanks to @giofilo!
Added
-
Hungarian locale (hu) (thanks to László Horváth @horvathlg)
-
Slovenian locale (sl) (thanks to Adam Stradovnik @Neoglyph)
-
Added
steptoeachDayfunction. Thanks to @BDav24. See PR #487.
1.28.5 - 2017-05-19
Fixed
1.28.4 - 2017-04-26
Fixed
-
Fixed accents on weekdays in the Italian locale. See PR #481. Thanks to @albertorestifo
-
Fixed typo in
dddformat token in Spanish language locale. Kudos to @fjaguero. See PR #482
1.28.3 - 2017-04-14
Fixed
1.28.2 - 2017-03-27
Fixed
1.28.1 - 2017-03-19
Fixed
-
Fixed DST border bug in
addMilliseconds,addSeconds,addMinutes,addHours,subMilliseconds,subSeconds,subMinutesandsubHours. See issue #465 -
Minor fix for Indonesian locale. Thanks to @bentinata. See PR: #458
1.28.0 - 2017-02-27
Added
- Romanian locale (ro) (thanks to Sergiu Munteanu @jsergiu)
Fixed
-
All functions now convert all their arguments to the respective types. See PR: #443
-
Fixes for ordinals (1er, 2, 3, …) in French locale. Thanks to @fbonzon. See PR: #449
1.27.2 - 2017-02-01
Fixed
- Various fixes for Dutch locale. See PR: #416. Thanks to Ruben Stolk @rubenstolk
1.27.1 - 2017-01-20
Fixed
- Added generation of TypeScript locale sub-modules, allowing import of locales in TypeScript.
1.27.0 - 2017-01-19
Added
- Macedonian locale (mk) (thanks to Petar Vlahu @vlahupetar)
1.26.0 - 2017-01-15
Added
getTime
Fixed
1.25.0 - 2017-01-11
Added
-
Bulgarian locale (bg) (thanks to Nikolay Stoynov @arvigeus)
-
Czech locale (cs) (thanks to David Rus @davidrus)
1.24.0 - 2017-01-06
Added
- Modern Standard Arabic locale (ar) (thanks to Abdallah Hassan @AbdallahAHO)
1.23.0 - 2017-01-05
Added
-
Auto generate TypeScript and flow typings from documentation on release. Thanks to @mattlewis92. See related PRs: #355, #370
-
Croatian locale (hr) (thanks to Matija Marohnić @silvenon)
-
Thai locale (th) (thanks to Athiwat Hirunworawongkun @athivvat)
-
Finnish locale (fi) (thanks to Pyry-Samuli Lahti @Pyppe)
1.22.0 - 2016-12-28
Added
- Icelandic locale (is) (thanks to Derek Blank @derekblank)
1.21.1 - 2016-12-18
Fixed
- Fixed
isBeforeandisAfterdocumentation mistakes.
1.21.0 - 2016-12-16
Added
-
Filipino locale (fil) (thanks to Ian De La Cruz @RIanDeLaCruz)
-
Danish locale (da) (kudos to Anders B. Hansen @Andersbiha)
1.20.1 - 2016-12-14
Fixed
- Fixed documentation for
getOverlappingDaysInRanges.
1.20.0 - 2016-12-13
Added
1.19.0 - 2016-12-13
Added
-
Greek locale (el) (kudos to Theodoros Orfanidis @teoulas)
-
Slovak locale (sk) (kudos to Marek Suscak @mareksuscak)
-
Added yarn support. Thanks to Uladzimir Havenchyk @havenchyk. See PR: #288
1.18.0 - 2016-12-12
Added
-
Turkish locale (tr) (kudos to Alpcan Aydın @alpcanaydin)
-
Korean locale (ko) (thanks to Hong Chulju @angdev)
Fixed
SSandSSSformats informatare now correctly displayed with leading zeros. Thanks to Paul Dijou @pauldijou. See PR: #330
1.17.0 - 2016-12-10
Added
-
Polish locale (pl) (thanks to Mateusz Derks @ertrzyiks)
-
Portuguese locale (pt) (thanks to Dário Freire @dfreire)
-
Swedish locale (sv) (thanks to Johannes Ulén @ejulen)
-
French locale (fr) (thanks to Jean Dupouy @izeau)
-
Performance tests. See PR: #289
Fixed
-
Fixed TypeScript and flow typings for
isValid. See PR: #310 -
Fixed incorrect locale tests that could potentially lead to
formatbugs. Kudos to Mateusz Derks @ertrzyiks. See related PRs: #312, #320 -
Minor language fixes in the documentation. Thanks to Vedad Šoše @vedadsose (#314) and Asia @asia-t (#318)
Changed
-
formatnow returnsString('Invalid Date')if the passed date is invalid. See PR: #323 -
distanceInWords,distanceInWordsToNow,distanceInWordsStrictandformatfunctions now check if the passed locale is valid, and fallback to English locale otherwise. See PR: #321 -
Internal: use a loop instead of
Object.keysinbuildFormattingTokensRegExpto improve compatibility with older browsers. See PR: #322
1.16.0 - 2016-12-08
Added
-
Italian locale (it) (thanks to Alberto Restifo @albertorestifo)
-
For German
buildDistanceInWordsLocale, add nominative case translations (for distances without a suffix). Kudos to Asia @asia-t. See related PR: #295
1.15.1 - 2016-12-07
Fixed
- Fixed TypeScript imports from individual modules. Thanks to @mattlewis92. See related PR: #287
1.15.0 - 2016-12-07
Added
-
Indonesian locale (id) (thanks to Rahmat Budiharso @rbudiharso)
-
Catalan locale (ca) (thanks to Guillermo Grau @guigrpa)
Fixed
1.14.1 - 2016-12-06
Fixed
- Fixed broken test for Norwegian Bokmål locale.
1.14.0 - 2016-12-06
Added
- Norwegian Bokmål locale (nb) (thanks to Hans-Kristian Koren @Hanse)
1.13.0 - 2016-12-06
Added
-
Chinese Traditional locale (zh_tw) (thanks to tonypai @tpai).
-
Dutch language locale (nl) (kudos to Jorik Tangelder @jtangelder)
1.12.1 - 2016-12-05
Fixed
- Added
distanceInWordsStrictto the list of supported functions in I18n doc.
1.12.0 - 2016-12-05
Added
- Spanish language locale (es) (thanks to Juan Angosto @juanangosto).
Fixed
- Fixed flow typings for some of the functions. See PR: #273
1.11.2 - 2016-11-28
Fixed
-
Bug in
parsewhen it sometimes parses ISO week-numbering dates incorrectly. See PR: #262 -
Bug in some functions which caused them to handle dates earlier than 100 AD incorrectly. See PR: #263
1.11.1 - 2016-11-24
Fixed
- Include TypeScript typings with npm package.
1.11.0 - 2016-11-23
Added
-
distanceInWordsStrict. Kudos to @STRML. See related PR: #254 -
TypeScript typings for all functions. Kudos to @mattlewis92. See related PR: #255
1.10.0 - 2016-11-01
Added
-
parsenow can parse dates that are ISO 8601 centuries (e.g.,19and+0019).var result = parse("19"); //=> Mon Jan 01 1900 00:00:00 -
In
parse, added ability to specify the number of additional digits for extended year or century format (possible values are 0, 1 or 2; default is 2).parse("+002016-11-01"); parse("+02016-11-01", { additionalDigits: 1 }); parse("+2016-11-01", { additionalDigits: 0 });
1.9.0 - 2016-10-25
Added
- Got index.js imports to work with SystemJS.
1.8.1 - 2016-10-24
Fixed
- Added Japanese and German language locales to the list in I18n doc.
1.8.0 - 2016-10-23
Added
-
Japanese language locale (ja) (thanks to Thomas Eilmsteiner @DeMuu again!)
-
getISODay -
setISODay
1.7.0 - 2016-10-20
Added
- German language locale (de) (thanks to Thomas Eilmsteiner @DeMuu).
1.6.0 - 2016-10-16
Added
- Chinese Simplified locale (zh_cn) (kudos to Changyu @KingMario Geng).
1.5.2 - 2016-10-13
Fixed
-
Incorrectly generated docs for
format. -
Fixed typo in I18n doc.
1.5.1 - 2016-10-12
Fixed
- A change log entry for 1.5.0 is added.
1.5.0 - 2016-10-12
Added
1.4.0 - 2016-10-09
Added
- Basic SystemJS support.
Fixed
- Fixed incorrect behaviour of
YYYYandYYfor years prior to 1000: nowformat(new Date('0001-01-01'), 'YYYY-MM-DD')returns0001-01-01instead of1-01-01.
1.3.0 - 2016-05-26
Added
closestIndexTo
1.2.0 - 2016-05-23
Added
- Added an ability to pass negative numbers to
setDay.
1.1.1 - 2016-05-19
Fixed
- Fixed Flow declarations for some of the functions.
1.1.0 - 2016-05-19
Added
-
Flow declarations for each function in the ".js.flow" style. Kudos to @JohnyDays. See related PRs:
1.0.0 - 2016-05-18
Fixed
-
formatnow returns the correct result for keyE. -
Prevent
startOf...,endOf...andlastDayOf...functions to return dates with an incorrect time when the date is modifying into another time zone. -
parsenow parses years from 1 AD to 99 AD correctly. -
Fix a bug in
getISOWeekappearing because of a changing time zone (e.g., when the given date is in DST and the start of the ISO year is not).
Changed
-
BREAKING: all functions are moved to the root of the library, so they are now accessible with
require('date-fns/name_of_function')orimport nameOfFunction from 'date-fns/name_of_function'.// Before v1.0.0 var addMonths = require("date-fns/src/add_months"); // v1.0.0 onward var addMonths = require("date-fns/add_months"); -
BREAKING: functions that had the last optional argument
weekStartsAt(i.e.endOfWeek,isSameWeek,lastDayOfWeek,setDay,startOfWeek) now instead receive the objectoptionswith the propertyoptions.weekStartsOnas the last argument.// Before v1.0.0 var result = endOfWeek(new Date(2014, 8, 2), 1); // v1.0.0 onward var result = endOfWeek(new Date(2014, 8, 2), { weekStartsOn: 1 }); -
BREAKING: remove the function
getTimeSinceMidnightthat was used inside the other functions. -
BREAKING:
differenceInDaysnow returns the number of full days instead of calendar days. -
BREAKING:
eachDayandisWithinRangenow throw an exception when the given range boundaries are invalid. -
Faster
isLeapYear. -
Internal: make the documentation more verbose.
-
Internal: convert the tests from Chai to power-assert allowing them to run against IE8.
Added
-
addISOYears -
closestTo -
differenceInCalendarDays -
differenceInCalendarISOWeeks -
differenceInCalendarISOYears -
differenceInCalendarMonths -
differenceInCalendarQuarters -
differenceInCalendarWeeks -
differenceInCalendarYears -
differenceInHours -
differenceInISOYears -
differenceInMilliseconds -
differenceInMinutes -
differenceInMonths -
differenceInQuarters -
differenceInSeconds -
differenceInWeeks -
differenceInYears -
distanceInWords -
distanceInWordsToNow -
endOfISOWeek -
endOfISOYear -
endOfToday -
endOfTomorrow -
endOfYesterday -
getDaysInYear -
isDate -
isFriday -
isMonday -
isSameISOWeek -
isSameISOYear -
isSaturday -
isSunday -
isThisHour -
isThisISOWeek -
isThisISOYear -
isThisMinute -
isThisMonth -
isThisQuarter -
isThisSecond -
isThisWeek -
isThisYear -
isThursday -
isTomorrow -
isTuesday -
isValid -
isWednesday -
isYesterday -
lastDayOfISOWeek -
lastDayOfISOYear -
startOfISOWeek -
startOfToday -
startOfTomorrow -
startOfYesterday -
subISOYears -
Add
Qo,W,Wo,WW,GG,GGGG,Z,ZZ,X,xkeys toformat.
0.17.0 - 2015-09-29
Fixed
-
Fixed a lot of bugs appearing when date is modifying into other time zone (e.g., when adding months and original date is in DST but new date is not).
-
Prevent instances of Date to lose milliseconds value when passed to.
parsein IE10.
Changed
-
setISOWeeknow keeps time from original date. -
Internal: reuse
getDaysInMonthinside ofaddMonths.
Added
-
differenceInDays -
getTimeSinceMidnight -
formatnow has new format keyaa, which returnsa.m./p.m.as opposed toathat returnsam/pm. -
Complete UMD package (for Bower and CDN).
0.16.0 - 2015-09-01
Changed
-
Use
parseto clean date arguments in all functions. -
parsenow fallbacks tonew Datewhen the argument is not an ISO formatted date. -
Internal: reuse
getDaysInMonthinside ofsetMonth.
Added
-
addQuarters -
addWeeks -
endOfQuarter -
getDate -
getDay -
getDaysInMonth -
getHours -
getISOWeeksInYear -
getMilliseconds -
getMinutes -
getMonth -
getSeconds -
getYear -
isLeapYear -
isSameHour -
isSameMinute -
isSameQuarter -
isSameSecond -
lastDayOfQuarter -
lastDayOfWeek -
max -
min -
setDate -
setDay -
setHours -
setMilliseconds -
setMinutes -
setSeconds -
startOfQuarter -
subQuarters -
subWeeks
0.15.0 - 2015-08-26
Changed
-
formatnow returnsa.m./p.m.instead ofam/pm. -
setMonthnow sets last day of month if original date was last day of longer month. -
Internal: Fix code style according to ESLint.
-
Internal: Make tests run through all time zones.
Added
-
getQuarter -
setQuarter -
getDayOfYear -
setDayOfYear -
isPast -
addSeconds -
subSeconds -
startOfSecond -
endOfSecond -
startOfMinute -
endOfMinute -
addMilliseconds -
subMilliseconds -
endOfYear -
addYears -
subYears -
lastDayOfYear -
lastDayOfMonth
0.14.11 - 2015-08-21
Fixed
formatnow usesparseto avoid time zone bugs.
Changed
setIsoWeeknow sets time to the start of the day.
0.14.10 - 2015-07-29
Fixed
-
formatnow behaves correctly with 12:00 am. -
formatnow behaves correctly with ordinal numbers.
Added
-
compareAsc -
compareDesc -
addHours -
subHours -
isSameDay -
parse -
getISOYear -
setISOYear -
startOfISOYear -
getISOWeek -
setISOWeek
0.14.9 - 2015-01-14
Fixed
addMonthsnow correctly behaves with February (see #18).
0.14.8 - 2014-12-25
Fixed
formatfunction now behaves correctly withpm/am.
0.14.6 - 2014-12-04
Fixed
- Fix broken Bower support.
0.14.0 - 2014-11-05
Added
- Bower package.
0.13.0 - 2014-10-22
Added
-
addMinutes -
subMinutes -
isEqual -
isBefore -
isAfter
0.12.1 - 2014-10-19
Fixed
- Incorrect rounding in
DDDformatter.
0.12.0 - 2014-10-15
Added
isSameYear
0.11.0 - 2014-10-15
Added
isWithinRange
0.10.0 - 2014-10-13
Added
-
format -
startOfYear
0.9.0 - 2014-10-10
Changed
- Internal: simplify
isWeekend
Added
isFuture
0.8.0 - 2014-10-09
Changed
- Internal: reuse
addDaysinside ofsubDays.
Added
-
addMonths -
subMonths -
setMonth -
setYear
0.7.0 - 2014-10-08
Added
isSameWeek
0.6.0 - 2014-10-07
Fixed
- Inconsistent behavior of
endOfMonth.
Added
-
isFirstDayOfMonth -
isLastDayOfMonth -
isSameMonth
0.5.0 - 2014-10-07
Added
-
addDays -
subDays
0.4.0 - 2014-10-07
Added
-
startOfWeek -
endOfWeek -
eachDay
0.3.0 - 2014-10-06
Changed
startOfDaynow sets milliseconds as well.
Added
-
endOfDay -
startOfMonth -
endOfMonth
0.2.0 - 2014-10-06
Added
-
isToday -
isWeekend
0.1.0 - 2014-10-06
Added
startOfDay