Nette Documentation Preview

syntax
Преобразование типов
********************

.[perex]
Nette Database автоматически преобразует значения, возвращаемые из базы данных, в соответствующие типы PHP.


Дата и время
------------

Временные значения преобразуются в объекты `Nette\Utils\DateTime`. Если вы хотите, чтобы временные значения преобразовывались в неизменяемые объекты `Nette\Database\DateTime`, задайте в [конфигурации |configuration] параметру `newDateTime` значение true.

```php
$row = $database->fetch('SELECT created_at FROM articles');
echo $row->created_at instanceof DateTime; // true
echo $row->created_at->format('j. n. Y');
```

В случае MySQL тип данных `TIME` преобразуется в объекты `DateInterval`.


Логические значения
-------------------

Логические значения автоматически преобразуются в `true` или `false`. Для MySQL `TINYINT(1)` преобразуется, если мы зададим `convertBoolean` в [конфигурации |configuration].

```php
$row = $database->fetch('SELECT is_published FROM articles');
echo gettype($row->is_published); // 'boolean'
```


Числовые значения
-----------------

Числовые значения преобразуются в `int` или `float` в соответствии с типом столбца в базе данных:

```php
$row = $database->fetch('SELECT id, price FROM products');
echo gettype($row->id);    // integer
echo gettype($row->price); // float
```


Собственная нормализация
------------------------

Методом `setRowNormalizer(?callable $normalizer)` вы можете задать собственную функцию преобразования записей из базы данных. Это полезно, например, для автоматического преобразования типов данных.

```php
$database->setRowNormalizer(function(array $row, ResultSet $resultSet): array {
	// здесь происходит преобразование типов
	return $row;
});
```

Преобразование типов

Nette Database автоматически преобразует значения, возвращаемые из базы данных, в соответствующие типы PHP.

Дата и время

Временные значения преобразуются в объекты Nette\Utils\DateTime. Если вы хотите, чтобы временные значения преобразовывались в неизменяемые объекты Nette\Database\DateTime, задайте в конфигурации параметру newDateTime значение true.

$row = $database->fetch('SELECT created_at FROM articles');
echo $row->created_at instanceof DateTime; // true
echo $row->created_at->format('j. n. Y');

В случае MySQL тип данных TIME преобразуется в объекты DateInterval.

Логические значения

Логические значения автоматически преобразуются в true или false. Для MySQL TINYINT(1) преобразуется, если мы зададим convertBoolean в конфигурации.

$row = $database->fetch('SELECT is_published FROM articles');
echo gettype($row->is_published); // 'boolean'

Числовые значения

Числовые значения преобразуются в int или float в соответствии с типом столбца в базе данных:

$row = $database->fetch('SELECT id, price FROM products');
echo gettype($row->id);    // integer
echo gettype($row->price); // float

Собственная нормализация

Методом setRowNormalizer(?callable $normalizer) вы можете задать собственную функцию преобразования записей из базы данных. Это полезно, например, для автоматического преобразования типов данных.

$database->setRowNormalizer(function(array $row, ResultSet $resultSet): array {
	// здесь происходит преобразование типов
	return $row;
});