date-fns 周助手函数

getISOWeek

描述

获取ISO标准的周数。

参数说明

接收一个Date对象或者一个表示日期的字符串。

• date：一个Date对象或者一个表示日期的字符串，表示要获取ISO标准的周数的日期。

返回值说明

返回一个数字，表示ISO标准的周数。

• isoWeekNumber：一个数字，表示指定日期的ISO标准的周数。

案例

import { getISOWeek } from 'date-fns'

const date = new Date('2021-08-01')
const isoWeek = getISOWeek(date) // 30

getISOWeeksInYear

描述

获取指定年份有多少周。

参数说明

接收一个表示年份的数字或者一个Date对象。

• dateOrYear：一个表示年份的数字或者一个Date对象，表示要获取周数的年份。

返回值说明

返回一个数字，表示指定年份有多少周。

• weeksInYear：一个数字，表示指定年份的周数。

案例

import { getISOWeeksInYear } from 'date-fns'

const weeksInYear = getISOWeeksInYear(2021) // 52

getWeek

描述

获取一年中的周数。

参数说明

接收一个Date对象或者一个表示日期的字符串。

• date：一个Date对象或者一个表示日期的字符串，表示要获取周数的日期。

返回值说明

返回一个数字，表示一年中的周数。

• weekNumber：一个数字，表示指定日期的周数。

案例

import { getWeek } from 'date-fns'

const date = new Date('2021-08-01')
const week = getWeek(date) // 31

getWeeksInYear

描述

获取指定年份有多少周。

参数说明

接收一个表示年份的数字或者一个Date对象。

• dateOrYear：一个表示年份的数字或者一个Date对象，表示要获取周数的年份。

返回值说明

返回一个数字，表示指定年份有多少周。

• weeksInYear：一个数字，表示指定年份的周数。

案例

import { getWeeksInYear } from 'date-fns'

const weeksInYear = getWeeksInYear(2021) // 52

isSameISOWeek

描述

判断两个日期是否在同一周（使用ISO标准）。

参数说明

接收两个Date对象或者两个表示日期的字符串。

• dateLeft：一个Date对象或者一个表示日期的字符串，表示要比较的第一个日期。
• dateRight：一个Date对象或者一个表示日期的字符串，表示要比较的第二个日期。

返回值说明

返回一个布尔值，表示两个日期是否在同一周。

• isSameWeek：一个布尔值，表示两个日期是否在同一周。

案例

import { isSameISOWeek } from 'date-fns'

const date1 = new Date('2021-08-01')
const date2 = new Date('2021-08-02')
const sameWeek = isSameISOWeek(date1, date2) // true

isSameWeek

描述

判断两个日期是否在同一周。

参数说明

接收两个Date对象或者两个表示日期的字符串。

• dateLeft：一个Date对象或者一个表示日期的字符串，表示要比较的第一个日期。
• dateRight：一个Date对象或者一个表示日期的字符串，表示要比较的第二个日期。

返回值说明

返回一个布尔值，表示两个日期是否在同一周。

• isSameWeek：一个布尔值，表示两个日期是否在同一周。

案例

import { isSameWeek } from 'date-fns'

const date1 = new Date('2021-08-01')
const date2 = new Date('2021-08-02')
const sameWeek = isSameWeek(date1, date2) // true

setISOWeek

描述

设置日期的ISO标准的周数。

参数说明

接收一个Date对象或者一个表示日期的字符串，以及一个数字，表示要设置的ISO标准的周数。

• date：一个Date对象或者一个表示日期的字符串，表示要设置周数的日期。
• isoWeekNumber：一个数字，表示要设置的ISO标准的周数。

返回值说明

返回一个新的日期对象，表示设置后的日期。

• newDate：一个新的Date对象，表示设置后的日期。

案例

import { setISOWeek } from 'date-fns'

const date = new Date('2021-08-01')
const newDate = setISOWeek(date, 31) // 2021-08-02T00:00:00.000Z

setWeek

描述

设置日期的周数。

参数说明

接收一个Date对象或者一个表示日期的字符串，以及一个数字，表示要设置的周数。

• date：一个Date对象或者一个表示日期的字符串，表示要设置周数的日期。
• weekNumber：一个数字，表示要设置的周数。

返回值说明

返回一个新的日期对象，表示设置后的日期。

• newDate：一个新的Date对象，表示设置后的日期。

案例

import {setWeek} from 'date-fns'

const date = new Date('2021-08-01')
const newDate = setWeek(date, 31) // 2021-08-02T00:00:00.000Z