LunarCalendar

https://github.com/wolfhong/lunarcalendar
Admin
LunarCalendar is a lunar-solar calendar converter with support for lunar and solar festivals,...
Tokens:70,693
Snippets:156
Trust Score:6.6
License:MIT
Update:6 months ago
Show doc for...
Tokens:
Raw
### Canvas Initialization

Source: https://github.com/wolfhong/lunarcalendar/blob/master/generate.html

Setup logic for initializing the canvas coordinate system and dimensions.

```javascript
var tu1 = { isInit: 0, x0: 0, y0: 0, w: 0, h: 0, dx: 0, dy: 0, diming: new Array(116.4, 40, '北京', 119, 25.4, '莆田', 91, 29.7, '拉萨', -73, 41, '纽约', 151, -34, '悉尼', 37, 56, '莫斯科', 30, -20, '非洲南部', -56, -33, '乌拉圭'), init: function (can) { ht.canvas = can; if (this.isInit)return; this.isInit = 1; this.w = String(can.style.width).replace(/[^0-9]/g, ''); this.h = String(can.style.height).replace(/[^0-9]/g, ''); can.coordsize = this.w + ',' + this.h; var x0, y0, dx, dy, vs, vx, vy, us; dx = this.dx =
```

--------------------------------

### Astronomical Chart Setup

Source: https://github.com/wolfhong/lunarcalendar/blob/master/generate.html

Initializes the configuration for a secondary astronomical chart with multiple shape layers.

```javascript
var tu3 = { isInit: 0, eR: 250, x0: 350, y0: 300, init: function (can) { ht.canvas = can; if (this.isInit)return; this.isInit = 1; this.w = String(can.style.width).replace(/[^0-9]/g, ''); this.h = String(can.style.height).replace(/[^0-9]/g, ''); can.coordsize = this.w + ',' + this.h; this.p = ht.shape(''), this.p.filled = false, this.p.strokeColor = '#E0E0E0'; this.P1 = ht.shape(''), this.P1.filled = false, this.P1.strokeColor = '#808080'; this.P2 = ht.shape(''), this.P2.filled = false, this.P2.strokeColor = '#D0D0FF'; this.A = ht.shape(''), this.A.filled = false, this.A.strokeColor = '#FF6060'; this.B = ht.shape(''), this.B.filled = false, this.B.strokeColor = '#80F080'; this.C = ht.shape(''), this.C.filled = false, this.C.strokeColor = '#8080F0'; this.D = ht.shape(''), this.D.fille
```

--------------------------------

### Solar to Lunar Conversion

Source: https://github.com/wolfhong/lunarcalendar/blob/master/README.rst

Convert a Solar date to a Lunar date using the Converter class. This example demonstrates converting a specific solar date and then converting it back to solar to verify.

```python
import datetime
from lunarcalendar import Converter, Solar, Lunar, DateNotExist

solar = Solar(2018, 1, 1)
print(solar)
lunar = Converter.Solar2Lunar(solar)
print(lunar)
solar = Converter.Lunar2Solar(lunar)
print(solar)
print(solar.to_date(), type(solar.to_date()))
```

--------------------------------

### Initialize Projection Settings

Source: https://github.com/wolfhong/lunarcalendar/blob/master/generate.html

Sets up the projection type and parameters, including initial longitude and latitude offsets, and defines the bounding box for the projection. It selects the appropriate `toxy` method based on the `lx` parameter.

```javascript
setlx: function (lx, J0, W0, jb) {
  this.tylx = lx, this.J0 = J0, this.W0 = W0;
  this.cosE0 = sin(W0), this.sinE0 = cos(W0);
  if (lx == 0)this.toxy = this.toxy0;
  if (lx == 1)this.toxy = this.toxy1;
  if (lx == 2)this.toxy = this.toxy2;
  if (lx == 3)this.toxy = this.toxy3;
  if (lx == 4)this.toxy = this.toxy4;
  if (lx == 5)this.toxy = this.toxy5;
  if (lx == 6)this.toxy = this.toxy6;
  if (lx == 7)this.toxy = this.toxy7;
  if (lx == 8)this.toxy = this.toxy8;
  this.x1 = jb[0] - jb[2], this.x2 = jb[0] + jb[2];
  this.y1 = jb[1] - jb[3], this.y2 = jb[1] + jb[3];
}
```

--------------------------------

### Use the lunar-find Command-Line Tool

Source: https://context7.com/wolfhong/lunarcalendar/llms.txt

Look up festival and solar term dates using the command-line interface.

```bash
# Find a specific festival by name
$ lunar-find 中秋
中秋节 on 2024: 2024-09-17

# Find festival for a specific year
$ lunar-find 春节 2025
春节 on 2025: 2025-01-29

# Festival alias lookup (重阳 = 登高节 = 重九节)
$ lunar-find 登高节 2024
重阳节 on 2024: 2024-10-11

# Traditional Chinese character support
$ lunar-find 重陽節
重阳节 on 2024: 2024-10-11

# List all festivals for a year (sorted by date)
$ lunar-find festival 2024

# List all 24 solar terms for a year
$ lunar-find solarterm 2024
$ lunar-find 节气 2024

# List everything (festivals + solar terms) for a year
$ lunar-find all 2024

# Show version
$ lunar-find --version
0.0.9

# Show help
$ lunar-find --help
```

--------------------------------

### Lunar Date Legality Check

Source: https://github.com/wolfhong/lunarcalendar/blob/master/README.rst

Check the legality of a lunar date. This example demonstrates that a leap month on February 15, 2018, does not exist, while a leap month on April 4, 2012, does exist.

```python
Lunar(2012, 4, 4, isleap=True)  # date(2012, 5, 24)
try:
    lunar = Lunar(2018, 2, 15, isleap=True)
except DateNotExist:
    print(traceback.format_exc())
```

--------------------------------

### Calculate Moon BSE Coordinates

Source: https://github.com/wolfhong/lunarcalendar/blob/master/generate.html

Calculates the Moon's position in Barycentric Celestial Reference System (BSE) coordinates, normalized by the Earth's radius. It uses `chazhi` to get the Moon's position and then converts it.

```javascript
bseM: function (jd) {
  var a = this.cd2bse(this.chazhi(jd, 1), this.chazhi(jd, 2));
  a[0] /= cs_rEar, a[1] /= cs_rEar, a[2] /= cs_rEar;
  return a;
}
```

--------------------------------

### Coordinate System Initialization and Line Drawing

Source: https://github.com/wolfhong/lunarcalendar/blob/master/generate.html

Initializes canvas coordinate systems and draws intersection lines for astronomical charts.

```javascript
var tu2 = { isInit: 0, eR: 150, x0: 240, y0: 280, init: function (can) { ht.canvas = can; if (this.isInit)return; this.isInit = 1; this.w = String(can.style.width).replace(/[^0-9]/g, ''); this.h = String(can.style.height).replace(/[^0-9]/g, ''); can.coordsize = this.w + ',' + this.h; this.eth = ht.oval(0, 0, this.eR * 2, this.eR * 2); this.eth.filled = false; this.eth.moveto2(this.x0, this.y0); var p = ht.shape(''), p2; p.stroke.endArrow = 'classic'; p.p_moveto(this.x0 - this.eR * 1.2, this.y0); p.p_lineto(this.x0 + this.eR * 1.2, this.y0); p.p_moveto(this.x0, this.y0 + this.eR * 1.2); p.p_lineto(this.x0, this.y0 - this.eR * 1.2); p.p_save(); p2 = ht.textbox(this.x0 + this.eR * 1.2 - 20, this.y0, 60, 15, '交线'); p2.filled = false; p2.stroked = false; this.zbTxt = p2; this.zxx = ht.shape(''); this.dbj = ht.oval(0, 0, 6, 6); this.dbj.stroked = false; this.dbj.style.display = 'none'; }, line1: function (a, hd) { if (a.d > 1.6)return; var p = this.zxx, R = this.eR; var xc = a.xc, yc = a.yc, k = a.k; if (hd) { var r = sqrt(xc * xc + yc * yc), s = atan2(yc, xc) + a.ds, dk = tan(a.ds); xc = r * cos(s); yc = r * sin(s); k = (k + dk) / (1 - k * dk); } p.p_moveto(-1.2 * R + this.x0, -(k * (-1.2 - xc) + yc) * R + this.y0); p.p_lineto(1.2 * R + this.x0, -(k * (1.2 - xc) + yc) * R + this.y0); p.p_save(); if (!hd) { this.zbTxt.txtID.innerHTML = innerText = '贝赤交线'; this.dbj.moveto2(this.x0, -R * cos(Math.PI / 2 - a.I[1]) + this.y0); if (a.I[1] < Math.PI / 2)this.dbj.fillcolor = '#00a0FF'; else this.dbj.fillcolor = '#000000'; this.dbj.style.display = 'block'; } else { this.zbTxt.txtID.innerHTML = innerText = '贝黄交线'; this.dbj.style.display = 'none'; } } };
```

--------------------------------

### Lunar to Solar Conversion

Source: https://github.com/wolfhong/lunarcalendar/blob/master/README.rst

Convert a Lunar date to a Solar date using the Converter class. This example shows converting a specific lunar date, converting it back to lunar, and also creating a Lunar object from a Python date object.

```python
lunar = Lunar(2018, 2, 30, isleap=False)
print(lunar)
solar = Converter.Lunar2Solar(lunar)
print(solar)
lunar = Converter.Solar2Lunar(solar)
print(lunar)
print(lunar.to_date(), type(lunar.to_date()))
print(Lunar.from_date(datetime.date(2018, 4, 15)))
```

--------------------------------

### Initialize and Calculate Lunar Calendar Data

Source: https://github.com/wolfhong/lunarcalendar/blob/master/generate.html

Initializes the astronomical data structures and provides the core calculation method for solar terms and lunar months.

```javascript
1"; suoS += "hhdikgjfifaakekighie1hiaikggikhkffakicjhiahaikggikhkijF1kfejfeFhidikggiffiggkigicjiekgieeigikggiffig"; suoS += "gkidheigkgfjkeigiegikifiggkidhedeijcfkFikikhkiggkidhh1ehigcikaffkhkiggkidhh1hhigikekfiFkFikcidhh1hit"; suoS += "cikggikhkfkicjicghiediaikggikhkijbjfejfeFhaikggifikiggkigiejkikgkgieeigikggiffiggkigieeigekijcijikgg"; suoS += "ifikiggkideedeijkefkfckikhkiggkidhh1ehijcikaffkhkiggkidhh1hhigikhkikFikfckcidhh1hiaikgjikhfjicjicgie"; suoS += "hdikcikggifikigiejfejkieFhegikggifikiggfghigkfjeijkhigikggifikiggkigieeijcijcikfksikifikiggkidehdeij"; suoS += "cfdckikhkiggkhghh1ehijikifffffkhsFngErD1pAfBoDd1BlEtFqA2AqoEpDqElAEsEeB2BmADlDkqBtC1FnEpDqnEmFsFsAFn"; suoS += "llBbFmDsDiCtDmAB2BmtCgpEplCpAEiBiEoFqFtEqsDcCnFtADnFlEgdkEgmEtEsCtDmADqFtAFrAtEcCqAE1BoFqC1F1DrFtBmF"; suoS += "tAC2ACnFaoCgADcADcCcFfoFtDlAFgmFqBq2bpEoAEmkqnEeCtAE1bAEqgDfFfCrgEcBrACfAAABqAAB1AAClEnFeCtCgAADqDoB"; suoS += "mtAAACbFiAAADsEtBqAB2FsDqpFqEmFsCeDtFlCeDtoEpClEqAAFrAFoCgFmFsFqEnAEcCqFeCtFtEnAEeFtAAEkFnErAABbFkAD"; suoS += "nAAeCtFeAfBoAEpFtAABtFqAApDcCGJ"; qiS = "FrcFs22AFsckF2tsDtFqEtF1posFdFgiFseFtmelpsEfhkF2anmelpFlF1ikrotcnEqEq2FfqmcDsrFor22FgFrcgDscFs22FgEe"; qiS += "FtE2sfFs22sCoEsaF2tsD1FpeE2eFsssEciFsFnmelpFcFhkF2tcnEqEpFgkrotcnEqrEtFermcDsrE222FgBmcmr22DaEfnaF22"; qiS += "2sD1FpeForeF2tssEfiFpEoeFssD1iFstEqFppDgFstcnEqEpFg11FscnEqrAoAF2ClAEsDmDtCtBaDlAFbAEpAAAAAD2FgBiBqo"; qiS += "BbnBaBoAAAAAAAEgDqAdBqAFrBaBoACdAAf1AACgAAAeBbCamDgEifAE2AABa1C1BgFdiAAACoCeE1ADiEifDaAEqAAFe1AcFbcA"; qiS += "AAAAF1iFaAAACpACmFmAAAAAAAACrDaAAADG0"; this.SB = this.jieya(suoS); this.QB = this.jieya(qiS); }, calc: function (jd, qs) { jd += 2451545; var i, D, n; var B = this.suoKB, pc = 14; if (qs == '气')B = this.qiKB, pc = 7; var f1 = B[0] - pc, f2 = B[B.length - 1] - pc, f3 = 2436935; if (jd < f1 || jd >= f3) { if (qs == '气')return Math.floor(this.qi_high(Math.floor((jd + pc - 2451259) / 365.2422 * 24) * Math.PI / 12) + 0.5); else return Math.floor(this.so_high(Math.floor((jd + pc - 2451551) / 29.5306) * Math.PI * 2) + 0.5); } if (jd >= f1 && jd < f2) { for (i = 0; i < B.length; i += 2)if (jd + pc < B[i + 2])break; D = B[i] + B[i + 1] * Math.floor((jd + pc - B[i]) / B[i + 1]); D = Math.floor(D + 0.5); if (D == 1683460)D++; return D - 2451545; } if (jd >= f2 && jd < f3) { if (qs == '气') { D = Math.floor(this.qi_low(Math.floor((jd + pc - 2451259) / 365.2422 * 24) * Math.PI / 12) + 0.5); n = this.QB.substr(Math.floor((jd - f2) / 365.2422 * 24), 1); } else { D = Math.floor(this.so_low(Math.floor((jd + pc - 2451551) / 29.5306) * Math.PI * 2) + 0.5); n = this.SB.substr(Math.floor((jd - f2) / 29.5306), 1); } if (n == "1")return D + 1; if (n == "2")return D - 1; return D; } }, leap: 0, ym: new Array(), ZQ: new Array(), HS: new Array(), dx: new Array(), Yn: new Array(), calcY: function (jd) { var A = this.ZQ, B = this.HS; var i, k, W, w; W = int2((jd - 355 + 183) / 365.2422) * 365.2422 + 355; if (this.calc(W, '气') > jd)W -= 365.2422; for (i = 0; i < 25; i++)A[i] = this.calc(W + 15.2184 * i, '气'); A.pe1 = this.calc(W - 15.2, '气'); A.pe2 = this.calc(W - 30.4, '气'); w = this.calc(A[0], '朔'); if (w > A[0])w -= 29.53; for (i = 0; i < 15; i++)B[i] = this.calc(w + 29.5306 * i, '朔'); this.leap = 0; for (i = 0; i < 14; i++) { this.dx[i] = this.HS[i + 1] - this.HS[i]; this.ym[i] = i; } var YY = int2((this.ZQ[0] + 10 + 180) / 365.2422) + 2000; if (YY >= -721 && YY <= -104) { var ns = new Array(), yy; for (i = 0; i < 3; i++) { yy = YY + i - 1; if (yy >= -721)ns[i] = this.calc(1457698 - J2000 + int2(0.342 + (yy + 721) * 12.368422) * 29.5306, '朔'), ns[i + 3] = '十三', ns[i + 6] = 2; if (yy >= -479)ns[i] = this.calc(1546083 - J2000 + int2(0.500 + (yy + 479) * 12.368422) * 29.5306, '朔'), ns[i + 3] = '十三', ns[i + 6] = 2; if (yy >= -220)ns[i] = this.calc(1640641 - J2000 + int2(0.866 + (yy + 220) * 12.369000) * 29.5306, '朔'), ns[i + 3] = '后九', ns[i + 6] = 11; } var nn, f1; for (i = 0; i < 14; i++) { for (nn = 2; nn >= 0; nn--)if (this.HS[i] >= ns[nn])break; f1 = int2((this.HS[i] - ns[nn] + 15) / 29.5306); if (f1 < 12)this.ym[i] = obb.ymc[(f1 + ns[nn + 6]) % 12]; else this.ym[i] = ns[nn + 3]; } return; } if (B[13] <= A[24]) { for (i = 1; B[i + 1] > A[2 * i] && i < 13; i++); this.leap = i; for (; i < 14; i++)this.ym[i]--; } for (i = 0; i < 14; i++) { var Dm = this.HS[i] + J2000, v2 = this.ym[i]; var mc = obb.ymc[v2 % 12]; if (Dm >= 1724360 && Dm <= 1729794)mc = obb.ymc[(v2 + 1) % 12]; else if (Dm >= 1807724 && Dm <= 1808699)mc = obb.ymc[(v2 + 1) % 12]; else if (Dm >= 1999349 && Dm <= 1999467)mc = obb.ymc[(v2 + 2) % 12]; else if (Dm >= 1973067 && Dm <= 1977052) { if (v2 % 12 == 0)mc = "正"; if (v2 == 2)mc = '一'; } if (Dm == 1729794 || Dm == 1808699)mc = '拾贰'; this.ym[i] = mc; } } }; SSQ.init(); function Lunar() { var i; this.lun = new Array(); for (i = 0; i < 31; i++)this.lun[i] = new Object(); this.lun.dn = 0; this.substr2 = function (s, n, end) { s = s.
```

--------------------------------

### Initialize Lunar Calendar Grid and Elements

Source: https://github.com/wolfhong/lunarcalendar/blob/master/generate.html

Calculates grid dimensions and initializes graphical elements for the lunar calendar. This includes setting up the main shape path, grid lines, labels, and celestial body markers.

```javascript
int2((this.w - this.x0) / 8.5); dy = this.dy = int2((this.h - this.y0) / 6.5); x0 = this.x0 = int2((this.w - this.dx * 8) / 2); y0 = this.y0 = this.h - int2((this.h - this.dy * 6) / 2); vs = this.vs = this.dx, vx = this.vx = x0 + 4 * dx, vy = this.vy = y0 - 3 * dy, us = this.us = vs / 2; var ditu = 'm 2,212 l 58,180,121,180,128,143,150,129,130,129,99,147,92,171,74,170,42,150,122,104,175,102,230,118,223,124,192,125,215,138,405,92,413,99,411,126,445,117,422,100,590,65,639,76,606,88,724,88,741,101,818,93,942,111,1010,111,1064,126,1045,134,1003,130,1003,146,918,159,896,189,881,189,879,170,926,146,922,142,861,159,793,160,767,176,776,181,793,180,793,213,758,253,740,255,720,270,731,299,714,297,713,282,702,273,689,273,688,263,667,274,673,283,689,283,676,296,689,325,678,353,642,373,604,373,596,387,619,422,598,435,569,417,564,440,594,475,586,479,551,441,554,415,531,400,519,371,459,401,453,433,437,441,390,359,335,353,278,328,273,336,299,361,317,354,340,375,259,420,206,339,187,334,240,427,291,431,269,470,220,511,228,566,163,663,108,672,72,575,85,524,41,453,2,454,2,290,65,286,67,308,193,320,208,292,163,291,158,273,203,260,231,267,234,253,208,229,175,229,161,260,129,282,86,232,74,238,99,265,94,275,54,246,2,272,2,212 ' + 'm 67,54 l 115,46,154,50,155,54,119,58,100,71,67,54 m 300,96 l 321,77,385,68,388,71,315,91,327,101,317,105,300,96 m 522,45 l 547,44,592,58,573,62,550,60,522,45 m 775,75 l 780,82,808,83,818,74,806,72,775,75 ' + 'm 809,180 l 799,188,800,232,811,230,809,180 m 802,238 l 790,256,788,284,748,295,738,310,744,317,754,302,791,301,797,269,816,244,802,238 ' + 'm 686,354 l 681,357,677,365,683,371,686,354 m 544,460 l 583,487,602,515,640,527,597,528,544,460 m 662,452 l 619,482,638,507,646,507,672,484,665,469,673,460,662,452 m 680,480 l 671,513,684,514,703,479,680,480 m 747,492 l 750,504,808,532,846,537,820,507,776,494,747,492 ' + 'm 771,548 l 708,560,641,604,659,675,746,653,790,690,842,689,865,666,868,628,802,541,796,576,767,564,771,548 m 973,672 l 981,693,941,736,952,742,1003,693,973,672 m 282,550 l 257,571,254,619,268,619,289,564,282,550 ' + 'm 1092,112 l 1117,120,1119,126,1091,124,1082,130,1118,134,1091,146,1135,163,1105,176,1107,178,1140,169,1172,151,1255,160,1316,204,1322,278,1425,388,1517,419,1550,449,1579,450,1560,516,1587,566,1620,582,1593,744,1614,786,1644,785,1621,773,1643,745,1634,739,1771,605,1815,536,1815,519,1629,429,1557,442,1543,405,1522,404,1526,377,1486,392,1464,371,1477,332,1546,326,1559,351,1559,320,1618,256,1672,238,1639,204,1685,203,1699,192,1657,162,1582,146,1574,200,1502,169,1483,153,1573,108,1607,115,1607,126,1582,134,1644,145,1667,119,1559,96,1558,75,1666,31,1593,27,1334,68,1329,109,1259,112,1142,101,1092,112 ' + 'm 1680,39 l 1617,62,1634,77,1684,75,1734,110,1721,121,1744,151,1774,156,1788,131,1890,101,1864,88,1897,88,1906,54,1947,36,1927,36,1862,49,1892,37,1831,41,1836,33,1900,28,1833,22,1750,39,1680,39 m 1889,122 l 1884,136,1914,138,1933,130,1889,122 ' + 'm 1969,175 l 1959,182,1958,198,1979,192,1980,179,1969,175 m 1987,162 l 1980,172,1995,182,1976,203,2010,201,2010,180,1996,173,2002,166,1987,162 m 2010,208 l 1989,215,2001,222,2001,247,1961,249,1962,287,1999,285,2010,273,2010,208 m 2010,297 l 1980,297,1918,361,1916,415,1943,452,1970,466,2010,456,2010,297 ' + 'e'; var p = ht.shape(ditu), p2; p.stroked = false; p.fillcolor = '#D0D0D0'; p.setzbx('2009,970', this.dx * 8, this.dy * 6); p.moveto(this.x0, this.h - this.y0); p = ht.shape(''); for (i = 0; i <= 6; i++) { c = y0 - i * dy; p.p_moveto(x0, c); p.p_lineto(x0 + dx * 8, c); if (i) { p2 = ht.textbox(x0 + 2, c, 45, 15, '<b>' + 15 * i + '</b>(' + (i > 3 ? '+' : '') + 30 * (i - 3) + ')'); p2.filled = false; p2.stroked = false; } } for (i = 0; i <= 8; i++) { c = x0 + i * dx; p.p_moveto(c, y0); p.p_lineto(c, y0 - dy * 6); if (i > 0 && i < 8) { p2 = ht.textbox(c - 10, y0, 60, 35, '<b>' + 30 * (i - 4) + '</b><br>(' + (i <= 4 ? 45 * i : 45 * i - 360) + ')'); p2.filled = false; p2.stroked = false; } } p.p_save(); this.Sun = ht.oval(0, 0, vs, vs); this.Sun.moveto2(vx, vy); this.Sun.stroked = false; this.Moon = ht.oval(0, 0, vs, vs); this.Moon.moveto2(vx, vy); this.Moon.stroked = false; this.Moon.fillcolor = '#a0a000'; this.Eys = ht.oval(0, 0, vs, vs); this.Eys.moveto2(vx, vy); this.Eys.stroked = false; this.Eys.fillcolor = '#000000'; this.Eys.setopa(0.2); this.eys = ht.oval(0, 0, vs, vs); this.eys.moveto2(vx, vy); this.eys.stroked = false; this.eys.fillcolor = '#000000'; this.eys.setopa(0.4); this.sun = ht.oval(0, 0, 7, 7); this.sun.moveto2(vx, vy); this.sun.stroked = false; this.moon = ht.oval(0, 0, 7, 7); this.moon.moveto2(vx, vy); this.moon.stroked = false; this.moon.fillcolor = '#B0A070'; for (i = 0; i < this.diming.length; i += 3) { var J = this.diming[i]; if (J < 0)J += 360; var W = this.diming[i + 1]; J = J / 45, W = W / 30 + 3; J = this.x0 + this.dx * J - 5; W = this.y0 - this.dy * W - 8; p = ht.textbox(J, W, 60, 16, '<font color=red>・</font>' + this.diming[i + 2]); p.filled = false; p.stroked = false; } this.mark = 
```

--------------------------------

### Calculate Solar Terms (Jieqi)

Source: https://context7.com/wolfhong/lunarcalendar/llms.txt

Calculate the 24 solar terms using the ephem library and access their names in multiple languages.

```python
from lunarcalendar.solarterm import (
    solarterms, zh_solarterms,
    LiChun, YuShui, ChunFen, QingMing, LiXia, XiaZhi,
    LiQiu, QiuFen, LiDong, DongZhi, XiaoHan, DaHan
)

# Get specific solar term dates
year = 2024
print(f"Start of Spring (立春): {LiChun(year)}")  # 2024-02-04
print(f"Vernal Equinox (春分): {ChunFen(year)}")  # 2024-03-20
print(f"Clear and Bright (清明): {QingMing(year)}")  # 2024-04-04
print(f"Summer Solstice (夏至): {XiaZhi(year)}")  # 2024-06-21
print(f"Autumnal Equinox (秋分): {QiuFen(year)}")  # 2024-09-22
print(f"Winter Solstice (冬至): {DongZhi(year)}")  # 2024-12-21

# Get solar term names in different languages
print(f"\nSolar term names for Winter Solstice:")
print(f"  English: {DongZhi.get_lang('en')}")  # winter solstice
print(f"  Chinese (Simplified): {DongZhi.get_lang('zh_hans')}")  # 冬至
print(f"  Japanese: {DongZhi.get_lang('ja')}")  # 冬至
print(f"  Korean: {DongZhi.get_lang('ko')}")  # 동지
print(f"  Vietnamese: {DongZhi.get_lang('vi')}")  # Đông chí

# List all 24 solar terms for a year
print(f"\n--- All 24 Solar Terms for {year} ---")
for term in sorted(solarterms, key=lambda t: t(year)):
    print(f"{term.get_lang('zh_hans')} ({term.get_lang('en')}): {term(year)}")
```

--------------------------------

### Perform Chinese Calendar Calculations

Source: https://context7.com/wolfhong/lunarcalendar/llms.txt

Demonstrates date conversion, festival identification, and solar term retrieval for a specific year.

```python
import datetime
from lunarcalendar import Converter, Solar, Lunar, DateNotExist
from lunarcalendar.festival import festivals, ChineseNewYear, MidAutumn, NewYearEve
from lunarcalendar.solarterm import solarterms, QingMing, DongZhi

def get_chinese_calendar_info(year):
    """Get comprehensive Chinese calendar information for a given year."""

    print(f"=== Chinese Calendar Information for {year} ===\n")

    # Major lunar holidays
    print("Major Lunar Holidays:")
    new_year = ChineseNewYear(year)
    new_year_lunar = Converter.Solar2Lunar(Solar.from_date(new_year))
    print(f"  Chinese New Year: {new_year} (Lunar: {new_year_lunar.month}/{new_year_lunar.day})")

    eve = NewYearEve(year)
    print(f"  New Year's Eve: {eve}")

    mid_autumn = MidAutumn(year)
    print(f"  Mid-Autumn Festival: {mid_autumn}")

    # Key solar terms
    print("\nKey Solar Terms:")
    print(f"  Qingming (Tomb Sweeping): {QingMing(year)}")
    print(f"  Winter Solstice: {DongZhi(year)}")

    # Convert a specific date
    print("\nDate Conversion Example:")
    today = datetime.date.today()
    solar = Solar.from_date(today)
    lunar = Converter.Solar2Lunar(solar)
    print(f"  Today ({today}) in Lunar: Year {lunar.year}, Month {lunar.month}, Day {lunar.day}")
    if lunar.isleap:
        print(f"    (This is a leap month!)")

    # Find upcoming festivals
    print(f"\nUpcoming Festivals (from {today}):")
    upcoming = []
    for fest in festivals:
        try:
            date = fest(year)
            if date >= today:
                upcoming.append((date, fest.get_lang('en'), fest.get_lang('zh')))
        except:
            continue

    for date, en_name, zh_name in sorted(upcoming)[:5]:
        print(f"  {date}: {en_name} ({zh_name})")

# Run the example
get_chinese_calendar_info(2024)
```
Tokens:
Raw