---
id: "year_jp_era"
kind: "pattern"
status: "draft"
is_pii: false
categories: ["datetime"]
country: ["JP"]
langs: ["ja"]
quality: 80
url: "https://registry.apicrafter.io/datatype/year_jp_era"
---

# Year in a Japanese era (wareki) (`year_jp_era`)

> **Draft.** Draft records have not been reviewed yet and may be incomplete or wrong; do not treat them as authoritative for legal or compliance decisions.

Year written with a Japanese era name and the year of that era, in full (平成4年) or with the one-character abbreviation of the era (昭58, 平5, 令元). 元 stands for the first year of an era. Municipal data often uses it for fiscal years (年度). Digits may be full-width (平９).

- Pattern of: `year`
- Personal data (PII): no
- Categories: Date and time (datetime)
- Countries: Japan (JP)
- Languages: Japanese (ja)

## Detection

Regular expression (Python `re`):

```
^(?:明治|大正|昭和|平成|令和|明|大|昭|平|令)\s*(?:元|[0-9０-９]{1,2})(?:年度?)?$
```

## Examples

- `平成4年` — 1992
- `昭58` — 1983
- `平５` — 1993, with a full-width digit
- `令元` — 2019
- `1992年` (invalid example) — Gregorian year

## Translations

- ja: 和暦の年

## Sources

- wikipedia: <https://en.wikipedia.org/wiki/Japanese_era_name>

## Quality

Score 80/100. Missing: mapping (Wikidata, Schema.org, ...), detector coverage.

JSON: <https://registry.apicrafter.io/api/v1/datatypes/year_jp_era.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/JP/datetime/year_jp_era.yaml>