'\" t
.\"     Title: cal
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-03-29
.\"    Manual: Команди користувача
.\"    Source: util-linux 2.41
.\"  Language: English
.\"
.TH "CAL" "1" "2025-03-29" "util\-linux 2.41" "Команди користувача"
.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 "НАЗВА"
cal \- вивести календар
.SH "КОРОТКИЙ ОПИС"
.sp
\fBcal\fP [параметри] [[[\fIдень\fP] \fIмісяць\fP] \fIрік\fP]
.sp
\fBcal\fP [параметри] [\fIчасова позначка\fP|\fIназва місяця\fP]
.SH "ОПИС"
.sp
\fBcal\fP виводить простий календар. Якщо не вказано аргументів, буде показано календар на поточний місяць.
.sp
Аргумент \fIмісяць\fP можна задати як число (1\-12), як назву місяця або як скорочену назву місяця, відповідно до поточних локалей.
.sp
Використано дві різні календарні системи, григоріанську та юліанську. Ці системи майже ідентичні, але у григоріанській системі внесено невеличке коригування щодо частоти високосних років; це забезпечує кращу синхронізацію із рухом Сонця на небі, зокрема рівноденнями. Григоріанську реформу календаря було запроваджено у 1582 році, але, загалом, вона тривала до 1923 року. Типово, у \fBcal\fP використано дату впровадження 3 вересня 1752 року. Починаючи з цієї дати, буде показано дати у григоріанському календарі; попередні дати буде показано у юліанській календарній системі. На момент впровадження реформи було вилучено 11 днів для збереження синхронізації календаря із рухом Сонця. Тому вересень 1752 року є сумішшю юліанських та григоріанських дат, у якій після другого числа йде одразу 14 (чисел від третього до тринадцятого просто немає).
.sp
Якщо потрібно, можна скористатися випереджальним григоріанським календарем або лише юліанським календарем. Див. \fB\-\-reform\fP нижче.
.SH "ПАРАМЕТРИ"
.sp
\fB\-1\fP, \fB\-\-one\fP
.RS 4
Показати виведеним один місяць. (Типова поведінка.)
.RE
.sp
\fB\-3\fP, \fB\-\-three\fP
.RS 4
Показати дані для попереднього, поточного і наступного місяця.
.RE
.sp
\fB\-n , \-\-months\fP \fIчисло\fP
.RS 4
Показати вказане \fIчисло\fP місяців, починаючи з місяця, у якому міститься дата.
.RE
.sp
\fB\-S, \-\-span\fP
.RS 4
Показати дані місяців навколо дати.
.RE
.sp
\fB\-s\fP, \fB\-\-sunday\fP
.RS 4
Показувати неділю, як перший день тижня.
.RE
.sp
\fB\-m\fP, \fB\-\-monday\fP
.RS 4
Показувати понеділок як перший день тижня.
.RE
.sp
\fB\-v\fP, \fB\-\-vertical\fP
.RS 4
Вивести з використанням вертикального компонування (тобто режим \fBncal\fP(1)).
.RE
.sp
\fB\-\-iso\fP
.RS 4
Показувати усі дати лише у григоріанському календарі. Цей параметр не впливає на номери тижнів і перший день тижня. Див. \fB\-\-reform\fP нижче.
.RE
.sp
\fB\-j\fP, \fB\-\-julian\fP
.RS 4
Використовувати нумерацію дня року для усіх календарів. Номери називаються порядковими днями. Порядкові дні є числами у діапазоні від 1 до 366. Цей параметр не перемикає дати з григоріанської на юліанську календарну систему \- цим керує параметр \fB\-\-reform\fP.
.sp
Іноді григоріанські календарі, де використано порядкові дати, називають юліанськими календарями. Це може заплутати, оскільки існує багато традиційних типових назв, де використано слово «юліанська» у назві: (порядкова) юліанська дата, юліанська (календарна) дата, (астрономічна) юліанська дата, (змінена) юліанська дата тощо. Цей параметр має назву «julian», оскільки порядкові дати визначаються як юліанські стандартом POSIX. Втім, майте на увазі, що \fBcal\fP також використовує юліанську календарну систему. Див. \fBОПИС\fP вище.
.RE
.sp
\fB\-\-reform\fP \fIзнач\fP
.RS 4
Цей параметр встановлює дату впровадження григоріанської календарної реформи. Календарні дати до дати реформи обчислюються за юліанською календарною системою. Для календарних дат після дати реформи буде використано григоріанську календарну систему. Аргументом \fIзнач\fP можуть бути такі записи:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fI1752\fP \- дата реформи 3 вересня 1752 року (типове значення). Це дата впровадження григоріанського календаря у Британській імперії.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIgregorian\fP \- показувати лише григоріанські календарі. Це особливий замінник, який встановлює дату реформації до найменшого року, який може бути використано у \fBcal\fP; це означатиме, що усі виведені календарі будуть григоріанськими. Це називають випереджальним григоріанським календарем, оскільки дати до створення календарної системи будуть екстрапольованими.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIiso\fP \- інший варіант \fIgregorian\fP. Стандарт ISO 8601 для представлення дати і часу при обміні даними вимагає використання випереджального григоріанського календаря.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIjulian\fP \- показувати лише юліанські календарі. Цей особливий замінник встановлює дату реформи, яка перевищує найбільший рік, календар за який може показувати \fBcal\fP; це означає, що при виведенні будь\-яких календарів буде використано юліанську календарну систему.
.sp
Див. \fBОПИС\fP вище.
.RE
.RE
.sp
\fB\-y\fP, \fB\-\-year\fP
.RS 4
Показати календар на цілий рік.
.RE
.sp
\fB\-Y, \-\-twelve\fP
.RS 4
Показати календар на наступні дванадцять місяців.
.RE
.sp
\fB\-w\fP, \fB\-\-week\fP[\fB=\fP\fIчисло\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 will be printed in the desired or current year. The \fInumber\fP may be overwritten if \fIday\fP and \fImonth\fP are also specified.
.sp
See the \fBNOTES\fP section for more details.
.RE
.sp
\fB\-\-color\fP[\fB=\fP\fIумова\fP]
.RS 4
Розфарбувати виведені дані. Значенням додаткового аргументу \fIваріант\fP може бути \fBauto\fP, \fBnever\fP або \fBalways\fP. Якщо аргумент \fIваріант\fP пропущено, типовим значенням вважається \fBauto\fP. Розфарбовування можна вимкнути. Із поточним вбудованим типовим значенням можна ознайомитися за допомогою виведення команди з параметром \fB\-\-help\fP. Див. також розділ КОЛЬОРИ.
.RE
.sp
\fB\-c, \-\-columns\fP=\fIстовпчики\fP
.RS 4
Number of columns to use. \fBauto\fP uses as many as fit the terminal.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Вивести текст довідки і завершити роботу.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Показати дані щодо версії і завершити роботу.
.RE
.SH "ПАРАМЕТРИ"
.sp
\fBОдинарний цифровий параметр (наприклад, \*(Aqcal 2020\*(Aq)\fP
.RS 4
Задає \fIрік\fP, який має бути показано; зауважте, що рік має бути вказано повністю: \fBcal 89\fP не покаже календар на 1989 рік.
.RE
.sp
\fBОдинарний рядковий параметр (наприклад, \*(Aqcal завтра\*(Aq або \*(Aqcal серпень\*(Aq)\fP
.RS 4
Задає \fIчасову позначку\fP або \fIназву місяця\fP (або скорочену назву) відповідно до поточних локалей.
.sp
Передбачено обробку спеціальних замінників під час обробки часової позначки, замінником «зараз» можна скористатися для посилання на поточний момент часу, замінники «сьогодні», «вчора», «завтра» позначають поточний день, попередній день та наступний день, відповідно.
.sp
Також можна визначати відносні дати. У випадку визначення відносної дати «+» означатиме поточну дату разом із вказаним часовим проміжком. Відповідно, часовий проміжок із префіксом «\-» означатиме поточний час без вказаного проміжку часу. Приклад: «+2days». Замість префіксів «+» або «\-» для часових проміжків можна використовувати суфікси і пробілом і словами «left» або «ago» (приклад: «1 week ago»).
.RE
.sp
\fBДва параметри (наприклад, \*(Aqcal 11 2020\*(Aq)\fP
.RS 4
Визначити \fIмісяць\fP (1 \- 12) і \fIрік\fP.
.RE
.sp
\fBТри параметри (наприклад, \*(Aqcal 25 11 2020\*(Aq)\fP
.RS 4
Визначають \fIдень\fP (1\-31), \fIмісяць\fP і \fIрік\fP. День буде позначено, якщо календар показано у терміналі. Якщо параметрів не задано, буде показано календар на поточний місяць.
.RE
.SH "ЗАУВАЖЕННЯ"
.sp
Рік починається з першого січня. Перший день тижня визначається локаллю або параметрами \fB\-\-sunday\fP і \fB\-\-monday\fP.
.sp
Нумерація тижнів залежить від вибору першого дня тижня. Якщо це неділя, буде використано типову північноамериканську нумерацію, де 1 січня міститься у першому тижні. Якщо першим днем тижня є понеділок (\fB\-m\fP), буде використано стандартну нумерацію тижнів ISO 8601, де перший четвер міститься у першому тижні.
.SH "КОЛЬОРИ"
.sp
Розфарбовування виведених даних реалізовано у можливості \fBterminal\-colors.d\fP(5). Неявне розфарбовування може бути вимкнено спорожненням файла
.RS 3
.ll -.6i
.sp
\fI/etc/terminal\-colors.d/{команда}.disable\fP
.br
.RE
.ll
.sp
для команди \fB{команда}\fP або для усіх інструментів
.RS 3
.ll -.6i
.sp
\fI/etc/terminal\-colors.d/disable\fP
.br
.RE
.ll
.sp
Since version 2.41, the $NO_COLOR environment variable is also supported to disable output colorization unless explicitly enabled by a command\-line option.
.sp
Специфічні для користувача \fI$XDG_CONFIG_HOME/terminal\-colors.d\fP або \fI$HOME/.config/terminal\-colors.d\fP мають пріоритет над загальними параметрами.
.sp
Зауважте, що можна типово увімкнути розфарбовування виведених даних і у цьому випадку каталоги \fIterminal\-colors.d\fP не повинні існувати.
.sp
Логічними назвами кольорів, підтримку яких передбачено у \fBcal\fP, є такі:
.sp
\fBtoday\fP
.RS 4
Поточний день.
.RE
.sp
\fBweeknumber\fP
.RS 4
The week number requested by the \-\-week=<number> command line option.
.RE
.sp
\fBweeks\fP
.RS 4
Номер тижня.
.RE
.sp
\fBheader\fP
.RS 4
Заголовок місяця.
.RE
.sp
\fBworkday\fP
.RS 4
Дні, які є частиною робочого тижня.
.RE
.sp
\fBweekend\fP
.RS 4
Дні, які не є частиною робочого тижня.
.RE
.sp
Приклад:
.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 "ЖУРНАЛ"
.sp
Команда \fBcal\fP з\(cqявилася у версії 6 AT&T UNIX.
.SH "ВАДИ"
.sp
Типовий \fBcal\fP виводить дати, використовуючи 3 вересня 1752 року як дату григоріанської календарної реформи. Використання історичних дат реформації для інших локалей, включно із датою впровадження реформи у жовтні 1582 року, не реалізовано.
.sp
Підтримки альтернативних календарів, зокрема Умм аль\-Кура, сонячної хіджри, ґеез або місячно\-сонячного індуїстського, не передбачено.
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.sp
\fBterminal\-colors.d\fP(5)
.SH "ЯК НАДІСЛАТИ ЗВІТ ПРО ВАДИ"
.sp
Для звітування щодо вад скористайтеся \c
.URL "https://github.com/util\-linux/util\-linux/issues" "системою стеження за вадами" ""
.SH "ДОСТУП ДО ПРОГРАМИ"
.sp
Програма \fBcal\fP є частиною пакунка util\-linux, який можна отримати з \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "архіву ядра Linux" "."