Nette Documentation Preview

syntax
型変換
***

.[perex]
Nette Database はデータベースから返された値を、対応する PHP の型に自動的に変換します。


日付と時刻
-----

時刻の値は `Nette\Utils\DateTime` オブジェクトに変換されます。変更できない `Nette\Database\DateTime` オブジェクトに変換させたいなら、[設定 |configuration]で `newDateTime` オプションを 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');
```

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


真偽値
---

真偽値は自動的に `true` か `false` に変換されます。MySQL では、[設定 |configuration]で `convertBoolean` を設定すると `TINYINT(1)` が変換されます。

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


数値
---

数値はデータベースの列の型に応じて `int` か `float` に変換されます。

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


独自の正規化
------

`setRowNormalizer(?callable $normalizer)` メソッドで、データベースから来た行を変換する独自の関数を設定できます。たとえばデータ型の自動変換に役立ちます。

```php
$database->setRowNormalizer(function(array $row, ResultSet $resultSet): array {
	// ここで型変換が行われます
	return $row;
});
```

型変換

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('j. n. Y');

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

真偽値

真偽値は自動的に truefalse に変換されます。MySQL では、設定convertBoolean を設定すると TINYINT(1) が変換されます。

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

数値

数値はデータベースの列の型に応じて intfloat に変換されます。

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