# @holiday-jp/holiday_jp

> Japanese holidays

Latest version **2.5.2** (published 2026-09-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install @holiday-jp/holiday_jp
pnpm add @holiday-jp/holiday_jp
yarn add @holiday-jp/holiday_jp
bun add @holiday-jp/holiday_jp
```

## Health

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

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

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 2.5.2 |
| Published | 2026-09-24 |
| First published | 2018-02-19 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 1.4 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 156 |
| Author | Ken'ichiro Oyama |
| Maintainers | komagata, k1low |
| Keywords | holidays |

## Links

- npm: https://www.npmjs.com/package/@holiday-jp/holiday_jp
- Repository: https://github.com/holiday-jp/holiday_jp-js
- Issues: https://github.com/holiday-jp/holiday_jp-js/issues
- npm.io page: https://npm.io/package/@holiday-jp/holiday_jp

## Alternatives

- [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads
- [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads
- [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads
- [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads
- [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads

## Recent versions

- 2.5.2 (latest) — 2026-09-24
- 2.5.1 — 2025-05-27
- 2.5.0 — 2025-05-27
- 2.4.0 — 2022-08-01
- 2.3.0 — 2020-12-06
- 2.2.3 — 2019-10-26
- 2.2.2 — 2019-05-25
- 2.2.1 — 2019-02-17
- 2.2.0 — 2018-12-23
- 2.1.0 — 2018-06-30
- 1.4.2 — 2018-02-26
- 2.0.1 — 2018-02-20
- 1.4.1 — 2018-02-19
- 2.0.0 — 2018-02-19
- 1.4.0 — 2018-02-19

## README

# holiday_jp JavaScript/TypeScript [![test](https://github.com/holiday-jp/holiday_jp-js/workflows/test/badge.svg)](https://github.com/holiday-jp/holiday_jp-js/actions)

Get holidays in Japan.

## Install

```sh
$ npm install @holiday-jp/holiday_jp
```

## Usage

In HTML

```html
<script src="./your/own/path/holiday_jp.js"></script>
<script>
var holidays = holiday_jp.between(new Date('2010-09-14'), new Date('2010-09-21'));
console.log(holidays[0]['name']); // 敬老の日
</script>
```

In Node

```javascript
var holiday_jp = require('@holiday-jp/holiday_jp');
var holidays = holiday_jp.between(new Date('2010-09-14'), new Date('2010-09-21'));
console.log(holidays[0]['name']); // 敬老の日
```

If you want to use specific years only

```javascript
var holiday_jp = require('@holiday-jp/holiday_jp/lib/no_autoload_holidays');
var holidays_2010 = require('@holiday-jp/holiday_jp/lib/holidays_every_year/2010');
var holidays_2011 = require('@holiday-jp/holiday_jp/lib/holidays_every_year/2011');
holiday_jp.setHolidays([holidays_2010, holidays_2011]);

var holidays = holiday_jp.between(new Date('2010-09-14'), new Date('2010-09-21'));
console.log(holidays[0]['name']); // 敬老の日
```

In TypeScript

```typescript
import * as holiday_jp from '@holiday-jp/holiday_jp';
const holidays = holiday_jp.between(new Date('2010-09-14'), new Date('2010-09-21'));
console.log(holidays[0]['name']); // 敬老の日
```

If you want to use specific years only in TypeScript

```typescript
import holiday_jp from '@holiday-jp/holiday_jp/lib/no_autoload_holidays';
import holidays_2010 from '@holiday-jp/holiday_jp/lib/holidays_every_year/2010';
import holidays_2011 from '@holiday-jp/holiday_jp/lib/holidays_every_year/2011';
holiday_jp.setHolidays([holidays_2010, holidays_2011]);

const holidays = holiday_jp.between(new Date('2010-09-14'), new Date('2010-09-21'));
console.log(holidays[0]['name']); // 敬老の日
```

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