Konverze typů
*************
.[perex]
Nette Database automaticky konvertuje hodnoty vrácené z databáze na odpovídající PHP typy.
Datum a čas
-----------
Časové údaje jsou převáděny na objekty `Nette\Utils\DateTime`. Pokud chcete, aby byly časové údaje převáděny na immutable objekty `Nette\Database\DateTime`, nastavte v [konfiguraci|configuration] volbu `newDateTime` na 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');
```
V případě MySQL se datový typ `TIME` převádí na objekty `DateInterval`.
Booleovské hodnoty
------------------
Booleovské hodnoty jsou automaticky převedeny na `true` nebo `false`. U MySQL se `TINYINT(1)` převádí, pokud v [konfiguraci|configuration] nastavíme `convertBoolean`.
```php
$row = $database->fetch('SELECT is_published FROM articles');
echo gettype($row->is_published); // 'boolean'
```
Číselné hodnoty
---------------
Číselné hodnoty jsou převedeny na `int` nebo `float` podle typu sloupce v databázi:
```php
$row = $database->fetch('SELECT id, price FROM products');
echo gettype($row->id); // integer
echo gettype($row->price); // float
```
Vlastní normalizace
-------------------
Pomocí metody `setRowNormalizer(?callable $normalizer)` můžete nastavit vlastní funkci pro transformaci řádků z databáze. To se hodí například pro automatický převod datových typů.
```php
$database->setRowNormalizer(function(array $row, ResultSet $resultSet): array {
// tady proběhne konverze typů
return $row;
});
```
{{maintitle: Konverze typů v Nette Database: z databáze do PHP}}
{{description: Nette Database automaticky převádí hodnoty z databáze na typy PHP: celá a desetinná čísla, boolean a objekty DateTime a DateInterval.}}
Konverze typů
Nette Database automaticky konvertuje hodnoty vrácené z databáze na odpovídající PHP typy.
Datum a čas
Časové údaje jsou převáděny na objekty Nette\Utils\DateTime. Pokud chcete, aby byly časové údaje
převáděny na immutable objekty Nette\Database\DateTime, nastavte v konfiguraci volbu newDateTime na true.
$row = $database->fetch('SELECT created_at FROM articles');
echo $row->created_at instanceof DateTime; // true
echo $row->created_at->format('j. n. Y');
V případě MySQL se datový typ TIME převádí na objekty DateInterval.
Booleovské hodnoty
Booleovské hodnoty jsou automaticky převedeny na true nebo false. U MySQL se
TINYINT(1) převádí, pokud v konfiguraci nastavíme
convertBoolean.
$row = $database->fetch('SELECT is_published FROM articles');
echo gettype($row->is_published); // 'boolean'
Číselné hodnoty
Číselné hodnoty jsou převedeny na int nebo float podle typu sloupce v databázi:
$row = $database->fetch('SELECT id, price FROM products');
echo gettype($row->id); // integer
echo gettype($row->price); // float
Vlastní normalizace
Pomocí metody setRowNormalizer(?callable $normalizer) můžete nastavit vlastní funkci pro transformaci řádků
z databáze. To se hodí například pro automatický převod datových typů.
$database->setRowNormalizer(function(array $row, ResultSet $resultSet): array {
// tady proběhne konverze typů
return $row;
});