Ccal

---
name: ccal
description: Chinese Calendar with Lunar-Solar Conversion
---

## Data

### Location

```
$___X_CMD_ROOT_DATA/ccal/data/
├── ccal-data-v0.0.6.tar.xz      # Main archive (stream-read, not extracted)
└── v0.0.6/cache/                # Pre-extracted index (after first run)
    ├── year.tsv                  # Year index
    └── month.tsv                 # Month index
```

### Download

- **URL**: https://codeberg.org/x-cmd/ccal-data/releases/download/v0.0.6/ccal-data.tar.xz
- **Trigger**: First run or `x ccal lunar update`

## Archive Contents

```
ccal-data/
├── index/
│   ├── year.tsv      # Year index
│   └── month.tsv     # Month index
└── lunar/
    └── {year}_{month}.tsv   # Monthly data (e.g., 2026_03.tsv)
```

## Direct Read (No Extraction)

Use `x zuz cat <archive> <path>` to stream-read from archive:

```bash
DATA="$___X_CMD_ROOT_DATA/ccal/data/ccal-data-v0.0.6.tar.xz"

# Read year index
x zuz cat "$DATA" ccal-data/index/year.tsv

# Read month index
x zuz cat "$DATA" ccal-data/index/month.tsv

# Read specific month: 2026 March
x zuz cat "$DATA" ccal-data/lunar/2026_03.tsv

# Read all months of 2026
x zuz cat "$DATA" ccal-data/lunar/2026_*.tsv
```

## Cached Read (After First Run)

```bash
CACHE="$___X_CMD_ROOT_DATA/ccal/data/v0.0.6/cache"

# Use cached index if available
[ -f "$CACHE/year.tsv" ] && cat "$CACHE/year.tsv"
```

## Reference

- `lib/awk/lunar.awk` - Lunar calendar computation
- `lib/awk/gongli.awk` - Gregorian calendar computation
- `lib/awk/ccal.awk` - Main calendar logic