Функции форматирования дат

Функции strftime и strptime могут использоваться для преобразования значений DATE / TIMESTAMP в строки и обратно. Это часто требуется при парсинге CSV-файлов, отображении результатов пользователю или передаче информации между программами. Поскольку существует множество возможных представлений дат, эти функции принимают строку формата, описывающую структуру даты или временной метки.

strftime Примеры

Функция strftime(timestamp, format) преобразует временные метки или даты в строки в соответствии с заданным шаблоном.

SELECT strftime(DATE '1992-03-02', '%d/%m/%Y');

02/03/1992

SELECT strftime(TIMESTAMP '1992-03-02 20:32:45', '%A, %-d %B %Y - %I:%M:%S %p');

Monday, 2 March 1992 - 08:32:45 PM

strptime Примеры

Функция strptime(text, format) преобразует строки во временные метки в соответствии с заданным шаблоном.

SELECT strptime('02/03/1992', '%d/%m/%Y');

1992-03-02 00:00:00

SELECT strptime('Monday, 2 March 1992 - 08:32:45 PM', '%A, %-d %B %Y - %I:%M:%S %p');

1992-03-02 20:32:45

Функция strptime выдает ошибку при неудачном преобразовании:

SELECT strptime('02/50/1992', '%d/%m/%Y') AS x;

Invalid Input Error: Could not parse string "02/50/1992" according to format specifier "%d/%m/%Y"
02/50/1992
   ^
Error: Month out of range, expected a value between 1 and 12

Чтобы вернуть NULL при неудаче, используйте функцию try_strptime:

NULL

Парсинг CSV

Форматы дат также можно указать при парсинге CSV, как в операторе COPY, так и в функции read_csv. Это можно сделать, указав DATEFORMAT или TIMESTAMPFORMAT (или оба). DATEFORMAT будет использоваться для преобразования дат, а TIMESTAMPFORMAT — для преобразования временных меток. Ниже приведены примеры использования.

В операторе COPY:

COPY dates FROM 'test.csv' (DATEFORMAT '%d/%m/%Y', TIMESTAMPFORMAT '%A, %-d %B %Y - %I:%M:%S %p');

В функции read_csv:

SELECT *
FROM read_csv('test.csv', dateformat = '%m/%d/%Y');

Спецификаторы формата

Ниже приведен полный список всех доступных спецификаторов формата.