TIME

Формат

TIME [< формат >]
< формат >::= [']< символьная строка >[']

Одинарные кавычки используются в случае, если < формат > содержит пробелы.

Допустимые элементы формата:

Элемент формата Описание
YYYY, YYY, YY, Y  Цифра года (2015, 015, 15, 5)
Q  Квартал (от 1 до 4)
MM  Месяц (от 1 до 12)
DDD  День года (от 001 до 366)
DD  День месяца (от 01 до 31)
D  День недели (от 1 до 7)
HH, HH12  Относительный час дня (am, pm)(от 00 до 12)
HH24  Абсолютный час дня (от 00 до 24)
MI  Минуты (от 00 до 59)
SS  Секунды (от 00 до 59)
MS  Миллисекунды (от 00 до 100)
TT  Тикеты (сотые доли секунды) (от 00 до 99)
T  Тикеты (десятые доли секунды) (от 0 до 9)
CEN  Век (столетие) (от 01 до 21)
TH  Тысячелетие (от 1 до 3)
MONTH, Month, month  Полное название месяца
MON, Mon, mon  Сокращенное (три символа) название месяца
DAY, Day, day  Полное название дня недели
DY, Dy, dy  Сокращенное (три символа) название дня недели
MONR  Номер месяца римскими цифрами
CENR  Номер века (столетия) римскими цифрами
ER  Уточнение века (две буквы A.D, P.D)
MID  Уточнение даты (две буквы am, pm)

Разделителями элементов формата могут быть двоеточие, дефис, пробел, точка и прямая/косая черта.

Назначение

Разрешить/запретить выдачу временно́й статистики о выполняемых SQL-запросах.

Описание

Команда TIME управляет режимом отображения временно́й статистики о выполняемых SQL-запросах. Она работает только в строчном режиме отображения информации. Если переключатель режима отображения времени включен (положение вкл.), то inl проводит замер и выдачу информации о времени начала и конца выполнения запроса (с точностью до секунды), например,

INL: начальное время : 16.08.42 конечное время :16.08.43

Для подсчета времени используется локальное время, установленное в компьютере (в операционной системе), на котором выполняется inl. Под замером времени следует понимать, что inl фиксирует время передачи запроса на выполнение и время получения первой записи выборки данных на этот запрос.

Если переключатель времени выключен (положение выкл.), то замер и, соответственно, выдача показаний времени обработки запроса не происходит.

Команда TIME без < формата > работает как циклический двоичный переключатель, т.е. каждое выполнение TIME отменяет текущий режим отображения и устанавливает противоположный. Установленный режим сохраняется до конца работы inl.

Сразу после запуска inl переключатель режима отображения времени по умолчанию установлен в положение вкл.

Вызов команды TIME с < форматом > устанавливает режим отображения даты в установленном формате в положение вкл. (независимо от текущего режима). Если < формат > является некорректным, то выдается диагностическое сообщение «Неверное значение» и состояние режима не меняется.

Для просмотра текущего состояния переключателя режима отображения времени используется команда LIST.

Примечание

Результаты выполнения команды TIME всегда выводятся на экран видеотерминала, т.е. в выходной файл, создаваемый по команде OUTFIL, они не попадают. Однако, если inl запущена с командой перенаправления вывода (например, inl  > out.txt), то в этом случае результаты выполнения TIME будут помещены в указанный файл.

Примеры

  1. …
    SQL >list
             --Текущие установки INL--
    time      :вкл.
    …
    SQL >select count (*) from auto
    1 >where color in ('YELLOW','GREEN','BLACK');
    INL: начальное время : 10.55.58 конечное время :10.55.58
    |      367|
    INL : выдано строк  :1
    SQL >time
    SQL >list
             --Текущие установки INL--
    time      :выкл.
    …
  2. SQL >select count (*) from auto
    1 >where color in ('YELLOW','GREEN','BLACK');
    |      367|
    INL : выдано строк  :1
    SQL >
  3. time 'DD-MM-YYYY Q'
    16-01-2015 1
    time 'DD-MM-YY HH'
    16-01-2015 03
    time 'DD-MM-YY HH CEN'
    16-01-2015 03 21
    time 'DD-MONTH-YY HH:MM:SS'
    16-YANUARY-15 03:01:10
    time 'DD-MONR-YYYY'
    16-I-2015
    time 'DD-MM-YYYY CENR'
    16-01-2015 XXI
    time 'DD-MM-YYYY CENR MID'
    16-01-2015 XXI pm
    time 'DD-MM-YYYY ER'
    16-01-2015 A.D.