constants (常量)

有用的日期常量的集合。

可以从 date-fns/constants 导入常量：

import { maxTime, minTime } from 'date-fns/constants';

function isAllowedTime(time) {
    return time <= maxTime && time >= minTime;
}

constructFromSymbol

使日期扩展能够从参考日期继承属性的符号。

该符号用于启用 constructFrom 函数，使用参考日期和值构造日期。

它允许将额外属性从参考日期转移到新日期。

它对于像 TZDate 这样接受时区作为构造函数参数的扩展很有用。

导入

import { constructFromSymbol } from 'date-fns/constants';

daysInWeek

1 周内的天数。

导入

import { daysInWeek } from 'date-fns/constants';

结果

7

daysInYear

一年有多少天。

根据以下公式，一年等于 365.2425 天：

每 4 年为闰年，但能被 100 整除但不能被 400 整除的年份除外。

1 个平均年份 = (365+1/4-1/100+1/400) 天 = 365.2425 天

导入

import { daysInYear } from 'date-fns/constants';

结果

365.2425

maxTime

最大允许时间。

导入

import { maxTime } from 'date-fns/constants';

结果

数字

示例

import { maxTime } from 'date-fns/constants';

const isValid = 8640000000000001 <= maxTime;
//=> false

new Date(8640000000000001);
//=> Invalid Date

millisecondsInDay

1 天内的毫秒数。

导入

import { millisecondsInDay } from 'date-fns/constants';

结果

86400000

millisecondsInHour

1 小时内的毫秒数。

导入

import { millisecondsInHour } from 'date-fns/constants';

结果

3600000

millisecondsInMinute

1 分钟内的毫秒数。

导入

import { millisecondsInMinute } from 'date-fns/constants';

结果

60000

millisecondsInSecond

1 秒内的毫秒数。

导入

import { millisecondsInSecond } from 'date-fns/constants';

结果

1000

millisecondsInWeek

1 周内的毫秒数。

导入

import { millisecondsInWeek } from 'date-fns/constants';

结果

604800000

minTime

最短允许时间。

导入

import { minTime } from 'date-fns/constants';

结果

number

示例

import { minTime } from 'date-fns/constants';

const isValid = -8640000000000001 >= minTime;
//=> false

new Date(-8640000000000001);
//=> Invalid Date

minutesInDay

1天的分钟数。

导入

import { minutesInDay } from 'date-fns/constants';

结果

1440

minutesInHour

1 小时内的分钟数。

导入

import { minutesInHour } from 'date-fns/constants';

结果

60

minutesInMonth

1 个月内的分钟数。

导入

import { minutesInMonth } from 'date-fns/constants';

结果

43200

minutesInYear

一年中的分钟数。

导入

import { minutesInYear } from 'date-fns/constants';

结果

525600

monthsInQuarter

1 个季度中的月份。

导入

import { monthsInQuarter } from 'date-fns/constants';

结果

3

monthsInYear

1 年中的月份。

导入

import { monthsInYear } from 'date-fns/constants';

结果

12

quartersInYear

一年内的季度数。

导入

import { quartersInYear } from 'date-fns/constants';

结果

4

secondsInDay

1 天内的秒数。

导入

import { secondsInDay } from 'date-fns/constants';

结果

数字

secondsInHour

1 小时内的秒数。

导入

import { secondsInHour } from 'date-fns/constants';

结果

3600

secondsInMinute

1分钟内的秒数。

导入

import { secondsInMinute } from 'date-fns/constants';

结果

60

secondsInMonth

1 个月内的秒数

导入

import { secondsInMonth } from 'date-fns/constants';

结果

数字

secondsInQuarter

1 季度内的秒数。

导入

import { secondsInQuarter } from 'date-fns/constants';

结果

数字

secondsInWeek

1 周内的秒数。

导入

import { secondsInWeek } from 'date-fns/constants';

结果

数字

secondsInYear

1 年内的秒数。

导入

import { secondsInYear } from 'date-fns/constants';

结果

数字

parseJSON

导入

import { parseJSON } from 'date-fns';

定义

function parseJSON(
    dateStr: string,
    options?: ParseJSONOptions<ResultDate>
): ResultDate;

参数

名称	类型	描述
dateStr	string	要转换的完整 ISO8601 日期字符串
options?	ParseJSONOptions<ResultDate>	带有选项的对象

返回

类型	描述
ResultDate	解析的本地时区日期

subMilliseconds

导入

import { subMilliseconds } from 'date-fns';

定义

function subMilliseconds(
    date: DateArg<DateType>,
    amount: number,
    options?: SubMillisecondsOptions<ResultDate>
): ResultDate;

参数

名称	类型	描述
date	DateArg<DateType>	更改日期
amount	number	要减去的毫秒数。
options?	SubMillisecondsOptions<ResultDate>	带有选项的对象

返回

类型	描述
ResultDate	减去毫秒后的新日期

subSeconds

导入

import { subSeconds } from 'date-fns';

定义

function subSeconds(
    date: DateArg<DateType>,
    amount: number,
    options?: SubSecondsOptions<ResultDate>
): ResultDate;

参数

名称	类型	描述
date	DateArg<DateType>	更改日期
amount	number	要减去的毫秒数。
options?	SubMillisecondsOptions<ResultDate>	带有选项的对象

返回

类型	描述
ResultDate	减去毫秒后的新日期

示例

从 2014年7月10日12:45:00 减去 30秒：

const result = subSeconds(new Date(2014, 6, 10, 12, 45, 0), 30);
//=> Thu Jul 10 2014 12:44:30