282 lines
9.3 KiB
HTML
282 lines
9.3 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<title>clock</title>
|
||
</head>
|
||
|
||
<body>
|
||
<h1>clock</h1>
|
||
|
||
<p>С помощью команды <strong>clock</strong> можно получить и преобразовать
|
||
значение времени.</p>
|
||
|
||
<pre>
|
||
<strong>clock</strong> <em>option</em> ?<em>arg</em> <em>arg</em>...?
|
||
</pre>
|
||
|
||
<h2>ОПИСАНИЕ</h2>
|
||
|
||
<p> Команда выполняет одно из перечисленных ниже действий, с
|
||
помощью которых можно получить и преобразовать строки или
|
||
значения, являющиеся той или иной формой записи времени.
|
||
Параметр <em>option</em> определяет выполняемое командой действие,
|
||
одно из следующего списка (параметр может быть сокращен):
|
||
<dl>
|
||
<dt><strong>clock</strong> <strong>clicks</strong></dt>
|
||
|
||
<dd> Возвращает целое число, с высокой точностью представляющее
|
||
машинное время. Единица измерения зависит от операционной
|
||
системы и компьютера и представляет собой минимальную
|
||
доступную величину, например, счетчик циклов процессора. Эта
|
||
величина может использоваться только для относительного
|
||
измерения пройденного времени.
|
||
</dd>
|
||
|
||
<dt><strong>clock</strong> <strong>format</strong> <em>clockValue</em> ?<em>-format</em>
|
||
<em>string</em>? ?<em>-gmt</em> <em>boolean</em>?</dt>
|
||
|
||
<dd><p>Переводит целое число, возвращаемое командами <strong>clock
|
||
seconds</strong>, <strong>clock scan</strong> или командами <a href=
|
||
"file.html#atime"><strong>file atime</strong></a>, <a href=
|
||
"file.html#mtime"><strong>file mtime</strong></a> и <strong>file
|
||
ctime</strong> в удобочитаемую форму. Если в команде
|
||
присутствует аргумент <em>-format</em>, следующий аргумент
|
||
должен быть строкой, описывающей формат представления
|
||
времени. Строка состоит из описаний полей, состоящих из
|
||
символа <strong>%</strong> и буквы. Все остальные символы в строке
|
||
просто копируются в результат. Ниже перечислены допустимые
|
||
описания полей.</p>
|
||
<table>
|
||
<tbody>
|
||
<tr>
|
||
<td><strong>%%</strong></td>
|
||
<td>вставляет %</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%a</strong></td>
|
||
<td>сокращенное название дня недели (Mon, Tue, etc.).</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%A</strong></td>
|
||
<td>полное название дня недели (Monday, Tuesday, etc.).</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%b</strong></td>
|
||
<td>сокращенное название месяца (Jan, Feb, etc.).</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%B</strong></td>
|
||
<td>полное название месяца.</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%c</strong></td>
|
||
<td>локальные дата и время.</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%d</strong></td>
|
||
<td>день месяца (01 - 31).</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%H</strong></td>
|
||
<td>часы в двадцатичетырехчасовом формате (00 - 23).</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%I</strong></td>
|
||
<td>часы в двенадцатичасовом формате (00 - 12).</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%j</strong></td>
|
||
<td>день года (001 - 366).</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%m</strong></td>
|
||
<td>номер месяца (01 - 12).</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%M</strong></td>
|
||
<td>минуты (00 - 59).</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%p</strong></td>
|
||
<td>AM/PM индикатор (до/после полудня).</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%S</strong></td>
|
||
<td>секунды (00 - 59).</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%U</strong></td>
|
||
<td>неделя года (01 - 52), Воскресенье - первый день
|
||
недели.</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%w</strong></td>
|
||
<td>номер дня недели (Воскресенье = 0).</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%W</strong></td>
|
||
<td>неделя года (01 - 52), Понедельник первый день
|
||
недели.</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%x</strong></td>
|
||
<td>локальный формат даты.</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%X</strong></td>
|
||
<td>локальный формат времени.</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%y</strong></td>
|
||
<td>год без столетия (00 - 99).</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%Y</strong></td>
|
||
<td>год со столетием (например, 1990)</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%Z</strong></td>
|
||
<td>имя часового пояса.</td>
|
||
</tr>
|
||
<tr>
|
||
<td colspan="2">Кроме того, в некоторых операционных
|
||
системах могут поддерживаться</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%D</strong></td>
|
||
<td>дата в формате %m/%d/%y.</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%e</strong></td>
|
||
<td>день месяца (1 - 31), без нулей впереди.</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%h</strong></td>
|
||
<td>сокращенное имя месяца.</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%n</strong></td>
|
||
<td>новая строка.</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%r</strong></td>
|
||
<td>время в формате %I:%M:%S %p.</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%R</strong></td>
|
||
<td>время в формате %H:%M.</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%t</strong></td>
|
||
<td>табуляция.</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>%T</strong></td>
|
||
<td>время в формате %H:%M:%S.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
<p>Если аргумент <strong>-format</strong> не задан, используется
|
||
формат <strong>%a %b %d %H:%M:%S %Z %Y</strong>. Если задан аргумент
|
||
<em>-gmt</em>, следующий аргумент должен быть булевой
|
||
величиной. Значение true означает, что используется время по
|
||
Гринвичу, значение false означает, что используется время по
|
||
локальному часовому поясу, который задан для операционной
|
||
системы.</p>
|
||
</dd>
|
||
|
||
|
||
<dt><a name="scan"></a><strong>clock</strong> <strong>scan</strong>
|
||
<em>dateString</em> ?<em>-base</em> <em>clockVal</em>? ?<em>-gmt</em>
|
||
<em>boolean</em>?</dt>
|
||
|
||
<dd><p>Переводит дату <em>dateString</em> в целое число (см. <a
|
||
href="#seconds"><strong>clock seconds</strong></a>).
|
||
Команда может перевести в число любую стандартную строку,
|
||
содержащую время и/или дату, включая название часового
|
||
пояса. Если строка содержит только время, предполагается
|
||
текущая дата. Если название часового пояса не указано,
|
||
предполагается локальный часовой пояс (если значение опции
|
||
<em>-gmt</em> не равно true. В этом случае предполагается, что
|
||
время задано по Гринвичу).</p>
|
||
|
||
<p>Если в команде указан флаг <em>-base</em>, следующий аргумент
|
||
должен содержать время в виде целого числа. По этому числу
|
||
определяется дата и используется вместо указанной в строке
|
||
или текущей. Такая возможность полезна при необходимости
|
||
перевести в целое число время на заданную дату.</p>
|
||
|
||
<p>Аргумент <em>dateString</em> должен состоять из одной или
|
||
более спецификаций следующих видов:</p>
|
||
|
||
<table>
|
||
<tbody>
|
||
<tr>
|
||
<td><em>time</em></td>
|
||
|
||
<td>Время суток в форме: <em>hh?:mm?:ss??</em>
|
||
?<em>meridian</em>? ?<em>zone</em>? или в форме
|
||
<em>hhmm?meridian?</em> ?<em>zone</em>?, где
|
||
<em>meridian</em> - индикатор AM или PM, <em>zone</em> -
|
||
имя часового пояса. Если индикатор <em>meridian</em> не
|
||
определен, <em>hh</em> считается числом часов в
|
||
двадцатичетырехчасовом формате.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><em>date</em></td>
|
||
|
||
<td> Месяц, день и, возможно, год. Допустимые форматы
|
||
<em>mm/dd?/yy?</em>, <em>monthname dd?</em>, <em>yy?</em>,
|
||
<em>dd monthname?yy?</em> и <em>day</em>, <em>dd monthname
|
||
yy</em>. По умолчанию год считается текущим годом. Если
|
||
год меньше 100, то года 00-38 считаются годами в
|
||
диапазоне 2000-2038, а года 70-99 считаются годами в
|
||
диапазоне 1970-1999. Года 39-70 могут быть
|
||
недопустимыми на некоторых платформах. Для тех
|
||
платформ, для которых они определены, они считаются
|
||
годами в диапазоне 1939-1999.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td> <em>relative time</em></td>
|
||
|
||
<td>Время относительно текущего момента. Формат - число
|
||
единица измерения. Возможные единицы измерения
|
||
<strong>year</strong>, <strong>fortnight</strong>, <strong>month</strong>,
|
||
<strong>week</strong>, <strong>day</strong>, <strong>hour</strong>,
|
||
<strong>minute</strong>(или <strong>min</strong>), и <strong>second</strong> (или
|
||
<strong>sec</strong>). Единицы измерения могут указываться во
|
||
множественном числе, например 3 weeks. Кроме того,
|
||
могут использоваться модификаторы: <strong>tomorrow</strong>,
|
||
<strong>yesterday</strong>, <strong>today</strong>, <strong>now</strong>,
|
||
<strong>last</strong>, <strong>this</strong>, <strong> next</strong>, <strong>ago</strong>.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
<p>Реальная дата вычисляется в следующей последовательности.
|
||
Сначала определяется абсолютная дата и/или время, которые
|
||
переводятся в целое число. Это число используется как базис,
|
||
к которому добавляется заданный день недели. Далее
|
||
используется относительное время. Если задана дата, а время
|
||
(абсолютное или относительное) отсутствует, считается, что
|
||
это полночь. И последним шагом производится коррекция
|
||
вычисленной даты, при которой учитываются летнее время и
|
||
число дней в различных месяцах.</p>
|
||
</dd>
|
||
|
||
<dt><a name="seconds"></a><strong>clock seconds</strong></dt>
|
||
|
||
<dd> Возвращает время в секундах от начала
|
||
"эпохи". Может использоваться для вычисления
|
||
разности времен. "Эпоха" зависит от используемой
|
||
операционной системы и компьютера.
|
||
</dd>
|
||
</dl>
|
||
</body>
|
||
</html>
|