# SqlHelper::formatDate()

URL: https://chugunov.pro/api-bitrix/main/db/sqlhelper/formatdate/
Проверено на 1С-Битрикс 25.x, обновлено 03.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией 1С-Битрикс.

Класс: [`\Bitrix\Main\DB\SqlHelper`](https://chugunov.pro/api-bitrix/main/db/sqlhelper/)
Модуль: Main.
Свойства элемента: method, public, abstract.

## Сигнатура

```php
public abstract formatDate(string $format[, string $field = null ]) : string
```

## Описание

Преобразуются следующие части формата:
- YYYY Полное числовое представление года, 4 цифры
- MMMM Полное текстовое представление месяца, например January или March
- MM Числовое представление месяца, с ведущими нулями
- MI Минуты с ведущими нулями
- M Краткое текстовое представление месяца, три буквы
- DD День месяца, 2 цифры с ведущими нулями
- HH 24-часовой формат часа с ведущими нулями
- H 24-часовой формат часа без ведущих нулей
- GG 12-часовой формат часа с ведущими нулями
- G 12-часовой формат часа без ведущих нулей
- SS Секунды с ведущими нулями
- TT AM или PM
- T AM или PM
- W День недели (0=воскресенье ... 6=суббота)

Параметр $field небезопасен для SQL.

## Параметры

- `$format` `string` — обязательный. Строка формата.
- `$field` `string` — необязательный, по умолчанию `null`. Поле базы данных или выражение.

## Возвращаемое значение

`string`

Оригинал в официальной документации: https://docs.1c-bitrix.ru/api/classes/Bitrix-Main-DB-SqlHelper.html