Nette Documentation Preview

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