是一個(gè)處理時(shí)間的工具庫，之前我們用的最多的是moment盗扒。date-fns工具庫體積小跪楞，但是常規(guī)處理基本都囊括了。
下載安裝
npm install --save date-fns
引入：按需引入
import {xxx} from date-fns
import { zhCN } from "date-fns/locale"; // 設(shè)置locale
下面是現(xiàn)目前項(xiàng)目中用到的幾個(gè)方法：
1.formatRFC3339()：轉(zhuǎn)RFC3339格式
參數(shù):
formatRFC3339(date: number | Date, options?: {
fractionDigits?: 0 | 3 | 1 | 2 | undefined;
} | undefined): string // 第二個(gè)參數(shù)是精度
eg:
console.log(formatRFC3339(new Date())); // 2021-08-10T11:21:53+08:00
console.log(formatRFC3339(new Date(), { fractionDigits: 3 })); // 2021-08-10T11:27:30.543+08:00
2.format()：格式化日期
參數(shù):
format(date: number | Date, format: string, options?: {
locale?: Locale | undefined; // locale為中國時(shí)間
weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6 | undefined;
firstWeekContainsDate?: number | undefined;
useAdditionalWeekYearTokens?: boolean | undefined;
useAdditionalDayOfYearTokens?: boolean | undefined;
} | undefined): string
eg:
console.log(format(new Date(), "yyyy-MM-dd HH:mm:ss", { locale: zhCN })); // 2021-08-10 11:42:31
console.log(format(new Date(), "yyyy-MM-dd HH:mm:ss")); // 2021-08-10 11:38:44
console.log(format(new Date(), "yyyy-MM-dd")); // 2021-08-10
console.log(format(new Date(), "HH:mm:ss")); // 11:38:44
3.addDays()：計(jì)算某天加減多少天數(shù)是哪一天
參數(shù):
addDays(date: number | Date, amount: number): Date
eg:
console.log(addDays(new Date(), 1)); // Wed Aug 11 2021 11:47:07 GMT+0800 (中國標(biāo)準(zhǔn)時(shí)間)
console.log(addDays(new Date(), -1)); // Mon Aug 09 2021 11:47:07 GMT+0800 (中國標(biāo)準(zhǔn)時(shí)間)
console.log(addDays(new Date(), -29)); // Mon Jul 12 2021 11:47:07 GMT+0800 (中國標(biāo)準(zhǔn)時(shí)間)
同樣用法的還有：
addMonths()：幾個(gè)月后的日期侣灶，
addHours()：幾個(gè)小時(shí)后的日期甸祭，
addMinutes()：幾分鐘后的日期
addWeeks():幾個(gè)周后的日期
4.getDate(): 獲取傳入日期的天
參數(shù):
getDate(date: number | Date): number
eg:
console.log(new Date()); // Tue Aug 10 2021 13:56:16 GMT+0800 (中國標(biāo)準(zhǔn)時(shí)間)
console.log(getDate(new Date())); // 10
console.log(getDate(addDays(new Date(), -2))); // 8
同樣用法的還有：
getYear()：獲取傳入時(shí)間的年份，
getMonth()：獲取傳入時(shí)間的月份褥影，
getDay()：獲取傳入時(shí)間是星期幾
5.isAfter():判斷日期1是否在日期2之后
參數(shù):
isAfter(date: number | Date, dateToCompare: number | Date): boolean
eg:
console.log(isAfter(new Date(), new Date("2020-12-11"))); // true
console.log(isAfter(addDays(new Date(), -2), new Date())); // false
同樣用法的還有：
isBefore()：判斷日期1是否在日期2之前
6.isSameDay()：判斷兩個(gè)日期是否是同一天（同年同月同日）
參數(shù)：
isSameDay(dateLeft: number | Date, dateRight: number | Date): boolea
eg:
console.log(isSameDay(new Date(), new Date("2021-8-10"))); // true
同樣用法的還有：
isSameMonth():判斷兩個(gè)日期是否在同一月（同年同月）
isSameHour():判斷兩個(gè)時(shí)間是否是同一個(gè)小時(shí)（同一天的小時(shí)判斷）
7.startOfMonth()：獲取傳入日期所在月份的第一天的時(shí)間
參數(shù):
startOfMonth(date: number | Date): Date
eg:
console.log(startOfMonth(new Date("2020-12-11"))); // Tue Dec 01 2020 00:00:00 GMT+0800 (中國標(biāo)準(zhǔn)時(shí)間)
同樣用法的還有：
startOfYear()：獲取傳入日期所在年份的第一天的時(shí)間
startOfDay()：獲取傳入日期的零點(diǎn)日期
startOfWeek():獲取傳入日期所在星期的第一天的零點(diǎn)時(shí)間
startOfWeek(date: Date | number, options?: {
locale?: globalThis.Locale | undefined;
weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6 | undefined;
} | undefined): Date // 因?yàn)橹袊瞧诘钠鹗紩r(shí)間和國際的星期開始時(shí)間有差異池户，所以需要設(shè)置了可選項(xiàng)
8.isToday()：判斷傳入日期是否是當(dāng)天
參數(shù):
isToday(date: Date | number): boolean
eg:
console.log(isToday(new Date()); // true
同樣用法的還有：
isYesterday()：判斷傳入日期是否是昨天
isTomorrow()：判斷傳入日期是否是明天
9.subDays(): 獲取傳入日期n天以前的日期
參數(shù):
subDays(date: number | Date, amount: number): Date
eg:
console.log(subDays(new Date("2020-12-11"), 20)); // Sat Nov 21 2020 08:00:00 GMT+0800 (中國標(biāo)準(zhǔn)時(shí)間)
同樣用法的還有：
subMonths()：獲取傳入日期之前n個(gè)月的時(shí)間
subHours()： 獲取傳入時(shí)間之前n小時(shí)的時(shí)間
subMinutes()： 獲取傳入時(shí)間之前n分鐘的時(shí)間
10.differenceInDays()：計(jì)算兩個(gè)時(shí)間之間相差的天數(shù)
參數(shù):
differenceInDays(dateLeft: number | Date, dateRight: number | Date): number
eg:
console.log(differenceInDays(new Date("2021-10-20"), new Date("2021-10-1"))); // 19
同樣用法的還有：
differenceInMonths()：計(jì)算兩個(gè)時(shí)間之間相差的月份
differenceInYears()：計(jì)算兩個(gè)時(shí)間之間相差的年數(shù)
differenceInHours()：計(jì)算兩個(gè)時(shí)間之間相差的小時(shí)
differenceInWeeks()：計(jì)算兩個(gè)時(shí)間之間相差的周數(shù)
11.parseISO()：將字符串形式的日期轉(zhuǎn)換成Date格式的日期
參數(shù):
parseISO(argument: string, options?: {
additionalDigits?: 0 | 1 | 2 | undefined;
} | undefined): Date
eg:
console.log(parseISO("2021-12-19")); // Sun Dec 19 2021 00:00:00 GMT+0800 (中國標(biāo)準(zhǔn)時(shí)間)
當(dāng)然如果是RFC3339格式的字符串日期也可以轉(zhuǎn)。
持續(xù)更新中凡怎。校焦。。统倒。寨典。
