JapaneseDate

JapaneseDate

Overview

JapaneseDate は、JavaScriptのDateオブジェクトを日本の元号表記などに変換するライブラリです。

このページでは、ブラウザで直接読み込んだ場合の動作確認ができます。

Installation

npm install japanese-date-format
# or
yarn add japanese-date-format

Supported formats

Example: date = new Date('1989-02-01');

Characters Format
YYYY 1989
MM 02
DD 01
J 平成
b H
K 1
k 元

基本的な使い方

// 現在時刻でフォーマット
console.log(JapaneseDate.format(new Date(), "Jk年MM月DD日")); // 例: 令和06年11月21日

// 特定の日付でフォーマット
const date = new Date("2017-01-03");
console.log(JapaneseDate.format(date, "Jk年MM月DD日")); // 平成29年01月03日

// 和暦文字列からDateオブジェクトを生成してフォーマット
let date2 = JapaneseDate.parseStringToDate('H29/01/02');  
console.log(JapaneseDate.format(date2, 'Jk年MM月DD日')); // 平成29年01月02日

西暦から和暦への変換デモ

日付を選択して変換を試せます：


和暦から西暦への変換デモ

和暦の日付を入力してください（例: H29/01/02, 平成29年1月2日）：