Nette Documentation Preview

syntax
Conversión de tipos
*******************

.[perex]
Nette Database convierte automáticamente los valores devueltos por la base de datos a los tipos de PHP correspondientes.


Fecha y hora
------------

Los valores temporales se convierten a objetos `Nette\Utils\DateTime`. Si quiere que se conviertan a objetos inmutables `Nette\Database\DateTime`, active la opción `newDateTime` en la [configuración |configuration].

```php
$row = $database->fetch('SELECT created_at FROM articles');
echo $row->created_at instanceof DateTime; // true
echo $row->created_at->format('j. n. Y');
```

En el caso de MySQL, el tipo de dato `TIME` se convierte a objetos `DateInterval`.


Valores booleanos
-----------------

Los valores booleanos se convierten automáticamente a `true` o `false`. En MySQL se convierte `TINYINT(1)` si activamos `convertBoolean` en la [configuración |configuration].

```php
$row = $database->fetch('SELECT is_published FROM articles');
echo gettype($row->is_published); // 'boolean'
```


Valores numéricos
-----------------

Los valores numéricos se convierten a `int` o `float` según el tipo de la columna en la base de datos:

```php
$row = $database->fetch('SELECT id, price FROM products');
echo gettype($row->id);    // integer
echo gettype($row->price); // float
```


Normalización propia
--------------------

Con el método `setRowNormalizer(?callable $normalizer)` puede establecer una función propia para transformar las filas que llegan de la base de datos. Es útil, por ejemplo, para la conversión automática de tipos de dato.

```php
$database->setRowNormalizer(function(array $row, ResultSet $resultSet): array {
	// aquí ocurre la conversión de tipos
	return $row;
});
```

Conversión de tipos

Nette Database convierte automáticamente los valores devueltos por la base de datos a los tipos de PHP correspondientes.

Fecha y hora

Los valores temporales se convierten a objetos Nette\Utils\DateTime. Si quiere que se conviertan a objetos inmutables Nette\Database\DateTime, active la opción newDateTime en la configuración.

$row = $database->fetch('SELECT created_at FROM articles');
echo $row->created_at instanceof DateTime; // true
echo $row->created_at->format('j. n. Y');

En el caso de MySQL, el tipo de dato TIME se convierte a objetos DateInterval.

Valores booleanos

Los valores booleanos se convierten automáticamente a true o false. En MySQL se convierte TINYINT(1) si activamos convertBoolean en la configuración.

$row = $database->fetch('SELECT is_published FROM articles');
echo gettype($row->is_published); // 'boolean'

Valores numéricos

Los valores numéricos se convierten a int o float según el tipo de la columna en la base de datos:

$row = $database->fetch('SELECT id, price FROM products');
echo gettype($row->id);    // integer
echo gettype($row->price); // float

Normalización propia

Con el método setRowNormalizer(?callable $normalizer) puede establecer una función propia para transformar las filas que llegan de la base de datos. Es útil, por ejemplo, para la conversión automática de tipos de dato.

$database->setRowNormalizer(function(array $row, ResultSet $resultSet): array {
	// aquí ocurre la conversión de tipos
	return $row;
});