Get + Set

Millisecond / Second / Minute / Hour

Get the Millisecond/Second/Minute/Hour of the given date.

  1. // Moment.js
  2. moment().seconds();
  3. // => 49
  4. moment().hours();
  5. // => 19
  7. // Native
  8. new Date().getSeconds();
  9. // => 49
  10. new Date().getHours();
  11. // => 19
  13. // date-fns
  14. import getSeconds from 'date-fns/getSeconds';
  15. import getHours from 'date-fns/getHours';
  16. getSeconds(new Date());
  17. // => 49
  18. getHours(new Date());
  19. // => 19
  21. // dayjs
  22. dayjs().second();
  23. // => 49
  24. dayjs().hour();
  25. // => 19
  27. // Luxon
  28. DateTime.local().second;
  29. // => 49
  30. DateTime.local().hour;
  31. // => 19

Performance tests

Library Time
Moment 1432.647ms
Native 367.769ms
DateFns 608.878ms
DayJs 502.302ms
Luxon 1296.507ms

Set the Millisecond/Second/Minute/Hour of the given date.

  1. // Moment.js
  2. moment().seconds(30);
  3. // => "2018-09-09T09:12:30.695Z"
  4. moment().hours(13);
  5. // => "2018-09-09T03:12:49.695Z"
  7. // Native
  8. new Date(new Date().setSeconds(30));
  9. // => "2018-09-09T09:12:30.695Z"
  10. new Date(new Date().setHours(13));
  11. // => "2018-09-09T03:12:49.695Z"
  13. // date-fns
  14. import setSeconds from 'date-fns/setSeconds';
  15. import setHours from 'date-fns/setHours';
  16. setSeconds(new Date(), 30);
  17. // => "2018-09-09T09:12:30.695Z"
  18. setHours(new Date(), 13);
  19. // => "2018-09-09T03:12:49.695Z"
  21. // dayjs
  22. dayjs().set('second', 30);
  23. // => "2018-09-09T09:12:30.695Z"
  24. dayjs().set('hour', 13);
  25. // => "2018-09-09T03:12:49.695Z"
  27. // luxon
  28. DateTime.utc()
  29.   .set({ second: 30 })
  30.   .toJSDate();
  31. // => "2018-09-09T09:12:30.695Z"
  32. DateTime.utc()
  33.   .set({ hour: 13 })
  34.   .toJSDate();
  35. // => "2018-09-09T03:12:49.695Z"

Performance tests

Library Time
Moment 1690.007ms
Native 636.242
DateFns 696.768ms
DayJs 1891.058ms
Luxon 8630.314ms

Date of Month

Gets or sets the day of the month.

  1. // Moment.js
  2. moment().date();
  3. // => 9
  4. moment().date(4);
  5. // => "2018-09-04T09:12:49.695Z"
  7. // Native
  8. new Date().getDate();
  9. // => 9
  10. new Date().setDate(4);
  11. // => "2018-09-04T09:12:49.695Z"
  13. // date-fns
  14. import getDate from 'date-fns/getDate';
  15. import setDate from 'date-fns/setDate';
  16. getDate(new Date());
  17. // => 9
  18. setDate(new Date(), 4);
  19. // => "2018-09-04T09:12:49.695Z"
  21. // dayjs
  22. dayjs().date();
  23. // => 9
  24. dayjs().set('date', 4);
  25. // => "2018-09-04T09:12:49.695Z"
  27. // luxon
  28. DateTime.utc().day;
  29. // => 9
  30. DateTime.utc()
  31.   .set({ day: 4 })
  32.   .toString();
  33. // => "2018-09-04T09:12:49.695Z"

Performance tests

Library Time
Moment 1349.161ms
Native 388.734ms
DateFns 602.132ms
DayJs 1088.253ms
Luxon 4728.460ms

Day of Week

Gets or sets the day of the week.

  1. // Moment.js
  2. moment().day();
  3. // => 0 (Sunday)
  4. moment().day(-14);
  5. // => "2018-08-26T09:12:49.695Z"
  7. // Native
  8. new Date().getDay();
  9. // => 0 (Sunday)
  10. new Date().setDate(new Date().getDate() - 14);
  11. // => "2018-08-26T09:12:49.695Z"
  13. // date-fns
  14. import getDay from 'date-fns/getDay';
  15. import setDay from 'date-fns/setDay';
  16. getDay(new Date());
  17. // => 0 (Sunday)
  18. setDay(new Date(), -14);
  19. // => "2018-08-26T09:12:49.695Z"
  21. // dayjs
  22. dayjs().day();
  23. // => 0 (Sunday)
  24. dayjs().set('day', -14);
  25. // => "2018-08-26T09:12:49.695Z"
  27. // Luxon
  28. DateTime.local().weekday;
  29. // => 7 (Sunday)
  30. DateTime.local()
  31.   .minus({ day: 14 })
  32.   .toJSDate();
  33. // => "2018-08-26T09:12:49.695Z"
Library Time
Moment 1869.609ms
Native 565.715ms
DateFns 815.355ms
DayJs 1087.407ms
Luxon 7093.800ms

Day of Year

Gets or sets the day of the year.

  1. // Moment.js
  2. moment().dayOfYear();
  3. // => 252
  4. moment().dayOfYear(256);
  5. // => "2018-09-13T09:12:49.695Z"
  7. // Native
  8. Math.floor(
  9.   (new Date() - new Date(new Date().getFullYear(), 0, 0)) / 1000 / 60 / 60 / 24
  10. );
  11. // => 252
  13. // date-fns
  14. import getDayOfYear from 'date-fns/getDayOfYear';
  15. import setDayOfYear from 'date-fns/setDayOfYear';
  16. getDayOfYear(new Date());
  17. // => 252
  18. setDayOfYear(new Date(), 256);
  19. // => "2018-09-13T09:12:49.695Z"
  21. // dayjs ⚠️ requires dayOfYear plugin
  22. import dayOfYear from 'dayjs/plugin/dayOfYear'
  23. dayjs.extend(dayOfYear)
  24. dayjs().dayOfYear();
  25. // => 252
  26. dayjs().dayOfYear(256);
  27. // => "2018-09-13T09:12:49.695Z"
  29. // Luxon
  30. DateTime.local().ordinal;
  31. // => 252
  32. DateTime.local()
  33.   .set({ ordinal: 256 })
  34.   .toString();
  35. // => "2018-09-13T09:12:49.695Z"
Library Time
Moment 9851.425ms
Native 575.954ms
DateFns 1976.969ms
DayJs -
Luxon 5242.336ms

Week of Year

Gets or sets the week of the year.

  1. // Moment.js
  2. moment().week();
  3. // => 37
  4. moment().week(24);
  5. // => "2018-06-10T09:12:49.695Z"
  7. // date-fns
  8. import getWeek from 'date-fns/getWeek';
  9. import setWeek from 'date-fns/setWeek';
  10. getWeek(new Date());
  11. // => 37
  12. setWeek(new Date(), 24);
  13. // => "2018-06-10T09:12:49.695Z"
  15. // native getWeek
  16. const day = new Date();
  17. const MILLISECONDS_IN_WEEK = 604800000;
  18. const firstDayOfWeek = 1; // monday as the first day (0 = sunday)
  19. const startOfYear = new Date(day.getFullYear(), 0, 1);
  20. startOfYear.setDate(
  21.   startOfYear.getDate() + (firstDayOfWeek - (startOfYear.getDay() % 7))
  22. );
  23. const dayWeek = Math.round((day - startOfYear) / MILLISECONDS_IN_WEEK) + 1;
  24. // => 37
  26. // native setWeek
  27. const day = new Date();
  28. const week = 24;
  29. const MILLISECONDS_IN_WEEK = 604800000;
  30. const firstDayOfWeek = 1; // monday as the first day (0 = sunday)
  31. const startOfYear = new Date(day.getFullYear(), 0, 1);
  32. startOfYear.setDate(
  33.   startOfYear.getDate() + (firstDayOfWeek - (startOfYear.getDay() % 7))
  34. );
  35. const dayWeek = Math.round((day - startOfYear) / MILLISECONDS_IN_WEEK) + 1;
  36. day.setDate(day.getDate() - (dayWeek - week) * 7);
  37. day.toISOString();
  38. // => "2018-06-10T09:12:49.794Z
  40. // dayjs ⚠️ requires weekOfYear plugin
  41. import weekOfYear from 'dayjs/plugin/weekOfYear';
  42. dayjs.extend(weekOfYear);
  43. dayjs().week();
  44. // => 37
  45. dayjs().week(24);
  46. // => "2018-06-10T09:12:49.695Z"
  48. // Luxon
  49. DateTime.local().weekNumber;
  50. // => 37
  51. DateTime.local()
  52.   .set({ weekNumber: 23 })
  53.   .toString();
  54. // => "2018-06-10T09:12:49.794Z
Library Time
Moment 11997.187ms
Native 1467.277ms
DateFns 6070.445ms
DayJs -
Luxon 7944.387ms

Days in Month

Get the number of days in the current month.

  1. // Moment.js
  2. moment('2012-02', 'YYYY-MM').daysInMonth();
  3. // => 29
  5. // Native
  6. new Date(2012, 02, 0).getDate();
  7. // => 29
  9. // date-fns
  10. import getDaysInMonth from 'date-fns/getDaysInMonth';
  11. getDaysInMonth(new Date(2012, 1));
  12. // => 29
  14. // dayjs
  15. dayjs('2012-02').daysInMonth();
  16. // => 29
  18. // Luxon
  19. DateTime.local(2012, 2).daysInMonth;
  20. // => 29
Library Time
Moment 4836.243ms
Native 504.241ms
DateFns 1584.524ms
DayJs 2965.774ms
Luxon 1292.006ms

Weeks in Year

Gets the number of weeks in the current year, according to ISO weeks.

  1. // Moment.js
  2. moment().isoWeeksInYear();
  3. // => 52
  5. // date-fns
  6. import getISOWeeksInYear from 'date-fns/getISOWeeksInYear';
  7. getISOWeeksInYear(new Date());
  8. // => 52
  10. // dayjs ⚠️ requires isoWeeksInYear plugin
  11. import isoWeeksInYear from 'dayjs/plugin/isoWeeksInYear'
  12. dayjs.extend(isoWeeksInYear)
  13. dayjs().isoWeeksInYear();
  14. // => 52
  16. // Moment.js
  17. DateTime.local().weeksInWeekYear;
  18. // => 52
Library Time
Moment 983.551ms
Native -
DateFns 4751.236ms
DayJs -
Luxon 1743.877ms

Maximum of the given dates

Returns the maximum (most distant future) of the given date.

  1. const array = [
  2.   new Date(2017, 4, 13),
  3.   new Date(2018, 2, 12),
  4.   new Date(2016, 0, 10),
  5.   new Date(2016, 0, 9),
  6. ];
  7. // Moment.js
  8. moment.max(array.map(a => moment(a)));
  9. // => "2018-03-11T13:00:00.000Z"
  11. // Native
  12. new Date(Math.max.apply(null, array)).toISOString();
  13. // => "2018-03-11T13:00:00.000Z"
  15. // date-fns
  16. import max from 'date-fns/max';
  17. max(array);
  18. // => "2018-03-11T13:00:00.000Z"
  20. // dayjs ⚠️ requires minMax plugin
  21. import minMax from 'dayjs/plugin/minMax'
  22. dayjs.extend(minMax)
  23. dayjs.max(array.map(a => dayjs(a)));
  24. // => "2018-03-11T13:00:00.000Z"
  26. // Luxon
  27. DateTime.max(...array.map(a => DateTime.fromJSDate(a))).toJSDate();
  28. // => "2018-03-11T13:00:00.000Z"
Library Time
Moment 1736.095ms
Native 1104.626ms
DateFns 966.238ms
DayJs -
Luxon 2703.421ms

Minimum of the given dates

Returns the minimum (most distant future) of the given date.

  1. const array = [
  2.   new Date(2017, 4, 13),
  3.   new Date(2018, 2, 12),
  4.   new Date(2016, 0, 10),
  5.   new Date(2016, 0, 9),
  6. ];
  7. // Moment.js
  8. moment.min(array.map(a => moment(a)));
  9. // => "2016-01-08T13:00:00.000Z"
  11. // Native
  12. new Date(Math.min.apply(null, array)).toISOString();
  13. // => "2016-01-08T13:00:00.000Z"
  15. // date-fns
  16. import min from 'date-fns/min';
  17. min(array);
  18. // => "2016-01-08T13:00:00.000Z"
  20. // dayjs ⚠️ requires minMax plugin
  21. import minMax from 'dayjs/plugin/minMax'
  22. dayjs.extend(minMax)
  23. dayjs.min(array.map(a => dayjs(a)));
  24. // => "2016-01-08T13:00:00.000Z"
  26. // Luxon
  27. DateTime.min(...array.map(a => DateTime.fromJSDate(a))).toJSDate();
  28. // => "2016-01-08T13:00:00.000Z"
Library Time
Moment 1937.293ms
Native 1164.853ms
DateFns 908.990ms
DayJs -
Luxon 3085.444ms