# holidays-jp

> get Japanese public holidays

Latest version **2.0.62** (published 2026-07-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install holidays-jp
pnpm add holidays-jp
yarn add holidays-jp
bun add holidays-jp
```

Provides the commands `holiday`, `holidays-jp`.

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.0.62 |
| Published | 2026-07-24 |
| First published | 2019-08-18 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=8.3 |
| Dependencies | 1 |
| Unpacked size | 18 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 0 |
| Author | sasa+1 |
| Maintainers | sasaplus1 |

## Links

- npm: https://www.npmjs.com/package/holidays-jp
- Repository: https://github.com/sasaplus1/holidays-jp.js
- Homepage: https://github.com/sasaplus1/holidays-jp.js#readme
- Issues: https://github.com/sasaplus1/holidays-jp.js/issues
- npm.io page: https://npm.io/package/holidays-jp

## Dependencies (1)

- [japanese-public-holidays](https://npm.io/package/japanese-public-holidays.md) ^3.0.6

## Recent versions

- 2.0.62 (latest) — 2026-07-24
- 2.0.61 — 2026-05-08
- 2.0.60 — 2026-05-06
- 2.0.59 — 2026-05-05
- 2.0.58 — 2026-05-01
- 2.0.57 — 2026-03-22
- 2.0.56 — 2026-02-27
- 2.0.55 — 2026-02-25
- 2.0.54 — 2026-02-23
- 2.0.53 — 2026-02-16
- 2.0.52 — 2026-02-13
- 2.0.51 — 2026-02-04
- 2.0.50 — 2026-01-14
- 2.0.48 — 2025-12-04
- 2.0.47 — 2025-11-26
- … 54 more at https://npm.io/package/holidays-jp/versions

## README

# holidays-jp.js

[![test](https://github.com/sasaplus1/holidays-jp.js/workflows/test/badge.svg)](https://github.com/sasaplus1/holidays-jp.js/actions?query=workflow%3Atest)
[![npm version](https://badge.fury.io/js/holidays-jp.svg)](https://badge.fury.io/js/holidays-jp)
[![Try holidays-jp on RunKit](https://badge.runkitcdn.com/holidays-jp.svg)](https://npm.runkit.com/holidays-jp)

get Japanese public holidays

## Installation

### npm

```console
$ npm install holidays-jp
```

### yarn

```console
$ yarn add holidays-jp
```

## Usage

```js
const holidays = require('holidays-jp');
```

### Example

```js
const date = new Date(2019, 1 - 1, 1, 0, 0, 0, 0);

holidays.isHoliday(date); // => true
```

```js
const date = new Date(2019, 1 - 1, 1, 0, 0, 0, 0);

holidays.getHolidayInfo(date); // => { date: '2019-01-01', name: '元日', ... }
```

### CLI

holidays-jp.js has CLI command:

```console
$ npx holidays-jp '2019-01-01T00:00:00+09:00'
$ echo $?
0
```

```console
$ npx holidays-jp '2019-01-02T00:00:00+09:00'
$ echo $?
1
```

use current time if don't pass argument:

```console
$ date +%FT%T
2019-08-25T03:09:59
$ npx holidays-jp
$ echo $?
1
```

### Related

- [sasaplus1/japanese-public-holidays](https://github.com/sasaplus1/japanese-public-holidays)

## License

The MIT license.

---
_Source: https://npm.io/package/holidays-jp · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._