Blame view

天文台pc/tianwentai-ui/node_modules/date-fns/differenceInCalendarWeeks.mjs 2 KB
bc518174   王天杨   提交两个项目文件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
  import { millisecondsInWeek } from "./constants.mjs";
  import { startOfWeek } from "./startOfWeek.mjs";
  import { getTimezoneOffsetInMilliseconds } from "./_lib/getTimezoneOffsetInMilliseconds.mjs";
  
  /**
   * The {@link differenceInCalendarWeeks} function options.
   */
  
  /**
   * @name differenceInCalendarWeeks
   * @category Week Helpers
   * @summary Get the number of calendar weeks between the given dates.
   *
   * @description
   * Get the number of calendar weeks between the given dates.
   *
   * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
   *
   * @param dateLeft - The later date
   * @param dateRight - The earlier date
   * @param options - An object with options.
   *
   * @returns The number of calendar weeks
   *
   * @example
   * // How many calendar weeks are between 5 July 2014 and 20 July 2014?
   * const result = differenceInCalendarWeeks(
   *   new Date(2014, 6, 20),
   *   new Date(2014, 6, 5)
   * )
   * //=> 3
   *
   * @example
   * // If the week starts on Monday,
   * // how many calendar weeks are between 5 July 2014 and 20 July 2014?
   * const result = differenceInCalendarWeeks(
   *   new Date(2014, 6, 20),
   *   new Date(2014, 6, 5),
   *   { weekStartsOn: 1 }
   * )
   * //=> 2
   */
  export function differenceInCalendarWeeks(dateLeft, dateRight, options) {
    const startOfWeekLeft = startOfWeek(dateLeft, options);
    const startOfWeekRight = startOfWeek(dateRight, options);
  
    const timestampLeft =
      +startOfWeekLeft - getTimezoneOffsetInMilliseconds(startOfWeekLeft);
    const timestampRight =
      +startOfWeekRight - getTimezoneOffsetInMilliseconds(startOfWeekRight);
  
    // Round the number of days to the nearest integer because the number of
    // milliseconds in a days is not constant (e.g. it's different in the week of
    // the daylight saving time clock shift).
    return Math.round((timestampLeft - timestampRight) / millisecondsInWeek);
  }
  
  // Fallback for modularized imports:
  export default differenceInCalendarWeeks;