timmy / Flask API 與農曆轉換工具

#!/usr/bin/env python3 # converter.py # 用於西曆與農曆互轉，已封裝成類別 import os import json import argparse from datetime import datetime class Converter: """ 提供西曆與農曆互轉功能： - solar_to_lunar(date_str:str) -> dict - lunar_to_solar(year:int, month:int, day:int, leap:bool) -> str """ LUNAR_JSON_DIR = 'lunar_json' @classmethod def load_solar_to_lunar(cls, year: int) -> dict: path = os.path.join(cls.LUNAR_JSON_DIR, f"{year}.json") if not os.path.exists(path): raise FileNotFoundError(f"找不到 {path}") with open(path, encoding='utf-8') as f: return json.load(f) def solar_to_lunar(self, solar_date_str: str) -> dict: try: dt = datetime.strptime(solar_date_str, '%Y-%m-%d').date() except ValueError: raise ValueError("西曆日期格式應為 YYYY-MM-DD") data = self.load_solar_to_lunar(dt.year) if solar_date_str not in data: raise KeyError(f"沒有找到對應 {solar_date_str} 的農曆資料") return data[solar_date_str] def lunar_to_solar(self, lunar_year: int, lunar_month: int, lunar_day: int, leap: bool=False) -> str: solar_year = lunar_year + 1 if lunar_month in (11, 12) else lunar_year data = self.load_solar_to_lunar(solar_year) # 精確匹配 for solar, info in data.items(): lstr = info.get('農曆','') is_leap = lstr.startswith('閏') core = lstr[1:] if is_leap else lstr m_str, d_str = core.replace('月','-').replace('日','').split('-') if int(m_str)==lunar_month and int(d_str)==lunar_day and is_leap==leap: return solar # 回退到非閏月匹配 for solar, info in data.items(): lstr = info.get('農曆','') is_leap = lstr.startswith('閏') core = lstr[1:] if is_leap else lstr m_str, d_str = core.replace('月','-').replace('日','').split('-') if int(m_str)==lunar_month and int(d_str)==lunar_day and not is_leap: return solar raise KeyError(f"找不到對應農曆 {lunar_year}{'閏' if leap else ''}{lunar_month}月{lunar_day}日 的西曆") def main(): parser = argparse.ArgumentParser(description='西曆與農曆互轉工具') sub = parser.add_subparsers(dest='command', required=True) # 西曆 -> 農曆 p1 = sub.add_parser('solar2lunar', help='西曆轉農曆') p1.add_argument('date', type=str, help='西曆日期 YYYY-MM-DD') # 農曆 -> 西曆 p2 = sub.add_parser('lunar2solar', help='農曆轉西曆') p2.add_argument('date', type=str, help='農曆日期 YYYY-MM-DD') p2.add_argument('--leap', action='store_true', help='是否閏月') args = parser.parse_args() conv = Converter() if args.command == 'solar2lunar': info = conv.solar_to_lunar(args.date) print(json.dumps(info, ensure_ascii=False, indent=2)) elif args.command == 'lunar2solar': try: y_str, m_str, d_str = args.date.split('-',2) y, m, d = int(y_str), int(m_str), int(d_str) except Exception: raise ValueError("農曆日期格式應為 YYYY-MM-DD，閏月請加 --leap") solar = conv.lunar_to_solar(y, m, d, args.leap) info = conv.solar_to_lunar(solar) print(json.dumps(info, ensure_ascii=False, indent=2)) if __name__ == '__main__': main()

# /// script # requires-python = ">=3.13" # dependencies = [ # "flask", # ] # /// import socket def find_free_port(start=5000, max_tries=100): """ 從 start 開始找一個未被監聽的 TCP 端口，最多嘗試 max_tries 次 """ port = start for _ in range(max_tries): with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s: s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) if s.connect_ex(('0.0.0.0', port)) != 0: return port port += 1 raise RuntimeError(f"在 {start}–{start+max_tries} 範圍內找不到可用端口") import json from flask import Flask, request, Response from converter import Converter app = Flask(__name__) conv = Converter() @app.route('/solar2lunar', methods=['GET']) def solar2lunar_endpoint(): date_str = request.args.get('date') if not date_str: return Response(json.dumps({'error': '缺少參數 date，格式 YYYY-MM-DD'}), mimetype='application/json; charset=utf-8'), 400 try: info_raw = conv.solar_to_lunar(date_str) info = { 'gregorian': info_raw['西曆'], # Gregorian date 'lunar': info_raw['農曆'], # Lunar date 'ganzhi': info_raw['干支'], # Heavenly Stem and Earthly Branch 'zodiac': info_raw['生肖'], # Zodiac animal 'solar_term': info_raw['節氣'] # Solar term } return Response(json.dumps(info, ensure_ascii=False), mimetype='application/json; charset=utf-8') except Exception as e: return Response(json.dumps({'error': str(e)}, ensure_ascii=False), mimetype='application/json; charset=utf-8'), 400 @app.route('/lunar2solar', methods=['GET']) def lunar2solar_endpoint(): date_str = request.args.get('date') leap_str = request.args.get('leap', 'false') if not date_str: return Response(json.dumps({'error': '缺少參數 date，格式 YYYY-MM-DD'}), mimetype='application/json; charset=utf-8'), 400 leap = leap_str.lower() in ('1', 'true', 'yes') try: y_str, m_str, d_str = date_str.split('-', 2) y, m, d = int(y_str), int(m_str), int(d_str) except Exception: return Response(json.dumps({'error': '農曆日期格式應為 YYYY-MM-DD，閏月請加 leap=true'}), mimetype='application/json; charset=utf-8'), 400 try: solar_date = conv.lunar_to_solar(y, m, d, leap) info_raw = conv.solar_to_lunar(solar_date) info = { 'gregorian': info_raw['西曆'], 'lunar': info_raw['農曆'], 'ganzhi': info_raw['干支'], 'zodiac': info_raw['生肖'], 'solar_term': info_raw['節氣'] } return Response(json.dumps(info, ensure_ascii=False), mimetype='application/json; charset=utf-8') except Exception as e: return Response(json.dumps({'error': str(e)}, ensure_ascii=False), mimetype='application/json; charset=utf-8'), 400 if __name__ == '__main__': port = find_free_port(5000) print(f"使用埠 {port} 啟動服務…") app.run(host='0.0.0.0', port=port)

#!/usr/bin/env python3 # /// script # requires-python = ">=3.13" # dependencies = [ # "skyfield", # ] # /// # requires-python = ">=3.13" # dependencies = [ # "skyfield", # "jplephem", # "numpy", # ] import os from lunar_calendar import LunarCalendar # 假設類別存於 lunar_calendar.py def main(): # 輸出目錄 output_dir = 'lunar_json' os.makedirs(output_dir, exist_ok=True) # 產生 1900~2100 年，每年一個 JSON 檔：<year>.json for year in range(1900, 2101): cal = LunarCalendar(year) filename = os.path.join(output_dir, f"{year}.json") cal.save_json(filename) if __name__ == "__main__": main()

#!/usr/bin/env python3 # /// script # requires-python = ">=3.13" # dependencies = [ # "skyfield", # "jplephem", # "numpy", # ] # /// import json from datetime import date, datetime, timedelta from skyfield.api import load from skyfield.framelib import ecliptic_frame from skyfield.almanac import find_discrete, moon_phases class LunarCalendar: """利用 Skyfield 計算農曆、干支、生肖、節氣並輸出 JSON。""" TZ_OFFSET = timedelta(hours=8) # 台北時區 HEAVENLY_STEMS = ['甲','乙','丙','丁','戊','己','庚','辛','壬','癸'] EARTHLY_BRANCHES = ['子','丑','寅','卯','辰','巳','午','未','申','酉','戌','亥'] ZODIAC = { '子':'鼠','丑':'牛','寅':'虎','卯':'兔','辰':'龍','巳':'蛇', '午':'馬','未':'羊','申':'猴','酉':'雞','戌':'狗','亥':'豬' } SOLAR_TERMS_24 = { 315:'立春',330:'雨水',345:'驚蟄', 0:'春分', 15:'清明', 30:'穀雨', 45:'立夏', 60:'小滿', 75:'芒種', 90:'夏至',105:'小暑',120:'大暑', 135:'立秋',150:'處暑',165:'白露',180:'秋分',195:'寒露',210:'霜降', 225:'立冬',240:'小雪',255:'大雪',270:'冬至',285:'小寒',300:'大寒', } def __init__(self, year: int): self.year = year self.ts = load.timescale() # self.eph = load('de421.bsp') self.eph = load('de440s.bsp') self.earth= self.eph['earth'] self.sun = self.eph['sun'] def _compute_astronomy(self): """抓新朔與 24 節氣時間點""" t0 = self.ts.utc(self.year-1, 11, 1) t1 = self.ts.utc(self.year+1, 3, 1) # 每月朔 times, phases = find_discrete(t0, t1, moon_phases(self.eph)) new_moons = [t for t,p in zip(times, phases) if p == 0] # 每 15° 的節氣 def term_index(t): lat, lon, _ = self.earth.at(t).observe(self.sun).apparent() \ .frame_latlon(ecliptic_frame) return (lon.degrees // 15).astype(int) term_index.step_days = 1 st_times, st_idxs = find_discrete(t0, t1, term_index) zhongqi = [(t, (idx * 15) % 360) for t,idx in zip(st_times, st_idxs)] return new_moons, zhongqi def _label_months(self, new_moons, zhongqi): """根據冬至、中氣規則標記每段朔月的月號與閏月屬性""" cutoff = date(self.year,1,1) sols = [ t for t,deg in zhongqi if deg == 270 and (t.utc_datetime() + self.TZ_OFFSET).date() < cutoff ] solstice = max(sols) i0 = max(i for i,t in enumerate(new_moons) if t.utc_datetime() < solstice.utc_datetime()) labels = [] month_no = 11 leap_used = False for j in range(i0, len(new_moons)-1): start, end = new_moons[j], new_moons[j+1] cnt = sum(1 for t,deg in zhongqi if start < t < end and deg % 30 == 0) if j == i0: labels.append((start, end, 11, False)) else: if cnt == 0 and not leap_used: labels.append((start, end, month_no, True)) leap_used = True else: month_no = month_no % 12 + 1 labels.append((start, end, month_no, False)) return labels def _ganzhi_year(self, y): """計算指定年之干支""" s = self.HEAVENLY_STEMS[(y - 4) % 10] b = self.EARTHLY_BRANCHES[(y - 4) % 12] return s + b def build_calendar(self): """產生從 YYYY-01-01 至 YYYY-12-31 的完整農曆對照表""" new_moons, zhongqi = self._compute_astronomy() month_labels = self._label_months(new_moons, zhongqi) # 節氣快查 solar_terms = {} for t,deg in zhongqi: d = (t.utc_datetime() + self.TZ_OFFSET).date().isoformat() name = self.SOLAR_TERMS_24.get(deg) if name: solar_terms[d] = name result = {} day = date(self.year,1,1) end = date(self.year,12,31) while day <= end: for ts, te, m, is_leap in month_labels: ds = (ts.utc_datetime() + self.TZ_OFFSET).date() de = (te.utc_datetime() + self.TZ_OFFSET).date() if ds <= day < de: # 農曆年：11–12 月屬上一農曆年，其它屬當年 lunar_year = self.year if 1 <= m <= 10 else self.year-1 gz_year = self._ganzhi_year(lunar_year) zodiac = self.ZODIAC[self.EARTHLY_BRANCHES[(lunar_year - 4) % 12]] offset = (day - ds).days + 1 lunar_str = f"{'閏' if is_leap else ''}{m}月{offset}日" result[day.isoformat()] = { "西曆": day.isoformat(), "農曆": lunar_str, "干支": gz_year, "生肖": zodiac, "節氣": solar_terms.get(day.isoformat(), "") } break day += timedelta(days=1) return result def save_json(self, filename: str = None): """將該年日曆輸出為 JSON 檔""" data = self.build_calendar() fname = filename or f"{self.year}.json" with open(fname, "w", encoding="utf-8") as f: json.dump(data, f, ensure_ascii=False, indent=2) print(f"完成！已輸出：{fname}") if __name__ == "__main__": import sys if len(sys.argv) != 2 or not sys.argv[1].isdigit(): print("用法：python3 lunar_calendar.py <年份>") sys.exit(1) year = int(sys.argv[1]) cal = LunarCalendar(year) cal.save_json()