Calendar Grid

Calendar Grid is a LaTeX3 package for deterministic, presentation-neutral month and year grids. It computes proleptic Gregorian dates with integer arithmetic, so the same date calculations are used by pdfLaTeX, XeLaTeX, and LuaLaTeX.

Features

• Fixed six-week or compact month grids, with any of the seven weekdays as the first column.
• Adjacent-month dates or empty overflow cells.
• Twelve-month year overviews with one to four columns.
• Per-date notes and named, inclusive date ranges, including ranges crossing month and year boundaries.
• Configurable month and weekday labels, cell dimensions, and formatting hooks.
• No graphics package, external font, shell escape, network access, or external program is needed.

Quick example

\documentclass{article}
\usepackage{calendar-grid}

\begin{document}
\CalendarGrid[
  year=2027,
  month=1,
  week-start=monday,
  layout=fixed,
  overflow=adjacent
]
\end{document}

Register notes and inclusive ranges before the grid command:

\CalendarGridEvent{2027-01-15}{Project review}
\CalendarGridRange[style=sprint]{2027-01-11}{2027-01-22}
\CalendarGrid[year=2027,month=1]

The \CalendarGridFormatDay hook receives the ISO date, day number, whether the date belongs to the requested month, weekday number (Monday = 1), weekend flag, row, column, event text, and a comma-separated list of active range style names. The default marks current-month weekend and range dates in bold, prints event text in a small size, and prints adjacent dates in italics. Redefine the hook to apply a document-specific visual style.

Installation

Copy calendar-grid.sty to a directory searched by TeX, or install the package through a TeX distribution when it becomes available there. The package depends only on the standard array package.

Documentation

See calendar-grid-doc.pdf for the user guide and calendar-grid-doc.tex for its source. Runnable examples are named calendar-grid-example-*.tex.

Compatibility

The package targets LaTeX formats dated 2020-10-01 or later and is designed for pdfLaTeX, XeLaTeX, and LuaLaTeX. Date inputs use the exact YYYY-MM-DD form and Gregorian civil years 0001 through 9999. ISO week numbers are intentionally not included in version 1.0.0.

Development

Run l3build check for regression tests and l3build doc to build the guide. The test configuration covers pdfTeX, XeTeX, and LuaTeX. See CHANGELOG.md for implemented release contents.

License

Copyright (C) 2026 Mateo Pedersen. This work may be distributed and/or modified under the conditions of the LaTeX Project Public License, version 1.3c or (at your option) any later version. The license is available at https://www.latex-project.org/lppl/lppl-1-3c.txt. LPPL maintenance status: maintained. The current maintainer is Mateo Pedersen.

Maintainer

Mateo Pedersen, Beta Calendars. Package issues and support are handled through the GitHub issue tracker.

Project

Calendar Grid is maintained as part of the Beta Calendars developer tooling project. See Beta Calendars.