{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"era-year-converter"},"result":{"entity_type":"calculator","id":"era-year-converter","calculator_id":"era-year-converter","canonical_url":"https://tttkmbb.com/lunar/era-year-converter","name":"Era Year Converter","title":"Era Year Converter – Minguo, Japanese Era, Buddhist, Huangdi, Dangun, Juche, Islamic, Hebrew, Persian and Other Year Counts","category":"lunar","category_name":"Chinese Calendar","tool_name":"convert_year_to_eras","featured_mcp_tool":false,"description":"Converts a Gregorian year (optionally an exact date) into the year counts of other calendars and eras: 民国 (Mínguó), Japanese 元号 (gengō), Thai Buddhist Era, 黄帝纪元 (Huángdì), 檀纪 (Dangun), 主体 (Juche), 皇纪 (kōki), Holocene, tabular Islamic (AH), Hebrew (AM), Solar Hijri, Ethiopian, Coptic and Byzantine years, plus the Chinese stem-branch year and zodiac.","use_when":"You need to label a year in another era system, know which two years of a calendar overlap a Gregorian year, or find the era in effect on a specific date (e.g. 昭和 or 平成 in 1989).","do_not_use_when":"You need a full date conversion into the Chinese lunar calendar (use lunar-calendar-converter) or a religious calendar date fixed by observation (Islamic dates here are tabular and can differ by 1–2 days).","inputs":[{"name":"year","label":"Gregorian year","type":"integer","required":true,"min":-1000,"max":2500,"description":"Proleptic Gregorian year (astronomical numbering: 0 = 1 BC, −1 = 2 BC).","example":2026},{"name":"date","label":"Exact date (optional)","type":"date","required":false,"description":"A date within that year; when given, eras_on_date reports the values in effect on that day (for boundaries such as Rosh Hashanah, Nowruz or a Japanese era change).","example":"2026-09-24"}],"outputs":[{"name":"year_used","label":"Gregorian year","type":"integer","decimals":0,"description":"The input year."},{"name":"minguo_year","label":"民国 (Minguo)","type":"string","decimals":4,"description":"Republic of China year = year − 1911, valid from 1912."},{"name":"japanese_era","label":"Japanese era (元号)","type":"string","decimals":4,"description":"Era name and year in effect on 1 January and 31 December (明治 1868-10-23, 大正 1912-07-30, 昭和 1926-12-25, 平成 1989-01-08, 令和 2019-05-01)."},{"name":"buddhist_era_thai","label":"Buddhist Era (พ.ศ.)","type":"integer","decimals":0,"description":"Thai Buddhist Era = year + 543."},{"name":"huangdi_era","label":"黄帝纪元 (Huangdi)","type":"integer","decimals":0,"description":"Yellow Emperor era = year + 2697 (some sources use + 2698)."},{"name":"dangun_era","label":"檀纪 (Dangun)","type":"integer","decimals":0,"description":"Korean Dangun era = year + 2333."},{"name":"juche_year","label":"主体 (Juche)","type":"string","decimals":4,"description":"Juche year = year − 1911, valid from 1912."},{"name":"koki_year","label":"皇纪 (Kōki)","type":"integer","decimals":0,"description":"Japanese imperial year = year + 660."},{"name":"holocene_year","label":"Holocene (HE)","type":"integer","decimals":0,"description":"Holocene calendar = year + 10000."},{"name":"islamic_years","label":"Islamic (AH)","type":"string","decimals":4,"description":"Hijri years on 1 January and 31 December by the tabular calendar (30-year cycle, leap years 2,5,7,10,13,16,18,21,24,26,29)."},{"name":"hebrew_years","label":"Hebrew (AM)","type":"string","decimals":4,"description":"Hebrew years on 1 January and 31 December (year + 3760 before Rosh Hashanah, + 3761 after)."},{"name":"persian_years","label":"Solar Hijri (SH)","type":"string","decimals":4,"description":"Persian years before Nowruz (year − 622) and from Nowruz (year − 621)."},{"name":"ethiopian_years","label":"Ethiopian","type":"string","decimals":4,"description":"Ethiopian years on 1 January (year − 8) and 31 December (year − 7)."},{"name":"coptic_years","label":"Coptic (AM)","type":"string","decimals":4,"description":"Coptic years on 1 January (year − 284) and 31 December (year − 283)."},{"name":"byzantine_years","label":"Byzantine (AM)","type":"string","decimals":4,"description":"Byzantine years on 1 January (year + 5508) and from 1 September (year + 5509)."},{"name":"chinese_ganzhi","label":"Chinese year (干支)","type":"string","decimals":4,"description":"Stem-branch of the Chinese year that begins in this Gregorian year."},{"name":"chinese_zodiac","label":"Chinese zodiac (生肖)","type":"string","decimals":4,"description":"Zodiac animal of that Chinese year."},{"name":"new_year_dates","label":"New-year dates in this year","type":"object","decimals":4,"description":"Gregorian date on which each calendar's new year falls within the year."},{"name":"century","label":"Century","type":"string","decimals":4,"description":"Ordinal century (2001–2100 = 21st)."},{"name":"decade","label":"Decade","type":"string","decimals":4,"description":"Decade label, e.g. 2020s."},{"name":"is_leap_year","label":"Gregorian leap year","type":"boolean","decimals":4,"description":"true when the proleptic Gregorian year has 366 days."},{"name":"eras_on_date","label":"Eras on the given date","type":"object","decimals":4,"description":"Values in effect on the optional date (only returned when date is given)."}],"input_schema":{"type":"object","properties":{"year":{"description":"Proleptic Gregorian year (astronomical numbering: 0 = 1 BC, −1 = 2 BC).","type":"integer","minimum":-1000,"maximum":2500,"examples":[2026]},"date":{"description":"A date within that year; when given, eras_on_date reports the values in effect on that day (for boundaries such as Rosh Hashanah, Nowruz or a Japanese era change).","type":"string","format":"date","examples":["2026-09-24"]}},"additionalProperties":false,"required":["year"]},"output_schema":{"type":"object","properties":{"year_used":{"description":"The input year.","type":"integer"},"minguo_year":{"description":"Republic of China year = year − 1911, valid from 1912.","type":"string"},"japanese_era":{"description":"Era name and year in effect on 1 January and 31 December (明治 1868-10-23, 大正 1912-07-30, 昭和 1926-12-25, 平成 1989-01-08, 令和 2019-05-01).","type":"string"},"buddhist_era_thai":{"description":"Thai Buddhist Era = year + 543.","type":"integer"},"huangdi_era":{"description":"Yellow Emperor era = year + 2697 (some sources use + 2698).","type":"integer"},"dangun_era":{"description":"Korean Dangun era = year + 2333.","type":"integer"},"juche_year":{"description":"Juche year = year − 1911, valid from 1912.","type":"string"},"koki_year":{"description":"Japanese imperial year = year + 660.","type":"integer"},"holocene_year":{"description":"Holocene calendar = year + 10000.","type":"integer"},"islamic_years":{"description":"Hijri years on 1 January and 31 December by the tabular calendar (30-year cycle, leap years 2,5,7,10,13,16,18,21,24,26,29).","type":"string"},"hebrew_years":{"description":"Hebrew years on 1 January and 31 December (year + 3760 before Rosh Hashanah, + 3761 after).","type":"string"},"persian_years":{"description":"Persian years before Nowruz (year − 622) and from Nowruz (year − 621).","type":"string"},"ethiopian_years":{"description":"Ethiopian years on 1 January (year − 8) and 31 December (year − 7).","type":"string"},"coptic_years":{"description":"Coptic years on 1 January (year − 284) and 31 December (year − 283).","type":"string"},"byzantine_years":{"description":"Byzantine years on 1 January (year + 5508) and from 1 September (year + 5509).","type":"string"},"chinese_ganzhi":{"description":"Stem-branch of the Chinese year that begins in this Gregorian year.","type":"string"},"chinese_zodiac":{"description":"Zodiac animal of that Chinese year.","type":"string"},"new_year_dates":{"description":"Gregorian date on which each calendar's new year falls within the year.","type":"object"},"century":{"description":"Ordinal century (2001–2100 = 21st).","type":"string"},"decade":{"description":"Decade label, e.g. 2020s.","type":"string"},"is_leap_year":{"description":"true when the proleptic Gregorian year has 366 days.","type":"boolean"},"eras_on_date":{"description":"Values in effect on the optional date (only returned when date is given).","type":"object"}}},"formula":"民国 = 主体 = year − 1911; BE = year + 543; 黄帝 = year + 2697; 檀纪 = year + 2333; 皇纪 = year + 660; HE = year + 10000; Hebrew = year + 3760/3761; Solar Hijri = year − 622/621; Ethiopian = year − 8/7; Coptic = year − 284/283; Byzantine = year + 5508/5509; Hijri new year JDN = 1948440 + 354 × (AH − 1) + floor((3 + 11 × AH) / 30); Chinese stem-branch index = (year − 4) mod 60","method":"Tabular Islamic calendar with the civil epoch (Friday 16 July 622 Julian); Hebrew new year by the Reingold–Dershowitz elapsed-days algorithm; Nowruz by the March equinox rule at Tehran time; Ethiopian and Coptic years from their epochs with a leap day every fourth year. Years before 1583 are proleptic Gregorian; Japanese eras before 明治 are not tabulated. Traditional reference calculation of the Chinese calendar tradition; not a prediction and not medical, legal or financial advice.","sources":[{"name":"Reingold & Dershowitz – Calendrical Calculations (Cambridge University Press)","url":"https://www.cs.tau.ac.il/~nachum/calendar-book/index.shtml","type":"textbook","retrieved_at":"2026-09-24"},{"name":"Tabular Islamic calendar (Wikipedia)","url":"https://en.wikipedia.org/wiki/Tabular_Islamic_calendar","type":"reference","retrieved_at":"2026-09-24"},{"name":"Japanese era name (Wikipedia)","url":"https://en.wikipedia.org/wiki/Japanese_era_name","type":"reference","retrieved_at":"2026-09-24"}],"freshness":{"type":"static","max_age_seconds":null,"note":"Deterministic formula with fixed constants; results never go stale. Inputs supplied by the caller determine the output."},"examples":[{"name":"2026","inputs":{"year":2026},"expected":{"minguo_year":"民国 115 (Minguo 115)","japanese_era":"令和 8 (Reiwa 8)","buddhist_era_thai":2569,"huangdi_era":4723,"dangun_era":4359,"juche_year":"主体 115 (Juche 115)","koki_year":2686,"holocene_year":12026,"islamic_years":"1447/1448","hebrew_years":"5786/5787","persian_years":"1404/1405","ethiopian_years":"2018/2019","coptic_years":"1742/1743","byzantine_years":"7534/7535","chinese_ganzhi":"丙午 (Bingwu)","chinese_zodiac":"Horse (马)","new_year_dates":{"Islamic 1448 AH":"2026-06-17 (tabular)","Hebrew 5787 AM":"2026-09-12","Persian 1405 SH":"2026-03-21","Ethiopian 2019":"2026-09-11","Coptic 1743 AM":"2026-09-11","Byzantine 7535 AM":"2026-09-01","Chinese 丙午":"2026-02-17"},"century":"21st century","decade":"2020s","is_leap_year":false},"url":"https://tttkmbb.com/api/v1/calculate/era-year-converter?year=2026"},{"name":"1989 (昭和 → 平成 on 8 January)","inputs":{"year":1989,"date":"1989-01-07"},"expected":{"minguo_year":"民国 78 (Minguo 78)","japanese_era":"昭和 64 (Shōwa 64) until 1989-01-07 / 平成 1 (Heisei 1) from 1989-01-08","buddhist_era_thai":2532,"hebrew_years":"5749/5750","persian_years":"1367/1368","islamic_years":"1409/1410","chinese_ganzhi":"己巳 (Jisi)","chinese_zodiac":"Snake (蛇)","century":"20th century","is_leap_year":false,"eras_on_date":{"japanese_era":"昭和 64 (Shōwa 64)","hebrew":"5749 AM","persian":"1367 SH"}},"url":"https://tttkmbb.com/api/v1/calculate/era-year-converter?year=1989&date=1989-01-07"}],"faq":[{"q":"Which Islamic calendar is used?","a":"The arithmetic tabular calendar (type II intercalation, civil epoch), the one used for historical date conversion. Observational calendars such as Umm al-Qura can begin a month one or two days earlier or later."},{"q":"Why two values for most calendars?","a":"Their new year does not fall on 1 January: the Hebrew year changes at Rosh Hashanah (September/October), the Persian at Nowruz (20/21 March), the Ethiopian and Coptic on 11/12 September, the Byzantine on 1 September, the Chinese at Chinese New Year. Give a date to get the single value in effect."},{"q":"Is 黄帝纪元 always year + 2697?","a":"No: + 2697 (Huangdi year 1 = 2697 BC) is the most common convention, but + 2698 is also used; both are traditional attributions with no historical basis."}],"tags":["minguo year","japanese era","reiwa","buddhist era","hijri year","hebrew year","year converter"],"related":[{"calculator_id":"chinese-zodiac","reason":"Zodiac and stem-branch of a birth date with the proper Chinese New Year boundary."},{"calculator_id":"leap-year","reason":"Leap-year rule of the Gregorian calendar."},{"calculator_id":"roman-numeral","reason":"Write the year in Roman numerals."}],"links":{"html":"https://tttkmbb.com/lunar/era-year-converter","markdown":"https://tttkmbb.com/lunar/era-year-converter.md","json":"https://tttkmbb.com/lunar/era-year-converter.json","api":"https://tttkmbb.com/api/v1/calculate/era-year-converter","schema":"https://tttkmbb.com/api/v1/calculators/era-year-converter","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-24"},"timestamp":"2026-09-24T08:33:14Z"}