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

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;
});