README.en.adoc

Dataset of the Japanese era

日本語

This repository contains a dataset of the Japanese era in YAML format.

Structure

The era is represented by the associative array.

For example, the associative array representing the Heisei era is:

era:
  heisei:
    number: 231
    kanji: 平成
    kyujitai: null
    english: Heisei
    start: 1989-01-08
    end: 2019-05-01

The meanings of the key/value pairs are as follows:

number

The position of the era in the list of Japanese era names. null if not in the list.

kanji

The era name in kanji.

kyujitai

The era name in kyūjitai. null if same as kanji.

english

The era name in English.

start

The start date of the era.

end

The end date of the era. null for the current era.

The following keys exist in the Nanboku-chō period:

southern-number

The position of the era in the list of the Southern Court era names. This may be null.

northern-number

The position of the era in the list of the Northern Court era names. This may be null.

Directory structure

The YAML files representing the eras are as follows:

assets/yaml/asuka.yaml

It contains the eras in the Asuka period (from Taika to Wadō).

assets/yaml/nara.yaml

It contains the eras in the Nara period (from Reiki to Enryaku).

assets/yaml/heian.yaml

It contains the eras in the Heian period (from Daidō to Genryaku).

assets/yaml/kamakura.yaml

It contains the eras in the Kamakura period (from Bunji to Karyaku).

assets/yaml/southern-court.yaml

It contains the eras of the Southern Court (from Gentoku to Genchū).

assets/yaml/northern-court.yaml

It contains the eras of the Northern Court (from Gentoku to Meitoku).

assets/yaml/muromachi.yaml

It contains the eras in the Muromachi period (from Ōei to Genki).

assets/yaml/azuchi-momoyama.yaml

It contains the eras in the Azuchi–Momoyama period (from Tenshō to Keichō).

assets/yaml/edo.yaml

It contains the eras in the Edo period (from Genna to Keiō).

assets/yaml/modern.yaml

It contains the eras of the modern era (after Meiji).

Convert to other formats

This project contains Deno scripts for converting YAML files to JSON files.

To convert to JSON files

./scripts/yaml2json.ts

This will output JSON files in the assets/json directory.

Source code

The upstream repository is available at https://github.com/sorairolake/japanese-era-dataset.git.

The source code is also available at

• https://gitlab.com/sorairolake/japanese-era-dataset.git

• https://codeberg.org/sorairolake/japanese-era-dataset.git

Changelog

Please see CHANGELOG.adoc.

Contributing

Please see CONTRIBUTING.adoc.

Acknowledgment

This dataset was created using the following:

• 元号一覧 (日本) on the Japanese Wikipedia (for the era name in kanji).

• Japanese era name on the English Wikipedia (for the era name in English).

• https://github.com/nagataaaas/Japanera (for the start date and the end date).

License

Unless otherwise noted, the contents of this repository are distributed under the terms of the CC0 1.0 Universal.

This project is compliant with version 3.2 of the REUSE Specification. See copyright notices of individual files for more details on copyright and licensing information.