Skip to content

Latest commit

 

History

History
184 lines (158 loc) · 4.2 KB

README.md

File metadata and controls

184 lines (158 loc) · 4.2 KB
Raw

japanese-date-converter

npm version main

This module help you to convert Japanese date and Western years.

Demo Page

Installation

Using in CommonJS

In CommonJS, please use like this.

const { JapaneseDateConverter } = require('japanese-date-converter')

const inputValue = "R01/05/01";
const settings = {
  format: "yyyy/MM/dd"
};
const converter = new JapaneseDateConverter({ inputValue, settings });
const convertedValue = converter.execute();
console.log(convertedValue); // "2019/05/01"

Using in ES Modules

In ES Modules, please use like this.

import { JapaneseDateConverter } from "japanese-date-converter";

const inputValue = "R01/05/01";
const settings = {
  format: "yyyy/MM/dd"
};
const converter = new JapaneseDateConverter({ inputValue, settings });
const convertedValue = converter.execute();
console.log(convertedValue); // "2019/05/01"

Using in jQuery

Download script in dist folder, and include the script after loading your jQuery library.

<script src="../dist/jquery.japanese-date-converter.js"></script>

And, call like this.
In this library, library catch change event, so inputted text will be formatted automatically after text entering.

<script>
  $(document).ready(function () {
    $("#target").japanese_date_converter({ format: "yyyy/MM/dd" });
  });
</script>

Details

  1. When text inputted, the text will be parsed internally in this library.

  2. After parsed internally in this library, parsed date(time) will be formatted as given format.

  • example
    • When format is "gee/MM/dd", "2019/04/30" will be formatted as "H31/04/30".
    • When format is "ggge年M月d日", "2019/04/05" will be formatted as "平成31年4月5日".
  • If you'd like to know more, please check Demo Page.
  1. Supported format is as below.
years
style example date converted example
ggg 2019/04/30 平成
gg 2019/04/30 平
g 2019/04/30 H
yyyy 2019/04/30 2019
yy 2019/04/30 19
ee 1990/04/30 02
e 1990/04/30 2
months
style example date converted example
mmmmm 2019/04/30 A
mmmm 2019/04/30 April
mmm 2019/04/30 Apr
MM 2019/04/30 04
M 2019/04/30 4
days
style example date converted example
dd 2019/04/02 02
d 2019/04/02 2

Contributing

  1. fork this repository.
  2. run yarn install
  3. fix or add new feature.
  4. after fix or add new feature, run these command.
  • yarn lint
  • yarn test
  • yarn build
  1. if any warn or error occurred, fix your code and run above commands again.
  2. commit your changes, and create Pull Request in GitHub.

Authors

shoutatani