型変換

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('Y年n月j日'); 

MySQLの場合、データ型TIMEはDateIntervalオブジェクトに変換されます。

ブール値

ブール値は自動的にtrueまたはfalseに変換されます。設定でconvertBooleanを設定すると、MySQLでは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; });