'\" t
.\"     Title: cal
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-05-18
.\"    Manual: Användarkommandon
.\"    Source: util-linux 2.42.1
.\"  Language: English
.\"
.TH "CAL" "1" "2026-05-18" "util\-linux 2.42.1" "Användarkommandon"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAMN"
cal \- visa en kalender
.SH "SYNOPSIS"
.sp
\fBcal\fP [flaggor] [[[\fIdag\fP] \fImånad\fP] \fIår\fP]
.sp
\fBcal\fP [flaggor] [\fItidsstämpel\fP|\fImånadsnamn\fP]
.SH "BESKRIVNING"
.sp
\fBcal\fP visar en enkel kalender. Om inga argument anges visas den aktuella månaden.
.sp
\fImånad\fP kan anges som ett nummer (1\-12), som ett månadsnamn eller som ett förkortat månadsnamn i enlighet med de aktuella lokala språkversionerna.
.sp
Två olika kalendersystem används, det gregorianska och det julianska. Dessa är nästan identiska system med Gregorianska gör en liten justering av frekvensen av skottår; detta underlättar förbättrad synkronisering med solhändelser som dagjämningar. Den gregorianska kalenderreformen infördes 1582, men den fortsatte att användas ända fram till 1923. Som standard använder \fBcal\fP datumet för införandet, 3 september 1752. Från och med detta datum visas den gregorianska kalendern; tidigare datum använder det julianska kalendersystemet. 11 dagar togs bort vid tidpunkten för antagandet för att få kalendern synkroniserad med solhändelser. Så september 1752 har en blandning av julianska och gregorianska datum där den 2:a följs av den 14:e (den 3:e till och med den 13:e saknas).
.sp
Valfritt kan antingen den proleptiska gregorianska kalendern eller den julianska kalendern användas exklusivt. Se \fB\-\-reform\fP nedan.
.SH "FLAGGOR"
.sp
\fB\-1\fP, \fB\-\-one\fP
.RS 4
Visa utdata för en enskild månad. (Detta är standardinställningen.)
.RE
.sp
\fB\-3\fP, \fB\-\-three\fP
.RS 4
Visar tre månader från datumet.
.RE
.sp
\fB\-n , \-\-months\fP \fInummer\fP
.RS 4
Visa \fIantal\fP månader, med början från den månad som innehåller datumet.
.RE
.sp
\fB\-S, \-\-span\fP
.RS 4
Visa månader som sträcker sig över datumet.
.RE
.sp
\fB\-s\fP, \fB\-\-sunday\fP
.RS 4
Visa söndag som första dag i veckan.
.RE
.sp
\fB\-m\fP, \fB\-\-monday\fP
.RS 4
Visa måndag som första dag i veckan.
.RE
.sp
\fB\-v\fP, \fB\-\-vertical\fP
.RS 4
Visning med vertikal layout (även kallat \fBncal\fP(1)\-läge).
.RE
.sp
\fB\-\-iso\fP
.RS 4
Visar enbart den proleptiska gregorianska kalendern. Denna flagga påverkar inte veckonummer och första dagen i veckan. Se \fB\-\-reform\fP nedan.
.RE
.sp
\fB\-j\fP, \fB\-\-julian\fP
.RS 4
Använd årsdagsnumrering för alla kalendrar. Dessa dagar kallas även för ordinaldagar. Ordinarie dagar sträcker sig från 1 till 366. Den här flaggan innebär inte att man byter från det gregorianska till det julianska kalendersystemet, vilket styrs av flaggan \fB\-\-reform\fP.
.sp
Ibland kallas gregorianska kalendrar som använder ordinala datum för julianska kalendrar. Detta kan vara förvirrande på grund av de många datumrelaterade konventioner som använder julianska i sitt namn: (ordinalt) julianskt datum, julianskt (kalender)datum, (astronomiskt) julianskt datum, (modifierat) julianskt datum, med mera. Den här flaggan heter julian eftersom ordinala dagar identifieras som julian enligt POSIX\-standarden. Du bör dock vara medveten om att \fBcal\fP också använder det julianska kalendersystemet. Se \fBDESCRIPTION\fP ovan.
.RE
.sp
\fB\-\-reform\fP \fIval\fP
.RS 4
Denna flagga anger datumet för införandet av den gregorianska kalenderreformen. Kalenderdatum före reformen använder det julianska kalendersystemet. Kalenderdatum efter reformen använder det gregorianska kalendersystemet. Argumentet \fIval\fP kan vara:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fI1752\fP \- anger den 3 september 1752 som reformdatum (standard). Det var då den gregorianska kalenderreformen antogs av det brittiska imperiet.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIgregorian\fP \- visar enbart gregorianska kalendrar. Denna speciella platshållare sätter reformdatumet under det minsta år som \fBcal\fP kan använda, vilket innebär att all kalenderutmatning använder det gregorianska kalendersystemet. Detta kallas den proleptiska gregorianska kalendern, eftersom datum före kalendersystemets skapande använder extrapolerade värden.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIiso\fP \- alias för \fIgregoriansk\fP. ISO 8601\-standarden för representation av datum och tider i informationsutbyte kräver användning av den proleptiska gregorianska kalendern.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIjulian\fP \- visar endast julianska kalendrar. Denna speciella platshållare sätter reformdatumet över det största år som \fBcal\fP kan använda, vilket innebär att all kalenderutmatning använder det julianska kalendersystemet.
.RE
.sp
Se \fBBESKRIVNING\fP ovan.
.RE
.sp
\fB\-y\fP, \fB\-\-year\fP
.RS 4
Visa en kalender för hela året.
.RE
.sp
\fB\-Y, \-\-twelve\fP
.RS 4
Visa en kalender för de kommande tolv månaderna.
.RE
.sp
\fB\-w\fP, \fB\-\-week\fP[\fB=\fP\fInummer\fP]
.RS 4
Display week numbers in the calendar according to the US or ISO\-8601 format. If a \fInumber\fP is specified, the requested week in the desired or current year will be printed and its number highlighted. The \fInumber\fP may be ignored if \fImonth\fP is also specified.
.sp
If the \fInumber\fP is specified but the current day is unspecified on the command line, then the current day is not highlighted.
.sp
Se avsnittet \fBNOTER\fP för mer information.
.RE
.sp
\fB\-\-color\fP[\fB=\fP\fInär\fP]
.RS 4
Färglägger utdata. Det valfria argumentet \fInär\fP kan vara \fBauto\fP, \fBnever\fP eller \fBalways\fP. Om argumentet \fInär\fP utelämnas är standardvärdet \fBauto\fP. Färgerna kan inaktiveras; för den aktuella inbyggda standardinställningen, se utmatningen \fB\-\-help\fP. Se även avsnittet \fBFÄRGER\fP.
.RE
.sp
\fB\-c, \-\-columns\fP=\fIkolumner\fP
.RS 4
Antal kolumner som ska användas. \fBauto\fP använder så många som ryms i terminalen.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Visa hjälptext och avsluta.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Visa version och avsluta.
.RE
.SH "PARAMETRAR"
.sp
\fBParameter med endast en siffra (t.ex. "cal 2020")\fP
.RS 4
Anger vilket \fIår\fP som ska visas; observera att året måste vara fullständigt angivet: \fBcal 89\fP kommer inte att visa en kalender för 1989.
.RE
.sp
\fBParameter med en sträng (t.ex. "cal tomorrow" eller "cal August")\fP
.RS 4
Anger \fItimestamp\fP eller ett \fImånadsnamn\fP (eller förkortat namn) enligt aktuella lokala inställningar.
.sp
De speciella platshållarna accepteras när tidsstämpel analyseras, "now" kan användas för att hänvisa till aktuell tid, "today", "yesterday", "tomorrow" hänvisar till den aktuella dagen, dagen innan eller nästa dag, respektive.
.sp
De relativa datumspecifikationerna accepteras också, i detta fall utvärderas "+" till aktuell tid plus det angivna tidsintervallet. På motsvarande sätt utvärderas ett tidsintervall som inleds med "\-" till den aktuella tiden minus det angivna tidsintervallet, t.ex. "+2dagar". I stället för att föregå tidsspannet med "+" eller "\-" kan det också föregås av ett mellanslag och ordet "left" eller "ago" (t.ex. "1 week ago").
.RE
.sp
\fBTvå parametrar (t.ex. "cal 11 2020")\fP
.RS 4
Ange \fImånad\fP (1 \- 12) och \fIår\fP.
.RE
.sp
\fBTre parametrar (t.ex. "cal 25 11 2020")\fP
.RS 4
Ange \fIdag\fP (1\-31), \fImånad och år\fP, och dagen kommer att markeras om kalendern visas på en terminal. Om inga parametrar anges visas kalendern för innevarande månad.
.RE
.SH "ANTECKNINGAR"
.sp
Ett år börjar den 1 januari. Veckans första dag bestäms av lokalen eller flaggorna \fB\-\-sunday\fP och \fB\-\-monday\fP.
.sp
Veckonumreringen beror på valet av veckans första dag. Om det är söndag används den vanliga nordamerikanska numreringen, där 1 januari är i vecka nummer 1. Om det är måndag (\fB\-m\fP) används standardveckonumreringen enligt ISO 8601, där den första torsdagen är i vecka 1.
.SH "FÄRGER"
.sp
Färgläggningen av utdata implementeras av \fBterminal\-colors.d\fP(5) funktionalitet. Implicit färgläggning kan inaktiveras med en tom fil
.RS 3
.ll -.6i
.sp
\fI/etc/terminal\-colors.d/cal.disable\fP
.br
.RE
.ll
.sp
för kommandot \fBcal\fP eller för alla verktyg med
.RS 3
.ll -.6i
.sp
\fI/etc/terminal\-colors.d/disable\fP
.br
.RE
.ll
.sp
Sedan version 2.41 stöds även miljövariabeln $NO_COLOR som inaktiverar färgläggning av utdata om den inte uttryckligen aktiveras med en kommandoradsflagga.
.sp
Den användarspecifika \fI$XDG_CONFIG_HOME/terminal\-colors.d\fP eller \fI$HOME/.config/terminal\-colors.d\fP åsidosätter den globala inställningen.
.sp
Observera att färgläggningen av utdata kan vara aktiverad som standard, och i så fall behöver inte \fIterminal\-colors.d\fP\-katalogerna finnas ännu.
.sp
De logiska färgnamn som stöds av \fBcal\fP är:
.sp
\fBidag\fP
.RS 4
Den aktuella dagen.
.RE
.sp
\fBweeknumber\fP
.RS 4
Det veckonummer som begärs med kommandoradsflaggan \-\-week=<nummer>.
.RE
.sp
\fBweeks\fP
.RS 4
Veckans nummer.
.RE
.sp
\fBheader\fP
.RS 4
Rubriken för en månad.
.RE
.sp
\fBworkday\fP
.RS 4
Dagar som faller inom arbetsveckan.
.RE
.sp
\fBweekend\fP
.RS 4
Dagar som infaller utanför arbetsveckan.
.RE
.sp
Till exempel:
.RS 3
.ll -.6i
.sp
echo \-e \*(Aqweekend 35\(rsntoday 1;41\(rsnheader yellow\*(Aq > $HOME/.config/terminal\-colors.d/cal.scheme
.br
.RE
.ll
.SH "HISTORIK"
.sp
Ett \fBcal\fP\-kommando dök upp i version 6 AT&T UNIX.
.SH "KÄNDA PROBLEM"
.sp
Standardutmatningen \fBcal\fP använder den 3 september 1752 som reformdatum för den gregorianska kalendern. De historiska reformdatumen för de andra lokaliteterna, inklusive dess införande i oktober 1582, implementeras inte.
.sp
Alternativa kalendrar, såsom Umm al\-Qura, Solar Hijri, Ge\(cqez eller lunisolar Hindu, stöds inte.
.SH "SE ÄVEN"
.sp
\fBterminal\-colors.d\fP(5)
.SH "FELRAPPORTERING"
.sp
För felrapporter, använd \c
.URL "https://github.com/util\-linux/util\-linux/issues" "felhanteraren" "."
.SH "TILLGÄNGLIGHET"
.sp
Kommandot \fBcal\fP ingår i paketet util\-linux som kan hämtas från \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."