@date/holidays-us

中文文档
0.4.0发布于 2018/07/21MITCommonJS近 30 天下载 1.2万

美国银行和(部分)公共假日

中文使用文档
文档目录7 节
  1. 安装
  2. 使用量
  3. 只有银行假日
  4. 只有公共假日
  5. API: 发电机
  6. API:观察假日
  7. MIT 许可证

@ 日期/ holidays- us

Build Status npm version Coverage Status

A 类 @date/holidays 例如美国公共假日和银行假日.

也有计算特定节假日日期的职能.

安装

npm install @date/holidays-us --save

使用量

// get Holidays instance with both public and bank holidays
var holidays = require('@date/holidays-us')

var date = new Date(2016, 0, 1) // New Year's Day 2016
holidays.isHoliday(date) // true

date.setDate(10) // January 10th 2016
holidays.isHoliday(date) // false

date = holidays.thanksgiving(2015) // November 26th, 2015
date = holidays.thanksgiving(2016) // November 24th, 2016

date = holidays.valentinesDay(2016) // February 14th, 2016
holidays.isHoliday(date) // true, it's a holiday

// this will return false because Valentine's Day isn't a bank holiday
holidays.isHoliday(date, {
  // only consider it a holiday when the properties in this object match
  bank:true // must be a bank holiday
})

只有银行假日

// this has only the bank holidays, not the 'public' ones
var holidays = require('@date/holidays-us').bank()

// returns false, Valentine's isn't a bank holiday
holidays.isHoliday(new Date(2016, 1, 14))

// returns true, New Year's is a bank holiday
holidays.isHoliday(new Date(2016, 0, 1))

只有公共假日

// this has only the non-bank holidays
var holidays = require('@date/holidays-us').public()

// returns true, Valentine's is a public holiday
holidays.isHoliday(new Date(2016, 1, 14))

// returns false, because New Year's is a bank holiday
holidays.isHoliday(new Date(2016, 0, 1))

// NOTE: technically, I suppose the bank holidays are also
// public holidays, but, if you want both, use the default
// instance which has both

API: 发电机

根据特定年份产生特定假日的职能:

  1. new Years Day() - 也可以计算所观察到的假日
  2. 情人节( )
  3. 马丁·卢瑟金日( )
  4. 主席日( )
  5. 东( )
  6. 母亲日( )
  7. 纪念日( )
  8. 父亲日( )
  9. 独立日( ) - 也可以计算所观察的节日
  10. 劳动日( )
  11. 连发日( )
  12. 圣灵 ()
  13. 退伍军人日( ) - 也可以计算所观察的假日
  14. 感恩节 ()
  15. 圣诞节( ) - 也可以计算所观察到的假日

API:观察假日

有些节日与节日不同时被"观察". 生成函数也可以计算出来.

var holidays = require('@date/holidays-us')

// Christmas in 2016 is on a Sunday so it is "observed" the next day, Monday.
// the call to the generator returns the date instance as expected
var christmasDay = holidays.christmas(2016) // same as new Date(2016, 11, 25)
// it also has an `observed` property containing the "observed" holiday date
// Note: if there is no "observed" holiday then `observed` is undefined
var observedChristmas = date.observed

// christmas         == new Date(2016, 11, 25) Sunday, December 25th 2016
// observedChristmas == new Date(2016, 11, 26) Monday, December 26th 2016

MIT 许可证

版本与发布记录

@date/holidays-us 共发布 4 个版本,首次发布于 2016/07/01;过去 12 个月发布了 0 个版本。

版本发布日期距今
0.4.0latest2018/07/218 年前
0.3.02016/07/2310 年前
0.2.02016/07/0110 年前
0.1.02016/07/0110 年前

关于 @date/holidays-us 的常见问题

@date/holidays-us 是什么?

美国银行和(部分)公共假日

如何安装 @date/holidays-us?

在项目目录运行 npm install @date/holidays-us,或使用 pnpm add / yarn add / bun add。

@date/holidays-us 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/date__holidays-us 是否存在。

@date/holidays-us 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@date/holidays-us 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=6。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@date/holidays-us 可以商用吗?

@date/holidays-us 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@date/holidays-us 的下载量有多少?

根据 npm 官方下载统计,@date/holidays-us 在 2026/10/12 – 2026/11/10 这 30 天内被下载 12,089 次,日均约 403 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@date/holidays-us 还在维护吗?

最新版本 0.4.0 发布于 2018/07/21(8 年前);至今共发布 4 个版本,其中过去 12 个月发布了 0 个;首次发布于 2016/07/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。