Skip to content

Latest commit

 

History

History
1345 lines (847 loc) · 34 KB

CHANGELOG.md

File metadata and controls

1345 lines (847 loc) · 34 KB

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.

Added

  • FP functions like those in lodash, that support currying, and, as a consequence, functional-style function composing).

    Each non-FP function has two FP counterparts: one that has Options object as its first argument and one that hasn't. The name of the former has WithOptions added 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 eoLocale from 'date-fns/locale/eo'
    
    // If FP function has not recieved enough arguments, it returns another function
    const addFiveYears = addYears(5)
    
    // Several arguments can be curried at once
    const dateToString = formatWithOptions({locale: eoLocale}, '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 via 'date-fns/esm' subpackage.

    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/esm'

    Also, as 'date-fns/esm' function submodules provide default export, they can be used with TypeScript to import functions in more idiomatic way:

    // In TypeScript,
    import * as format from 'date-fns/format'
    
    // is same as:
    import format from 'date-fns/esm/format'

Changed

  • 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: remove all functions that create the current date internally:

    • distanceInWordsToNow
    • isFuture
    • isPast
    • endOfToday
    • endOfTomorrow
    • endOfYesterday
    • startOfToday
    • startOfTomorrow
    • startOfYesterday
    • isToday
    • isTomorrow
    • isYesterday
    • isThisSecond
    • isThisMinute
    • isThisHour
    • isThisWeek
    • isThisISOWeek
    • isThisMonth
    • isThisQuarter
    • isThisYear
    • isThisISOYear

    These functions are not pure, cannot have FP-versions #253 and would add extra code for UTC-versions #376.

    See issue: #377

    // Before v2.0.0
    var result = endOfToday()
    
    // v2.0.0 onward
    var result = endOfDay(new Date())

    Upgrade guide:

    • distanceInWordsToNow(date)distanceInWords(new Date(), date)
    • isFuture(date)isAfter(date, new Date())
    • isPast(date)isBefore(date, new Date())
    • endOfToday()endOfDay(new Date())
    • endOfTomorrow()endOfDay(addDays(new Date(), 1))
    • endOfYesterday()endOfDay(subDays(new Date(), 1))
    • startOfToday()startOfDay(new Date())
    • startOfTomorrow()startOfDay(addDays(new Date(), 1))
    • startOfYesterday()startOfDay(subDays(new Date(), 1))
    • isToday(date)isSameDay(new Date(), date)
    • isTomorrow(date)isSameDay(date, addDays(new Date(), 1))
    • isYesterday(date)isSameDay(date, subDays(new Date(), 1))
    • isThisSecond(date)isSameSecond(date, new Date())
    • isThisMinute(date)isSameMinute(date, new Date())
    • isThisHour(date)isSameHour(date, new Date())
    • isThisWeek(date)isSameWeek(date, new Date())
    • isThisISOWeek(date)isSameISOWeek(date, new Date())
    • isThisMonth(date)isSameMonth(date, new Date())
    • isThisQuarter(date)isSameQuarter(date, new Date())
    • isThisYear(date)isSameYear(date, new Date())
    • isThisISOYear(date)isSameISOYear(date, new Date())
  • BREAKING: make the second argument of format non-optional in favor of explicitness.

    // Before v2.0.0
    format(new Date(2016, 0, 1))
    
    // v2.0.0 onward
    format(new Date(2016, 0, 1), 'YYYY-MM-DDTHH:mm:ss.SSSZ')
  • BREAKING: functions renamed:

    • areRangesOverlappingareIntervalsOverlapping
    • eachDayeachDayOfInterval
    • getOverlappingDaysInRangesgetOverlappingDaysInIntervals
    • isWithinRangeisWithinInterval

    This change was made to mirror the use of word "interval" in standard ISO 8601:2004 terminology:

    2.1.3
    time interval
    part of the time axis limited by two instants
    

    Also these functions now accept an object with start and end properties instead of two arguments as an interval. All these functions, as before, throw an exception if the start of the interval is after its end.

    // 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: parse renamed to toDate, created a new function parse which parses a string using a provided format.

    // Before v2.0.0
    parse('2016-01-01')
    
    // v2.0.0 onward
    toDate('2016-01-01')
    parse('2016-01-01', 'YYYY-MM-DD', new Date())
  • BREAKING: the first two arguments in all differenceIn... functions are swapped to make them consistent with distanceInWords and distanceInWordsStrict functions. Now, the first date argument must be earlier then the second for function to return the positive number.

    // Before v2.0.0
    differenceInYears(
      new Date(2013, 11, 31),
      new Date(2015, 1, 11)
    )
    //=> -1
    
    // v2.0.0 onward
    differenceInYears(
      new Date(2013, 11, 31),
      new Date(2015, 1, 11)
    )
    //=> 1
  • BREAKING: format now assumes that the provided locale uses UTC-versions of Date methods, e.g. getUTCMonth instead of getMonth. All included locales are converted. This change affects only those who uses custom locales. Except handling of locales, behavior of format hasn't changed, i.e. it still formats dates in the user timezone.

    var weekdays = ['sundio', 'lundio', 'mardio', 'merkurdio', 'jovdio', 'venerdio', 'saturdio']
    
    var customLocale = {
      format: {
        formatters: {
          'dddd': function (date) {
            // Before v2.0.0
            return weekdays[date.getDay()]
    
            // v2.0.0 onward
            return weekdays[date.getUTCDay()]
          }
        },
        formattingTokensRegExp: /(\[[^[]*])|(\\)?(dddd|.)/g
      }
    }
    
    format('2017-01-01', 'dddd', {locale: customLocale}) //=> 'sundio'
  • BREAKING: now closestTo and closestIndexTo don't throw an exception when the second argument is not an instance of array.

  • BREAKING: now isValid doesn't throw an exception if the first argument is not an instance of Date. Instead, argument is converted beforehand using toDate.

    Examples:

    isValid argument Before v2.0.0 v2.0.0 onward
    new Date() true true
    new Date('2016-01-01') true true
    new Date('') false false
    new Date(1488370835081) true true
    new Date(NaN) false false
    '2016-01-01' TypeError true
    '' TypeError false
    1488370835081 TypeError true
    NaN TypeError false

    We 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).

  • Every function now has options as the last argument which is passed to all its dependencies for consistency and future features. See docs/Options.js

1.28.2 - 2017-03-27

Fixed

  • Fix dd and ddd formatters in Polish language locale. Kudos to @justrag. See PR: #467

1.28.1 - 2017-03-19

Fixed

  • Fix DST border bug in addMilliseconds, addSeconds, addMinutes, addHours, subMilliseconds, subSeconds, subMinutes and subHours. See issue #465

  • Minor fix for Indonesian locale. Thanks to @bentinata. See PR: #458

1.28.0 - 2017-02-27

Added

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

1.26.0 - 2017-01-15

Added

  • getTime

Fixed

  • Various fixes for Japanese locale. See PR: 395. Thanks to Yamagishi Kazutoshi @ykzts

1.25.0 - 2017-01-11

Added

1.24.0 - 2017-01-06

Added

1.23.0 - 2017-01-05

Added

1.22.0 - 2016-12-28

Added

1.21.1 - 2016-12-18

Fixed

  • Fix isBefore and isAfter documentation mistakes.

1.21.0 - 2016-12-16

Added

1.20.1 - 2016-12-14

Fixed

  • Fix documentation for getOverlappingDaysInRanges.

1.20.0 - 2016-12-13

Added

  • areRangesOverlapping and getOverlappingDaysInRanges Thanks to Joanna T @asia-t. See PR: #331

1.19.0 - 2016-12-13

Added

1.18.0 - 2016-12-12

Added

Fixed

  • SS and SSS formats in format are now correctly displayed with leading zeros. Thanks to Paul Dijou @pauldijou. See PR: #330

1.17.0 - 2016-12-10

Added

Fixed

  • Fix TypeScript and flow typings for isValid. See PR: #310

  • Fix incorrect locale tests that could potentially lead to format bugs. 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

  • format now returns String('Invalid Date') if the passed date is invalid. See PR: #323

  • distanceInWords, distanceInWordsToNow, distanceInWordsStrict and format functions now check if the passed locale is valid, and fallback to English locale otherwise. See PR: #321

  • Internal: use a loop instead of Object.keys in buildFormattingTokensRegExp to improve compatibility with older browsers. See PR: #322

1.16.0 - 2016-12-08

Added

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

Fixed

  • Fix some inaccuracies in Spanish locale. Kudos to @guigrpa. See related PR: #302

1.14.1 - 2016-12-06

Fixed

  • Fixed broken test for Norwegian Bokmål locale.

1.14.0 - 2016-12-06

Added

1.13.0 - 2016-12-06

Added

1.12.1 - 2016-12-05

Fixed

  • Added distanceInWordsStrict to the list of supported functions in I18n doc.

1.12.0 - 2016-12-05

Added

Fixed

  • Fix flow typings for some of the functions. See PR: #273

1.11.2 - 2016-11-28

Fixed

  • Bug in parse when 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

1.10.0 - 2016-11-01

Added

  • parse now can parse dates that are ISO 8601 centuries (e.g., 19 and +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

1.7.0 - 2016-10-20

Added

1.6.0 - 2016-10-16

Added

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

Fixed

  • Fix incorrect behaviour of YYYY and YY for years prior to 1000: now format(new Date('0001-01-01'), 'YYYY-MM-DD') returns 0001-01-01 instead of 1-01-01.

1.3.0 - 2016-05-26

Added

  • closestIndexTo

1.2.0 - 2016-05-23

Added

  • Add an ability to pass negative numbers to setDay.

1.1.1 - 2016-05-19

Fixed

  • Fix Flow declarations for some of the functions.

1.1.0 - 2016-05-19

Added

1.0.0 - 2016-05-18

Fixed

  • format now returns the correct result for key E.

  • Prevent startOf..., endOf... and lastDayOf... functions to return dates with an incorrect time when the date is modifying into another time zone.

  • parse now parses years from 1 AD to 99 AD correctly.

  • Fix a bug in getISOWeek appearing 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') or import 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 object options with the property options.weekStartsOn as 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 getTimeSinceMidnight that was used inside the other functions.

  • BREAKING: differenceInDays now returns the number of full days instead of calendar days.

  • BREAKING: eachDay and isWithinRange now 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, x keys to format.

0.17.0 - 2015-09-29

Fixed

  • Fix 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. parse in IE10.

Changed

  • setISOWeek now keeps time from original date.

  • Internal: reuse getDaysInMonth inside of addMonths.

Added

  • differenceInDays

  • getTimeSinceMidnight

  • format now has new format key aa, which returns a.m./p.m. as opposed to a that returns am/pm.

  • Complete UMD package (for Bower and CDN).

0.16.0 - 2015-09-01

Changed

  • Use parse to clean date arguments in all functions.

  • parse now fallbacks to new Date when the argument is not an ISO formatted date.

  • Internal: reuse getDaysInMonth inside of setMonth.

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

  • format now returns a.m./p.m. instead of am/pm.

  • setMonth now 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

  • format now uses parse to avoid time zone bugs.

Changed

  • setIsoWeek now sets time to the start of the day.

0.14.10 - 2015-07-29

Fixed

  • format now behaves correctly with 12:00 am.

  • format now behaves correctly with ordinal numbers.

Added

  • compareAsc

  • compareDesc

  • addHours

  • subHours

  • isSameDay

  • parse

  • getISOYear

  • setISOYear

  • startOfISOYear

  • getISOWeek

  • setISOWeek

0.14.9 - 2015-01-14

Fixed

  • addMonths now correctly behaves with February (see #18).

0.14.8 - 2014-12-25

Fixed

  • format function now behaves correctly with pm/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 DDD formatter.

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 addDays inside of subDays.

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

  • startOfDay now 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