Dependency-free tiny date utilities

Japanese date labels,
made tiny.

日本語の日付表示、相対日付、土日判定、次の営業日計算を提供する小さな TypeScript ライブラリです。

Try demo Install 
import {
  formatJaDate,
  formatRelativeJaDate,
  nextBusinessDay,
} from "tiny-ja-date"

formatJaDate(new Date(2026, 4, 12))
// "2026年5月12日（火）"

formatRelativeJaDate(
  new Date(2026, 4, 15),
  new Date(2026, 4, 12),
)
// "3日後"

Small scope

日本語UIでよく使う日付ユーティリティだけに絞っています。

Weekend only

v0.1の営業日計算は土日のみ除外。祝日データは持ちません。

TypeScript ready

依存ゼロ。フロントエンドでもバックエンドでも使えます。

Live demo

日付と基準日を変更すると、各関数の結果がリアルタイムで変わります。

このデモはサイト内の簡易実装で動いています。実際の利用では npm/CDN から読み込んでください。

Results

Install

npm からインストールして使えます。

npm install tiny-ja-date

API

v0.1 は4つの関数だけです。

formatJaDate

日本語の日付ラベルを返します。

2026年5月12日（火）

formatRelativeJaDate

基準日から見た相対日付を日本語で返します。

今日 / 昨日 / 明日 / 3日前

isWeekendJP

土曜日または日曜日か判定します。

true / false

nextBusinessDay

次の営業日を返します。v0.1では祝日は考慮しません。

Date

CDN

npm公開後は unpkg や jsDelivr から ESM として読み込めます。

https://unpkg.com/tiny-ja-date@0.1.0/dist/index.js 
<script type="module">
  import { formatJaDate } from "https://unpkg.com/tiny-ja-date@0.1.0/dist/index.js"

  console.log(formatJaDate(new Date(2026, 4, 12)))
</script>

Design policy

`tiny-ja-date` は日付ライブラリ全般ではなく、日本語UIでよく使う小さな関数だけを提供します。 

// v0.1 does not include:
// - Japanese holiday data
// - timezone conversion
// - wareki formatting
// - calendar generation
// - date-fns/dayjs replacement