PostgreSQL функция to_char

В этом учебном пособии вы узнаете, как использовать функцию to_char PostgreSQL с синтаксисом и примерами

Описание

Функция PostgreSQL to_char преобразует число или дату в строку.

Синтаксис

Синтаксис функции to_char в PostgreSQL:

to_char( value, format_mask )

Параметры или аргументы

value
Число, дата, которая будет преобразована в строку.
format_mask
Формат, который будет использоваться для преобразования value в строку. format_mask отличается от того, конвертируете ли вы числа или даты. Давайте взглянем.

С числами

С числами format_mask может быть одним из следующих и может использоваться во многих комбинациях:

Параметр Пояснение
9 Значение (без начальных нулей)
0 Значение (с ведущими нулями)
. Десятичный
, Разделитель групп
PR Отрицательное значение в угловых скобках
С Знак
L Символ валюты
D Десятичный
G Разделитель групп
MI Знак минус (для отрицательных чисел)
PL Знак плюс (для положительных чисел)
SG Знак плюс/минус (для положительных и отрицательных чисел)
RN Римские цифры
TH Суффикс порядкового номера
th Суффикс порядкового номера
V Сдвиг цифр
EEEE Научная нотация

С датами

С датами format_mask может быть одним из следующих и может использоваться во многих комбинациях.

Параметр Пояснение
YYYY 4-значный год
Y,YYY 4-значный год с запятой
YYY

  YY

  Y

Последние 3, 2 или 1 цифра (и) года
IYYY 4-значный год в соответствии со стандартом ISO
IYY

  IY

  I

Последние 3, 2 или 1 цифра(ы) года ISO
Q Квартал года (1, 2, 3, 4; JAN-MAR = 1).
ММ Месяц (01-12; JAN = 01).
MON Сокращенное название месяца в верхнем регистре
Mon Сокращенное название месяца с заглавной буквы
mon Сокращенное название месяца в нижнем регистре
MONTH Название месяца заглавными буквами, дополненное пробелами длиной до 9 символов
Month Название месяца с заглавной буквы, дополненное пробелами длиной до 9 символов
month Название месяца строчными буквами, дополненное пробелами длиной до 9 символов
RM Месяц прописными римскими цифрами
rm Месяц строчными римскими цифрами
WW Неделя года (1-53), где неделя 1 начинается в первый день года
W Неделя месяца (1-5), где неделя 1 начинается в первый день месяца
IW Неделя года (01-53) по стандарту ISO
DAY Название дня заглавными буквами, дополненное пробелами длиной до 9 символов
Day Название дня с заглавной буквы, дополненное пробелами длиной до 9 символов
day Название дня строчными буквами, дополненное пробелами длиной до 9 символов
DY Сокращенное название дня в верхнем регистре
Dy Сокращенное название дня с заглавной буквы
dy Сокращенное название дня строчными буквами
DDD День года (1-366)
IDDD День года на основе года ISO
DD День месяца (01-31)
D День недели (1-7, где 1 = воскресенье, 7 = суббота)
ID День недели на основе года ISO (1-7, где 1 = понедельник, 7 = воскресенье)
J Юлианский день; количество дней с полуночи 24 ноября 4714 г. до н.э.
HH Час дня (01-12)
HH12 Час дня (01-12)
HH24 Час дня (00-23)
MI Минута (00-59)
SS Секунда(00-59)
MS Миллисекунда (000-999)
US Микросекунда (000000-999999)
SSSS Секунды после полуночи (0-86399)
am, AM, pm, or PM Индикатор меридиана
a.m., A.M., p.m., or P.M. Индикатор меридиана
ad, AD, a.d., or A.D Индикатор AD
bc, BC, b.c., or B.C. Индикатор BC
TZ Название часового пояса в верхнем регистре
tz Название часового пояса в нижнем регистре
CC 2-значный век


Применение

Функция to_char может использоваться в следующих версиях PostgreSQL:

  • PostgreSQL 11, PostgreSQL 10, PostgreSQL 9.6, PostgreSQL 9.5, PostgreSQL 9.4, PostgreSQL 9.3, PostgreSQL 9.2, PostgreSQL 9.1, PostgreSQL 9.0, PostgreSQL 8.4

Пример

Рассмотрим некоторые примеры функций to_char, чтобы понять, как использовать функцию to_char в PostgreSQL.

Пример с чмслами

Например:
Ниже приведены числовые примеры функции to_char.

Пример с датами

Ниже приведены примеры дат функции to_char.