CAL(1)

BEZEICHNUNG
cal - einen Kalender anzeigen

ÜBERSICHT

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

cal [Optionen] [Zeitstempel|Monatsname]

BESCHREIBUNG

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.

OPTIONEN

-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[=Nummer]
    zeigt Wochennummern im Kalender gemäß dem US- oder ISO-8601-Format an. Falls eine Nummer angegeben wird, dann wird die angefragte Woche im gewünschten oder aktuellen Jahr ausgegeben und deren Nummer hervorgehoben. Die Nummer kann ignoriert werden, falls der Monat ebenfalls angegeben wird.

    Wenn zwar die Nummer, der aktuelle Tag jedoch nicht in der Befehlszeile angegeben ist, wird der aktuelle Tag nicht hervorgehoben.

    Siehe den Abschnitt ANMERKUNGEN für weitere Details.

--color[=wann]
    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
    zeigt Versionsinformationen an und beendet das Programm.

PARAMETER

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.

ANMERKUNGEN

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.

FARBEN

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

Seit Version 2.41 wird auch die Umgebungsvariable $NO_COLOR unterstützt, um die farbige Darstellung der Ausgabe zu deaktivieren, sofern sie nicht explizit durch eine Befehlszeilenoption aktiviert wird.

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
    Die durch die Befehlszeilenoption --week=<Nummer> angefragte Wochennummer.

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

GESCHICHTE

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

FEHLER

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.

SIEHE AUCH

terminal-colors.d(5)

FEHLER MELDEN

Nutzen Sie zum Melden von Fehlern das

VERFÜGBARKEIT

Der Befehl cal ist Teil des Pakets util-linux, welches aus dem heruntergeladen werden kann.