基础方法
isToday():判断所传入日期是否为今天
isYesterday(): 判断是否为昨天
isTomorrow()判断是否为明天. 用法与isToday(), isYesterday()用法相同,就不加以累述了.
format(): 格式化日期函数
addDays():获得第n天之后的日期;
addHours(): 获得当前小时之后的小时(比如现在5点, 得到七点的时间).
addMinutes():获得当前分钟之后n分钟的时间
addMonths(): 获得当前月之后n个月的月份
subDays():获得当前日期之前n天的日期
subHours(): 获得当前时间之前n小时的时间
subMinutes(): 获得当前时间之前n分钟的时间
subMonths():获得当前月份之前n个月的时间
differenceInDays(): 获得两个时间相差几天,
differenceInHours();获得两个时间相差的小时.
differenceInMinutes(): 获得两个时间相差的分钟
differenceInMonths():获得两个时间相差月份
differenceInWeeks(): 获得两个时间相差的周数
differenceInYears():获得两个时间相差的年数
startOfDay():返回传入日期一天开始的Date对象(一天开始的时间)
endOfDay(): 获得传入日期一天的结束时间(与startOfDay对应)
startOfMonth():获取月份的第一天
endOfMonth(): 获得月份的最后一天
getDate(): 获取传入的日期是几号;
getDay(): 获取传入的日期是星期几
getMonth(): 返回传入时间的月份
getMinutes(): 返回传入时间的分钟数
getHours():返回传入时间的小时数
getISOWeek(): 返回传入时间所在月份的第几周.
isEqual(): 判断传入的时间是否相等
max(): 取得时间数组中的最大值
min(): 取得时间数组中的最小值
1.isToday()
:判断是否为今天
import { isToday, format } from 'date-fns';
const day = new Date();
console.log(isToday(day)); // 结果为: true
2.isYesterday()
:判断是否为昨天
import { isYesterday, format } from 'date-fns';
const date = new Date();
console.log(isYesterday(date)); //结果false
console.log(isYesterday("2019-01-02T06:35:00.000Z")); //结果为true
3.isTomorrow()
判断是否为明天. 用法与isToday()
, isYesterday()
用法相同.
4.format()
: 格式化日期函数
function format (
date: Date | string | number,
format?: string,
options?: {
locale?: Object
}
): string
namespace format {}
该函数传入三个参数, 第一个参数为必传参数,可以为date, string, number
, 第二个format
为日期格式,为可选参数.第三个暂时没用到是可选参数
const date = new Date();
console.log(format(date, 'HH:mm')); // 17:05
console.log(format(date, 'YYYY-MM-DD HH:mm:ss')); //2019-01-03 17:26:33
console.log(format(date, 'YYYY-MM-DD')); //2019-01-03
// 不传第二个参数的时候.
console.log(format(date));//2019-01-03T17:27:27.102+08:00
addDays()
:获得第n天之后的日期;function addDays (
date: Date | string | number,
amount: number
): Date
该函数需要传入两个参数,第一个为date
对象, 第二个为一个number类型的数字.传入1返回明天的日期,2则是后天的日期,以此类推. 返回的是一个日期对象
let date = new Date(); //2019-01-03
console.log(format( addDays(date, 1), 'YYYY-MM-DD HH:mm:ss')); // 2019-01-04 17:46:30
//在这里为了阅读方便,我在该函数外面套用了format.
console.log(format( addDays(date, 2), 'YYYY-MM-DD')); //2019-01-05
6.addHours()
: 获得当前小时之后的小时(比如现在5点, 得到七点的时间).
7.addMinutes()
:获得当前分钟之后n分钟的时间
8.addMonths()
: 获得当前月之后n个月的月份
9.subDays()
:获得当前日期之前n天的日期
function subDays (
date: Date | string | number,
amount: number
): Date
该函数传入两个参数,第一个参数date
可以为Date, string,number
, 第一个参数为number
类型,例如(1,2). 返回一个Date
对象
const date = new Date();
console.log(format(date, 'YYYY-MM-DD HH:mm:ss'));//2019-01-04 11:03:33
console.log(format( subDays(date, 2), 'YYYY-MM-DD HH:mm:ss')); //2019-01-02 11:03:33
10: subHours()
: 获得当前时间之前n小时的时间
11: subMinutes()
: 获得当前时间之前n分钟的时间
12: subMonths()
:获得当前月份之前n个月的时间
13: differenceInDays()
: 获得两个时间相差几天
function differenceInDays (
dateLeft: Date | string | number,
dateRight: Date | string | number
): number
传入两个参数, dateLeft
为时间比较靠前的时间, dateRight
为时间比较靠后的时间. 返回一个number
类型的数字
const time = '2017-01-29 11:03:33';
const date = new Date();
console.log(format(date, 'YYYY-MM-DD HH:mm:ss'));
console.log(differenceInCalendarDays(date, time));
console.log(differenceInDays(date, time)); //705
14:differenceInHours();获得两个时间相差的小时.
15: differenceInMinutes(): 获得两个时间相差的分钟
16: differenceInMonths():获得两个时间相差月份
17: differenceInWeeks(): 获得两个时间相差的周数
18: differenceInYears():获得两个时间相差的年数
19:startOfDay()
:返回传入日期一天开始的Date
对象(一天开始的时间)
function startOfDay (
date: Date | string | number
): Date
传入一个参数,可以是Date
类型,string, number
类型. 返回一个Date
对象.
const today = new Date();
const startDate = startOfDay(today); /Mon Jan 14 2019 00:00:00 GMT+0800 (中国标准时间)
20: endOfDay()
: 获得传入日期一天的结束时间(与startOfDay
对应)
function endOfDay (
date: Date | string | number
): Date
传入一个参数,可以是Date
类型,string, number
类型. 返回一个Date
对象.
const today = new Date();
const endDate = endOfDay(today);
console.log('endDate', endDate);// Mon Jan 14 2019 23:59:59 GMT+0800 (中国标准时间)
21: startOfMonth()
:获取月份的第一天
function startOfMonth (
date: Date | string | number
): Date
传入一个参数,可以是Date
类型,string, number
类型. 返回一个Date
对象.
const today = new Date();
const startMonth = startOfMonth(today); //Tue Jan 01 2019 00:00:00 GMT+0800 (中国标准时间)
const aa = format(startMonth, 'YYYY-MM-DD HH:mm:ss'); // 2019-01-01 00:00:00
22: endOfMonth()
: 获得月份的最后一天
function endOfMonth (
date: Date | string | number
): Date
传入一个参数,可以是Date
类型,string, number
类型. 返回一个Date
对象.
const today = new Date();
const endMonth = endOfMonth(today); //Thu Jan 31 2019 23:59:59 GMT+0800 (中国标准时间)
const aa = format(endMonth, 'YYYY-MM-DD HH:mm:ss'); // 2019-01-31 23:59:59
console.log('endMonth', endMonth);
23: getDate()
: 获取传入的日期是几号;
function getDate (
date: Date | string | number
): number
传入一个参数,可以是Date
类型,string, number
类型. 返回一个number
类型的数据
console.log(getDate('2019-01-15 00:00:00')); // 15
24: getDay():
获取传入的日期是星期几
function getDay (
date: Date | string | number
): number
传入一个参数,可以是Date
类型,string, number
类型. 返回一个number
类型的数据
console.log(getDay('2019-01-15 00:00:00')); // 2
25: getMonth()
: 返回传入时间的月份
function getMonth (
date: Date | string | number
): number
传入一个参数,可以是Date
类型,string, number
类型. 返回一个number
类型的数据
const day = new Date();
console.log(getMonth(day)); // 0