Данные типа даты и времени принимаются практически в любом стандартном формате, включая ISO 8601, SQL-совместимые, традиционные форматы POSTGRES, и другие. Для некоторых форматов порядок следования дня, месяца и года при вводе даты может быть неоднозначным, поэтому предусмотрена возможность указания ожидаемого порядка этих полей. Установите DateStyle параметр в значение MDY для выбора интерпретации «месяц-день-год», DMY для выбора интерпретации «день-месяц-год» или YMD для выбора интерпретации «год-месяц-день».

Digital Q.DataBase более гибко обрабатывает ввод даты и времени, чем того требует SQL стандарт. См. Приложение 8.2 для получения точных правил синтаксического анализа ввода даты/времени и списка распознаваемых текстовых полей, включая названия месяцев, дней недели и часовых поясов.

Помните, что любой литерал даты или времени должен быть заключен в одинарные кавычки, аналогично текстовым строкам. См. Раздел 2.1.1.2.7 для получения дополнительной информации. SQL требует использования следующего синтаксиса

тип [ (p) ] 'value'

где p — необязательный параметр точности, определяющий количество дробных разрядов в поле секунд. Точность может быть указана для time, timestamp, и interval типов и может принимать значения от 0 до 6. Если точность не задана при определении константы, по умолчанию используется точность литерального значения (но не более 6 знаков).

1999-01-08 04:05:06

1999-01-08 04:05:06 -8:00

January 8 04:05:06 1999 PST

TIMESTAMP '2004-10-19 10:23:54'

TIMESTAMP '2004-10-19 10:23:54+02'

TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02'

Для формата вывода типов даты/времени можно установить один из четырех стилей: ISO 8601, SQL (Ingres), традиционный POSTGRES (Unix date формат) или German. По умолчанию используется ISO формат. (В SQL стандарте требуется использование формата ISO 8601. Название данного «SQL» формата вывода является исторически сложившимся.) Таблица 2.5.14 содержит примеры для каждого стиля вывода. Результат вывода date и time типов обычно представляет собой только часть даты или времени в соответствии с приведенными примерами. Однако POSTGRES стиль выводит значения только даты в ISO формате.

В стилях SQL и POSTGRES день располагается перед месяцем, если задан порядок полей DMY; в противном случае месяц располагается перед днем. (См. Раздел 2.5.5.1 информацию о том, как данный параметр также влияет на интерпретацию вводимых значений.) Таблица 2.5.15 приведены примеры.

В стилях ISO стиле часовой пояс всегда отображается как числовое смещение со знаком относительно UTC; при этом положительный знак используется для поясов к востоку от Гринвича. Смещение отображается в формате hh (только часы), если оно составляет целое количество часов, в противном случае в формате hh:mm если оно составляет целое количество минут, в противном случае — hh:mm:ss. (Третий случай невозможен для современных стандартов часовых поясов, но он может встретиться при работе с метками времени, предшествующими принятию стандартизированных часовых поясов.) В других стилях отображения даты часовой пояс указывается в виде буквенной аббревиатуры, если она общепринята в данном поясе. В противном случае он отображается как числовое смещение со знаком в базовом формате ISO 8601 (hh или hhmm).

Стиль представления даты и времени может быть выбран пользователем с помощью SET datestyle команды, DateStyle параметра в postgresql.conf или PGDATESTYLE переменная окружения на сервере или клиенте.

Функция форматирования to_char (см. Раздел 2.6.8) также может использоваться как более гибкий способ форматирования вывода даты и времени.

На часовые пояса и правила их использования влияют политические решения, а не только физическая география Земли. Система часовых поясов во всем мире была в некоторой степени стандартизирована в XX веке, но она по-прежнему подвержена произвольным изменениям, особенно в правилах перехода на летнее время. Digital Q.DataBase использует широко распространенную базу данных часовых поясов IANA (Olson), содержащую информацию об исторических правилах исчисления времени. При указании времени в будущем предполагается, что последние известные правила для данного часового пояса будут действовать неограниченно долго.

Digital Q.DataBase стремится обеспечить совместимость с требованиями SQL стандарта для типичных сценариев использования. Однако в SQL стандарте представлено неоднозначное сочетание типов даты и времени, а также их функциональных возможностей. Две наиболее очевидные проблемы:

Для решения этих трудностей при использовании часовых поясов рекомендуется использовать типы даты/времени, содержащие одновременно и дату, и время. Мы не не рекомендуем использовать тип time with time zone (хотя он и поддерживается Digital Q.DataBase для устаревших приложений и для соответствия SQL стандарту). Digital Q.DataBase предполагает использование вашего локального часового пояса для любого типа, содержащего только дату или время.

Все значения даты и времени с часовыми поясами хранятся во внутреннем представлении в UTC. Они преобразуются в местное время в поясе, заданном TimeZone параметром конфигурации, перед отображением клиенту.

Digital Q.DataBase позволяет указывать часовые пояса в трех различных формах:

Вкратце, разница между сокращениями и полными названиями заключается в следующем: сокращения представляют собой конкретное смещение относительно UTC, тогда как многие полные названия подразумевают местное правило перехода на летнее время и, следовательно, имеют два возможных смещения UTC. Например, 2014-06-04 12:00 America/New_York представляет полдень по местному времени в Нью-Йорке, что для этой конкретной даты соответствовало восточному летнему времени (UTC-4). Таким образом, 2014-06-04 12:00 EDT указывает на тот же самый момент времени. Однако 2014-06-04 12:00 EST указывает на полдень по восточному стандартному времени (UTC-5) независимо от того, действовало ли номинально летнее время в этот день.

Ситуация осложняется тем, что в некоторых юрисдикциях одно и то же сокращение часового пояса использовалось для обозначения разных смещений UTC в разное время; например, в Москве MSK означало UTC+3 в одни годы и UTC+4 в другие. Digital Q.DataBase интерпретирует такие сокращения в соответствии с тем, что они означали (или означали в последний раз) на указанную дату; но, как и в EST примере выше, это не обязательно совпадает с местным гражданским временем на эту дату.

Во всех случаях названия и сокращения часовых поясов распознаются без учета регистра. (Это изменение по сравнению с Digital Q.DataBase версиями до 8.2, в которых регистр учитывался в одних контекстах, но не учитывался в других.)

Ни названия часовых поясов, ни их сокращения не встроены в сервер жестко; они извлекаются из конфигурационных файлов, хранящихся в .../share/timezone/ и .../share/timezonesets/ каталога установки (см. Раздел 8.2.4).

Значение TimeZone параметр конфигурации может быть задан в файле postgresql.conf, или любым из других стандартных способов, описанных в Глава 3.4. Существуют также некоторые специальные способы установки данного значения:

В Digital Q.DataBase также реализован параметр qdb_server_timezone_only. С его помощью фиксируется временная зона на уровне сервера, а временная зона, установленная на стороне клиента, игнорируется. Когда этот параметр установлен в on (значение по умолчанию — off), все вызовы SET TIMEZONE игнорируются без вывода ошибок или предупреждений, а все временные функции используют значение, заданное в параметре TimeZone в файле postgresql.conf.

Пример настройки в postgresql.conf:

timezone = 'W-SU'
qdb_server_timezone_only = on
     

Пример использования:

SET TIMEZONE TO 'Asia/Vladivostok';  -- Будет проигнорировано
SELECT now();  -- Возвращает время в зоне сервера
     

interval значения могут быть записаны с использованием следующего подробного синтаксиса:

[@] количество единица_измерения [количество единица_измерения...] [направление]

где количество представляет собой число (возможно, со знаком); единица_измерения является микросекунда, миллисекунда, секунда, минута, час, день, неделя, месяц, год, декада, век, тысячелетие, либо сокращения или формы множественного числа этих единиц измерения; направление может принимать значение ago или пустое значение. Символ «@» (@) является необязательным элементом. Значения различных единиц неявно суммируются с учетом знака. ago инвертирует все поля. Данный синтаксис также используется для вывода значений типа interval, если IntervalStyle принимает значение postgres_verbose.

Количество дней, часов, минут и секунд может быть указано без явного обозначения единиц измерения. Например, '1 12:59:10' интерпретируется так же, как '1 day 12 hours 59 min 10 sec'. Кроме того, сочетание лет и месяцев может быть указано через дефис; например, '200-10' интерпретируется так же, как '200 years 10 months'. (Эти краткие формы фактически являются единственными допустимыми согласно SQL стандарту и используются для вывода, когда параметр IntervalStyle принимает значение sql_standard.)

Значения интервалов также могут быть записаны как интервалы времени ISO 8601 с использованием либо «формата с обозначениями» из раздела 4.4.3.2 стандарта, либо «альтернативного формата» из раздела 4.4.3.3. Формат с обозначениями выглядит следующим образом:

P количество единица_измерения [ количество единица_измерения ...] [ T [ количество единица_измерения ...]]

Строка должна начинаться с префикса P, а также может содержать символ T , обозначающий начало единиц времени. Доступные сокращения единиц измерения приведены в Таблица 2.5.16. Единицы измерения могут быть опущены и указаны в произвольном порядке, но единицы меньше суток должны следовать после символа T. В частности, интерпретация символа M зависит от того, указан он до или после символа T.

В альтернативном формате:

P [ годы-месяцы-дни ] [ T часы:минуты:секунды ]

строка должна начинаться с P, а символ T разделяет дату и время в значении интервала. Значения указываются в виде чисел, аналогично формату дат ISO 8601.

При записи константы типа interval со поля спецификацией или при присваивании строки столбцу типа interval, определенному со поля спецификации интерпретация величин без указания единиц измерения зависит от поля. Например INTERVAL '1' YEAR интерпретируется как 1 год, тогда как INTERVAL '1' означает 1 секунду. Кроме того, значения полей, «расположенных справа» от наименее значимого поля, допускаемого поля параметром спецификации, неявно отбрасываются. Например, при указании INTERVAL '1 day 2:03:04' HOUR TO MINUTE поле секунд будет отброшено, но поле дней сохранится.

Согласно SQL стандарту все поля значения интервала должны иметь одинаковый знак, поэтому ведущий знак минуса относится ко всем полям; например, знак минус в литерале интервала '-1 2:03:04' относится и к дням, и к частям часов/минут/секунд. Digital Q.DataBase допускает наличие разных знаков у полей и традиционно обрабатывает каждое поле в текстовом представлении как имеющее собственный знак; таким образом, в данном примере часть часов/минут/секунд считается положительной. Если IntervalStyle принимает значение sql_standard в этом случае ведущий знак считается относящимся ко всем полям (но только если отсутствуют дополнительные знаки). В противном случае используется традиционная Digital Q.DataBase используется интерпретация. Во избежание неоднозначности рекомендуется указывать явный знак для каждого поля, если хотя бы одно поле имеет отрицательное значение.

На внутреннем уровне interval значения хранятся в виде трёх целочисленных полей: месяцы, дни и микросекунды. Эти поля хранятся раздельно, так как количество дней в месяце может меняться, а в сутках может быть 23 или 25 часов при переходе на летнее или зимнее время. Строка ввода интервала, в которой используются другие единицы измерения, приводится к данному формату, а затем преобразуется в стандартный вид для вывода, например:

SELECT '2 years 15 months 100 weeks 99 hours 123456789 milliseconds'::interval;
               interval
---------------------------------------
 3 years 3 mons 700 days 133:17:36.789

В данном контексте недели, под которыми подразумеваются «7 дней», хранятся отдельно, в то время как более мелкие и крупные единицы времени были объединены и нормализованы.

Значения полей ввода могут содержать дробные части, например '1.5 weeks' или '01:02:03.45'. Однако, поскольку interval внутренне хранит только целочисленные поля, дробные значения должны быть преобразованы в более мелкие единицы измерения. Дробные части единиц, превышающих месяц, округляются до целого числа месяцев, например '1.5 years' преобразуется в '1 year 6 mons'. Дробные части недель и дней вычисляются как целое число дней и микросекунд из расчета 30 дней в месяце и 24 часов в сутках, например, '1.75 months' преобразуется в 1 mon 22 days 12:00:00. Только секунды могут иметь дробную часть при выводе.

Таблица 2.5.17 приведены некоторые примеры допустимых interval ввод.

Как было пояснено ранее, Digital Q.DataBase сохраняет interval значения в виде месяцев, дней и микросекунд. При выводе значение поля месяцев преобразуется в годы и месяцы путем деления на 12. Значение поля дней отображается без изменений. Значение поля микросекунд преобразуется в часы, минуты, секунды и доли секунды. Таким образом, значения месяцев, минут и секунд никогда не будут выходить за пределы диапазонов 0–11, 0–59 и 0–59 соответственно, тогда как отображаемые значения лет, дней и часов могут быть сколь угодно большими. (Параметр justify_days и justify_hours функции могут использоваться, если желательно преобразовать большие значения дней или часов с переходом в следующее, более старшее поле.)

Формат вывода типа interval можно задать в одном из четырех стилей sql_standard, postgres, postgres_verbose, или iso_8601, с помощью команды SET intervalstyle. По умолчанию используется postgres формат. Таблица 2.5.18 содержит примеры каждого стиля вывода.

Значение sql_standard стиль формирует вывод, соответствующий спецификации стандарта SQL для строковых литералов интервала, если значение интервала отвечает ограничениям стандарта (только «год-месяц» или только «день-время», без смешивания положительных и отрицательных компонентов). В противном случае вывод выглядит как стандартный строковый литерал «год-месяц», за которым следует строковый литерал «день-время» с добавлением явных знаков для устранения неоднозначности в интервалах с разными знаками компонентов.

Вывод в стиле postgres соответствует выводу в Digital Q.DataBase версиях до 8.4, когда DateStyle параметр имел значение ISO.

Вывод в стиле postgres_verbose соответствует выводу в Digital Q.DataBase версиях до 8.4, когда DateStyle параметр был установлен в значение, отличное отISO вывода.

Вывод в стиле iso_8601 стиль соответствует «формату с обозначениями» описанному в разделе 4.4.3.2 стандарта ISO 8601.