Konwersja typów
***************
.[perex]
Nette Database automatycznie konwertuje wartości zwracane z bazy danych na odpowiadające im typy PHP.
Data i czas
-----------
Wartości czasowe konwertowane są na obiekty `Nette\Utils\DateTime`. Jeśli chcesz, żeby wartości czasowe były konwertowane na niezmienne obiekty `Nette\Database\DateTime`, ustaw w [konfiguracji |configuration] opcję `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');
```
W przypadku MySQL typ danych `TIME` konwertowany jest na obiekty `DateInterval`.
Wartości logiczne
-----------------
Wartości logiczne są automatycznie konwertowane na `true` albo `false`. Dla MySQL konwertowany jest `TINYINT(1)`, jeśli ustawimy w [konfiguracji |configuration] `convertBoolean`.
```php
$row = $database->fetch('SELECT is_published FROM articles');
echo gettype($row->is_published); // 'boolean'
```
Wartości liczbowe
-----------------
Wartości liczbowe konwertowane są na `int` albo `float` zgodnie z typem kolumny w bazie danych:
```php
$row = $database->fetch('SELECT id, price FROM products');
echo gettype($row->id); // integer
echo gettype($row->price); // float
```
Własna normalizacja
-------------------
Metodą `setRowNormalizer(?callable $normalizer)` możesz ustawić własną funkcję przekształcającą wiersze z bazy danych. Przydaje się to na przykład do automatycznej konwersji typów danych.
```php
$database->setRowNormalizer(function(array $row, ResultSet $resultSet): array {
// tutaj odbywa się konwersja typów
return $row;
});
```
Konwersja typów
Nette Database automatycznie konwertuje wartości zwracane z bazy danych na odpowiadające im typy PHP.
Data i czas
Wartości czasowe konwertowane są na obiekty Nette\Utils\DateTime. Jeśli chcesz, żeby wartości czasowe były
konwertowane na niezmienne obiekty Nette\Database\DateTime, ustaw w konfiguracji opcję 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');
W przypadku MySQL typ danych TIME konwertowany jest na obiekty DateInterval.
Wartości logiczne
Wartości logiczne są automatycznie konwertowane na true albo false. Dla MySQL konwertowany jest
TINYINT(1), jeśli ustawimy w konfiguracji
convertBoolean.
$row = $database->fetch('SELECT is_published FROM articles');
echo gettype($row->is_published); // 'boolean'
Wartości liczbowe
Wartości liczbowe konwertowane są na int albo float zgodnie z typem kolumny w bazie danych:
$row = $database->fetch('SELECT id, price FROM products');
echo gettype($row->id); // integer
echo gettype($row->price); // float
Własna normalizacja
Metodą setRowNormalizer(?callable $normalizer) możesz ustawić własną funkcję przekształcającą wiersze
z bazy danych. Przydaje się to na przykład do automatycznej konwersji typów danych.
$database->setRowNormalizer(function(array $row, ResultSet $resultSet): array {
// tutaj odbywa się konwersja typów
return $row;
});