型変換

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 では、設定で convertBoolean を設定すると TINYINT(1) が変換されます。

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