getWeekYear.cjs 2.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687
  1. "use strict";
  2. exports.getWeekYear = getWeekYear;
  3. var _index = require("./_lib/defaultOptions.cjs");
  4. var _index2 = require("./constructFrom.cjs");
  5. var _index3 = require("./startOfWeek.cjs");
  6. var _index4 = require("./toDate.cjs");
  7. /**
  8. * The {@link getWeekYear} function options.
  9. */
  10. /**
  11. * @name getWeekYear
  12. * @category Week-Numbering Year Helpers
  13. * @summary Get the local week-numbering year of the given date.
  14. *
  15. * @description
  16. * Get the local week-numbering year of the given date.
  17. * The exact calculation depends on the values of
  18. * `options.weekStartsOn` (which is the index of the first day of the week)
  19. * and `options.firstWeekContainsDate` (which is the day of January, which is always in
  20. * the first week of the week-numbering year)
  21. *
  22. * Week numbering: https://en.wikipedia.org/wiki/Week#The_ISO_week_date_system
  23. *
  24. * @param date - The given date
  25. * @param options - An object with options.
  26. *
  27. * @returns The local week-numbering year
  28. *
  29. * @example
  30. * // Which week numbering year is 26 December 2004 with the default settings?
  31. * const result = getWeekYear(new Date(2004, 11, 26))
  32. * //=> 2005
  33. *
  34. * @example
  35. * // Which week numbering year is 26 December 2004 if week starts on Saturday?
  36. * const result = getWeekYear(new Date(2004, 11, 26), { weekStartsOn: 6 })
  37. * //=> 2004
  38. *
  39. * @example
  40. * // Which week numbering year is 26 December 2004 if the first week contains 4 January?
  41. * const result = getWeekYear(new Date(2004, 11, 26), { firstWeekContainsDate: 4 })
  42. * //=> 2004
  43. */
  44. function getWeekYear(date, options) {
  45. const _date = (0, _index4.toDate)(date, options?.in);
  46. const year = _date.getFullYear();
  47. const defaultOptions = (0, _index.getDefaultOptions)();
  48. const firstWeekContainsDate =
  49. options?.firstWeekContainsDate ??
  50. options?.locale?.options?.firstWeekContainsDate ??
  51. defaultOptions.firstWeekContainsDate ??
  52. defaultOptions.locale?.options?.firstWeekContainsDate ??
  53. 1;
  54. const firstWeekOfNextYear = (0, _index2.constructFrom)(
  55. options?.in || date,
  56. 0,
  57. );
  58. firstWeekOfNextYear.setFullYear(year + 1, 0, firstWeekContainsDate);
  59. firstWeekOfNextYear.setHours(0, 0, 0, 0);
  60. const startOfNextYear = (0, _index3.startOfWeek)(
  61. firstWeekOfNextYear,
  62. options,
  63. );
  64. const firstWeekOfThisYear = (0, _index2.constructFrom)(
  65. options?.in || date,
  66. 0,
  67. );
  68. firstWeekOfThisYear.setFullYear(year, 0, firstWeekContainsDate);
  69. firstWeekOfThisYear.setHours(0, 0, 0, 0);
  70. const startOfThisYear = (0, _index3.startOfWeek)(
  71. firstWeekOfThisYear,
  72. options,
  73. );
  74. if (+_date >= +startOfNextYear) {
  75. return year + 1;
  76. } else if (+_date >= +startOfThisYear) {
  77. return year;
  78. } else {
  79. return year - 1;
  80. }
  81. }