# item.getDateFormatted()

### Получить форматированную дату по названию поля

```JavaScript
item.getDateFormatted(string $fieldName, string $toFormat = 'Y-m-d H:i:s', string|null $toTimeZone = null, string|null $fromTimeZone = null)
```

##### Описание:

Возвращает значение даты измененного формата из запрашиваемого поля.

##### Атрибуты:

<table border="1" id="bkmrk-%D0%98%D0%BC%D1%8F-%D0%A2%D0%B8%D0%BF-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-fie" style="border-collapse: collapse; width: 100%; height: 305.719px;"><tbody><tr style="background-color: #ced4d9; height: 29.7969px;"><td style="width: 33.2909%; height: 29.7969px;">Имя</td><td style="width: 33.2909%; height: 29.7969px;">Тип</td><td style="width: 33.2948%; height: 29.7969px;">Описание</td></tr><tr style="height: 46.5938px;"><td style="width: 33.2909%; height: 46.5938px;">fieldName</td><td style="width: 33.2909%; height: 46.5938px;">string</td><td style="width: 33.2948%; height: 46.5938px;">Наименование поля из которого будет браться значение</td></tr><tr style="height: 169.734px;"><td style="width: 33.2909%; height: 169.734px;">toFormat</td><td style="width: 33.2909%; height: 169.734px;">string</td><td style="width: 33.2948%; height: 169.734px;">Формат даты, например: 'Y-m-d H:i:s' (Y - год;

 m - месяц;

 d - день;

 H - часы;

 i - минуты;

 s - секунды.)

</td></tr><tr style="height: 29.7969px;"><td style="width: 33.2909%; height: 29.7969px;">toTimeZone</td><td style="width: 33.2909%; height: 29.7969px;">string|null</td><td style="width: 33.2948%; height: 29.7969px;">Часовой пояс в ответе</td></tr><tr style="height: 29.7969px;"><td style="width: 33.2909%; height: 29.7969px;">fromTimeZone</td><td style="width: 33.2909%; height: 29.7969px;">string|null</td><td style="width: 33.2948%; height: 29.7969px;">Часовой пояс в запросе</td></tr></tbody></table>

##### Возвращает:

**string** -

или

**null** - если дата не требует форматирования.

##### Пример:

Возвращает значение даты измененного формата из поля **create**:

```JavaScript
var date = item.getDateFormatted('create', 'd-m-Y H:i:s', 'Y-m-d H', 'UTC', '+3');
```