CAL(1) Dienstprogramme für Benutzer CAL(1)

cal - einen Kalender anzeigen

ÜBERSICHT

cal [Optionen] [[[Tag] Monat] Jahr]

cal [Optionen] [Zeitstempel|Monatsname]

cal zeigt einen einfachen Kalender an. Falls keine Argumente angegeben werden, wird der aktuelle Monat angezeigt.

Der Monat kann als Zahl (1-12), als Monatsname oder als abgekürzter Monatsname entsprechend der aktuellen Locale angegeben werden.

Zwei unterschiedliche Kalendersysteme werden verwendet, der Gregorianische und der Julianische Kalender. Diese sind nahezu identisch, wobei der Gregorianische Kalender eine kleine Anpassung der Häufigkeit der Schaltjahre vornimmt. Dadurch wird die Synchronisation mit Sonnenereignissen wie Äquinoktien (Tagundnachtgleichen) verbessert. Die Gregorianische Kalenderreform fand im Jahr 1582 statt, aber ihre Umsetzung dauerte bis zum Jahr 1923. Standardmäßig verwendet cal das Umstellungsdatum 3. September 1752. Von diesem Tag an wird der Gregorianische Kalender angezeigt, davor das Julianische Kalendersystem. Am Tag der Umstellung wurden 11 Tage übergangen, um das Kalendersystem mit sonnenbezogenen Ereignissen in Einklang zu bringen. Daher ist der September 1752 eine Mischung aus Gregorianischen und Julianischen Daten, wobei der 14. auf den 2. folgt (der 3. bis 13. fehlen).

Optional können entweder der proleptische Gregorianische oder der Julianische Kalender exklusiv verwendet werden. Siehe --reform unten.

-1, --one

zeigt einen einzelnen Monat an (dies ist die Vorgabe).

-3, --three

zeigt drei Monate an, wobei sich das Datum im mittleren Monat befindet.

-n , --months Anzahl

zeigt die Anzahl Monate an, wobei sich das Datum im mittleren Monat befindet.

-S, --span

zeigt den Monat an, in dem sich das Datum befindet.

-s, --sunday

zeigt Sonntag als den ersten Wochentag an.

-m, --monday

zeigt Montag als den ersten Wochentag an.

-v, --vertical

zeigt in einer vertikalen Anordnung an (ncal(1)-Modus).

--iso

zeigt den proleptischen Gregorianischen Kalender exklusiv an. Diese Option wirkt sich nicht auf Wochennummern und den ersten Tag der Woche aus. Siehe --reform unten.

-j, --julian

verwendet die Tagnummerierung für alle Kalender. Diese werden auch Ordinaltage genannt. Solche Ordinaltage liegen im Bereich von 1 bis 366. Diese Option wechselt nicht vom Gregorianischen zum Julianischen Kalendersystem, das durch die Option --reform gesteuert wird.

Gelegentlich werden Gregorianische Kalender, die Ordinaldaten verwenden, als Julianische Kalender angesehen. Dies kann verwirrend sein, da viele datumsbezogene Konventionen »Julianisch« in ihren Namen verwenden: (ordinales) Julianisches Datum, Julianisches (Kalender-)Datum, und mehr. Diese Option wird Julianisch genannt, weil Ordinaltage vom POSIX-Standard als Julianisch bezeichnet werden. Denken Sie jedoch daran, dass cal auch das Julianische Kalendersystem verwendet. Siehe BESCHREIBUNG oben.

--reform Wert

gibt das Umstellungsdatum der Gregorianischen Kalenderreform an. Die Kalenderdaten vor der Reform verwenden das Julianische System. Die Kalenderdaten nach der Reform verwenden das Gregorianische System. Das Argument Wert kann Folgendes sein:
•1752 - setzt den 3. September 1752 als das Umstellungsdatum (Standard). Dies ist der Tag, an dem der Gregorianische Kalender im Britischen Weltreich eingeführt wurde.
•gregorian - zeigt Gregorianische Kalender exklusiv an. Dieser spezielle Platzhalter setzt das Umstellungsdatum nach das Jahr mit der niedrigsten Zahl, die cal verwenden kann. Das bedeutet, dass sämtliche Kalenderausgaben das Gregorianische Kalendersystem verwenden. Dieser wird der proleptische Gregorianische Kalender genannt, weil die Daten vor der Erstellung des Kalendersystems näherungsweise bestimmt werden.
•iso - Alias für gregorian. Der ISO-8601-Standard für die Darstellung von Daten und Zeiten im Informationsaustausch verwendet den proleptischen Gregorianischen Kalender.
•julian - zeigt Julianische Kalender exklusiv an. Dieser spezielle Platzhalter setzt das Umstellungsdatum nach das Jahr mit der höchsten Zahl, die cal verwenden kann. Das bedeutet, dass sämtliche Kalenderausgaben das Julianische Kalendersystem verwenden.

Siehe BESCHREIBUNG oben.

-y, --year

zeigt einen Kalender für das ganze Jahr an.

-Y, --twelve

zeigt einen Kalender für die nächsten zwölf Monate an.

-w, --week[=number]

Display week numbers in the calendar according to the US or ISO-8601 format. If a number is specified, the requested week will be printed in the desired or current year. The number may be overwritten if day and month are also specified.

See the NOTES section for more details.

--color[=when]

stellt die Ausgabe farbig dar. Das optionale Argument wann kann auto, never oder always sein. Falls wann nicht angegeben ist, ist auto die Voreinstellung. Die Farben können deaktiviert werden. Die jeweilige einkompilierte Voreinstellung zeigt Ihnen die Option --help an. Siehe auch den Abschnitt FARBEN.

-c, --columns=Spalten

gibt die Anzahl der zu verwendenden Spalten an. auto bedeutet, dass die maximal möglichen Spalten im Terminal verwendet werden.

-h, --help

zeigt einen Hilfetext an und beendet das Programm.

-V, --version

Display version and exit.

Einzelner, aus Ziffern bestehender Parameter (z.B. »cal 2020«)

gibt das anzuzeigende Jahr an. Beachten Sie, dass das Jahr vollständig bezeichnet werden muss: cal 89 zeigt keinen Kalender für das Jahr 1989 an!

Aus einer einzelnen Zeichenkette bestehender Parameter (z.B. »cal tomorrow« oder »cal August«)

gibt einen Zeitstempel oder einen Monatsnamen (oder abgekürzten Namen) entsprechend der aktuellen Locale an.

Die speziellen Platzhalter werden beim Auswerten von Zeitstempeln akzeptiert, »now« kann zur Angabe der aktuellen Zeit verwendet werden, »today«, »yesterday« und »tomorrow« für den aktuellen Tag, den gestrigen Tag beziehungsweise den morgigen Tag.

Relative Datumsangaben werden ebenfalls akzeptiert. In diesem Fall wird mit »+« die angegebene Zeitspanne zur aktuellen Zeit addiert. Analog dazu wird mit »-« die angegebene Zeitdauer von der aktuellen Zeit subtrahiert, zum Beispiel »+2days«. Anstatt der Zeitdauer ein »+« oder »-« voranzustellen, können Sie auch ein Leerzeichen und das Wort »left« oder »ago« anhängen (zum Beispiel »1 week ago«).

Zwei Parameter (z.B. »cal 11 2020«)

bezeichnen den Monat (1-12) und das Jahr.

Drei Parameter (z.B. »cal 25 11 2020«)

bezeichnen den Tag (1-31), den Monat und das Jahr. Der Tag wird hervorgehoben, falls der Kalender in einem Terminal angezeigt wird. Ohne Parameter wird der Kalender für den aktuellen Monat angezeigt.

Ein Jahr beginnt mit dem ersten Januar. Der erste Wochentag wird anhand der Spracheinstellung oder den Optionen --sunday und --monday ermittelt.

Die Nummerierung der Wochen hängt von der Auswahl des ersten Tages der Woche ab. Falls Sonntag der erste Wochentag ist, dann wird die nordamerikanische Nummerierung verwendet, das heißt, der 1. Januar befindet sich in der Woche 1. Falls Montag ausgewählt ist (-m), dann wird die in ISO-8601 standardisierte Wochennummerierung verwendet, wonach sich der erste Donnerstag des Jahres stets in Woche 1 befindet.

Die farbige Darstellung der Ausgabe wird über die Funktionen in terminal-colors.d(5) gesteuert. Die implizierte Einfärbung kann deaktiviert werden, indem Sie folgende (leere) Datei anlegen:

/etc/terminal-colors.d/cal.disable

für den Befehl cal oder für alle Befehle mit

/etc/terminal-colors.d/disable

Since version 2.41, the $NO_COLOR environment variable is also supported to disable output colorization unless explicitly enabled by a command-line option.

Die benutzerspezifischen Dateien $XDG_CONFIG_HOME/terminal−colors.d oder $HOME/.config/terminal−colors.d setzen die globale Einstellung außer Kraft.

Beachten Sie, dass die Einfärbung der Ausgabe standardmäßig aktiviert sein könnte und in diesem Fall die terminal-colors.d-Verzeichnisse noch nicht zwangsläufig vorhanden sein müssen.

Folgende logische Farbnamen werden von cal unterstützt:

today

Der aktuelle Tag.

weeknumber

The week number requested by the --week=<number> command line option.

weeks

Die Nummer der Woche.

header

Die Überschrift (der Name) eines Monats.

workday

Tage innerhalb der Arbeitswoche.

weekend

Tage außerhalb der Arbeitswoche.

Zum Beispiel:

echo -e 'weekend 35\ntoday 1;41\nheader yellow' > $HOME/.config/terminal-colors.d/cal.scheme

Ein cal-Befehl erschien in Version 6 von AT&T UNIX.

Die standardmäßige Ausgabe von cal verwendet den 3. September 1752 als Umstellungsdatum zum Gregorianischen Kalender. Die historischen Umstellungsdaten für andere Locales sind nicht implementiert, auch nicht für die Ersteinführung im Oktober 1582.

Alternative Kalender, wie Umm al-Qura, Solar Hijri, the Ge’ez, oder Lunisolar Hindu werden nicht unterstützt.

terminal-colors.d(5)

For bug reports, use the issue tracker https://github.com/util-linux/util-linux/issues.

Der Befehl cal ist Teil des Pakets util-linux, welches aus dem Linux-Kernel-Archiv https://www.kernel.org/pub/linux/utils/util-linux/ heruntergeladen werden kann.

2025-03-29 util-linux 2.41