Spec-Zone.ru › CakePHP 3.8

Класс TimeType

Конвертер типов времени.

Используется для преобразования экземпляров времени в строки и обратно.

Cake\Database\Type implements Cake\Database\TypeInterface
Расширенный Cake\Database\Type\DateTimeType implements Cake\Database\TypeInterface, Cake\Database\Type\BatchCastingInterface
Расширенный Cake\Database\Type\TimeType
Пространство имен: Cake\Database\Type
Расположение: Database/Type/TimeType.php

Резюме свойств

  • $_format protected
    string|array
    Формат времени для объекта DateTime

Унаследованные свойства

  • _className, _datetimeInstance, _localeFormat, _name, _useLocaleParser, dateTimeClass, dbTimezone, setToDateStart _basicTypes, _builtTypes, _types

Резюме методов

  • _parseValue() protected

    Преобразует строку в объект DateTime после её разбора с помощью локально-ориентированного парсера с указанным форматом.

Подробное описание методов

_parseValue()source protected

_parseValue( string $value )

Преобразует строку в объект DateTime после её разбора с помощью локально-ориентированного парсера с указанным форматом.

Параметры

строка $value
Значение для разбора и преобразования в объект.

Возвращаемое значение

Cake\I18n\Time|null

Переопределяет

Cake\Database\Type\DateTimeType::_parseValue()

Методы, унаследованные от Cake\Database\Type\DateTimeType

__construct()source public

__construct( string|null $name = null )

Конструктор

Параметры

строка|null $name необязательно null
Имя, идентифицирующее этот тип

Переопределяет

Cake\Database\Type::__construct()

_compare()source protected

_compare( Cake\I18n\Time|DateTime $date , mixed $value )

Параметры

Cake\I18n\Time|DateTime $date
Объект DateTime
смешанное $value
Данные запроса

Возвращаемое значение

boolean

_setClassName()source protected

_setClassName( string $class , string $fallback )

Установить имя класса для создания объектов.

Параметры

строка $class
Имя класса для использования.
строка $fallback
Имя класса для использования, если предпочтительный класс отсутствует.

getDateTimeClassName()source public

getDateTimeClassName( )

Получить имя класса, используемого для создания объектов.

Возвращаемое значение

строка

manyToPHP()source public

manyToPHP( array $values , array $fields , Cake\Database\Driver $driver )

Возвращает массив значений, преобразованных в представление этого типа в PHP.

Параметры

массив $values
Исходный массив значений, содержащий поля, которые нужно преобразовать
массив $fields
Ключи полей для преобразования
Cake\Database\Driver $driver
Объект, из которого будут извлечены настройки и конфигурация базы данных.

Возвращаемое значение

массив

Реализация

Cake\Database\Type\BatchCastingInterface::manyToPHP()

marshal()source public

marshal( mixed $value )

Преобразует данные запроса в объект datetime.

Параметры

смешанное $value
Данные запроса

Возвращаемое значение

DateTimeInterface|null

Переопределяет

Cake\Database\Type::marshal()

Реализация

Cake\Database\TypeInterface::marshal()

setLocaleFormat()source public

setLocaleFormat( string|array $format )

Устанавливает строку формата, используемую для разбора дат в этом классе. Форматы, которые принимаются, описаны в функции Cake\I18n\Time::parseDateTime().

Параметры

строка|массив $format
Формат, в котором передаются строки.

Возвращаемое значение


$this

См. также

\Cake\I18n\Time::parseDateTime()

setTimezone()source public

setTimezone( string|DateTimeZone|null $timezone )

Установить часовой пояс базы данных.

Указанный часовой пояс будет установлен для объектов DateTime перед генерацией строки datetime для сохранения в базе данных. Если null преобразование часовых поясов не будет выполнено.

Параметры

строка|DateTimeZone|null $timezone
Часовой пояс базы данных.

Возвращаемое значение


$this

toDatabase()source public

toDatabase( string|integer|DateTime|DateTimeImmutable $value , Cake\Database\Driver $driver )

Преобразует экземпляр DateTime в строки.

Параметры

строка|целое число|DateTime|DateTimeImmutable $value
Значение для преобразования.
Cake\Database\Driver $driver
Экземпляр драйвера для преобразования.

Возвращаемое значение

строка|null

Переопределяет

Cake\Database\Type::toDatabase()

Реализация

Cake\Database\TypeInterface::toDatabase()

toPHP()source public

toPHP( string $value , Cake\Database\Driver $driver )

Преобразует строки в экземпляры DateTime.

Параметры

строка $value
Значение для преобразования.
Cake\Database\Driver $driver
Экземпляр драйвера для преобразования.

Возвращаемое значение

Cake\I18n\Time|DateTime|null

Переопределяет

Cake\Database\Type::toPHP()

Реализация

Cake\Database\TypeInterface::toPHP()

toStatement()source public

toStatement( mixed $value , Cake\Database\Driver $driver )

Преобразует заданное значение в эквивалент для оператора запроса.

Параметры

смешанное $value
значение, которое нужно преобразовать в PDO statement
Cake\Database\Driver $driver
объект, из которого извлекутся настройки и конфигурация базы данных

Возвращаемое значение

смешанное

Переопределяет

Cake\Database\Type::toStatement()

Реализация

Cake\Database\TypeInterface::toStatement()

useImmutable()source public

useImmutable( )

Изменить предпочтительное имя класса на реализацию FrozenTime.

Возвращаемое значение


$this

useLocaleParser()source public

useLocaleParser( boolean $enable = true )

Устанавливает, нужно ли использовать локально-ориентированный парсер для разбора дат, переданных в функцию marshal().

Параметры

boolean $enable необязательно true
Включить или выключить

Возвращаемое значение


$this

useMutable()source public

useMutable( )

Изменить предпочтительное имя класса на реализацию изменяемого Time.

Возвращаемое значение


$this

Методы, унаследованные от Cake\Database\Type

__debugInfo()source public

__debugInfo( )

Возвращает массив, который можно использовать для описания внутреннего состояния этого объекта.

Возвращает

array

_basicTypeCast()source protected deprecated

_basicTypeCast( mixed $value )

Проверяет, является ли этот тип базовым и может ли он быть преобразован с помощью обратного вызова. Если это так, возвращает преобразованное значение.

Устарело

3.1 Все типы теперь должны быть специфическими классами

Параметры

mixed $value
Значение, которое должно быть преобразовано в PHP-эквивалент

Возвращает

mixed

boolval()source public static deprecated

boolval( mixed $value )

Преобразователь типов для булевых значений.

Преобразует строковые значения true/false в булевы.

Устарело

3.1.8 Этот метод больше не используется.

Параметры

mixed $value
Значение, которое нужно преобразовать в булевое значение.

Возвращает

boolean

build()source public static

build( string $name )

Возвращает объект Type, способный преобразовать тип, идентифицированный по имени.

Параметры

string $name
идентификатор типа

Возвращает

Cake\Database\Type

Исключения

InvalidArgumentException
Если идентификатор типа неизвестен

buildAll()source public static

buildAll( )

Возвращает массив со всеми сопоставленными объектами типа, индексированными по имени.

Возвращает

array

clear()source public static

clear( )

Очищает все созданные экземпляры и сопоставленные типы классов, полезно для тестирования

getBaseType()source public

getBaseType( )

Возвращает базовое имя типа, от которого унаследован данный класс.

Возвращает

string
Базовое имя типа, от которого унаследован данный класс.

Реализация

Cake\Database\TypeInterface::getBaseType()

getMap()source public static

getMap( string|null $type = null )

Получить сопоставленное имя класса или экземпляр для типа(ов).

Параметры

string|null $type необязательно null
Имя типа, для которого нужно получить сопоставленный класс, или null, чтобы получить массив сопоставлений.

Возвращает

array|string|Cake\Database\TypeInterface|null
Настроенное имя класса или экземпляр для заданного $type или массив сопоставлений.

С версии

3.6.2

getName()source public

getName( )

Возвращает имя идентификатора типа для этого объекта.

Возвращает

string
Имя идентификатора типа для этого объекта.

Реализация

Cake\Database\TypeInterface::getName()

map()source public static

map( string|string[]|Cake\Database\Type[]|null $type = null , string|Cake\Database\Type|null $className = null )

Регистрирует новый идентификатор типа и сопоставляет его с полным именем класса с пространством имен. Если вызывается без аргументов, возвращает текущий массив сопоставлений типов. Если $className опущено, возвращает сопоставленный класс для $type.

Устарело 3.6.2: - Использование $type как string[]|\Cake\Database\Type[] устарело. Используйте Type::setMap() со string[] вместо этого. - Передача $className как \Cake\Database\Type экземпляра устарело, используйте только строку с именем класса. - Использование этого метода в качестве геттера устарело. Используйте Type::getMap() вместо этого.

Параметры

string|string[]|Cake\Database\Type[]|null $type необязательно null
Если строка - имя типа для сопоставления, если массив - список массивов для сопоставления
string|Cake\Database\Type|null $className необязательно null
Имя класса или экземпляр объекта, который нужно зарегистрировать.

Возвращает

array|string|null

Если $type равен null, то массив с текущим сопоставлением, если $className равен null, то строка с настроенным именем класса для данного $type, в противном случае null.


newId()source public

newId( )

Генерирует новое значение первичного ключа для заданного типа.

Возвращает

mixed
Новое значение первичного ключа.

Реализация

Cake\Database\TypeInterface::newId()

set()source public static

set( string $name , Cake\Database\Type $instance )

Возвращает объект Type, способный преобразовать тип, идентифицированный по $name

Параметры

string $name
Идентификатор типа, который вы хотите установить.
Cake\Database\Type $instance
Экземпляр типа, который вы хотите установить.

setMap()source public static

setMap( array $map )

Устанавливает сопоставление типа с именем класса.

Параметры

array $map
Список типов, которые должны быть сопоставлены.

С версии

3.6.2

strval()source public static deprecated

strval( mixed $value )

Преобразователь типов для строковых значений.

Преобразует значения в строки.

Устарело

3.1.8 Этот метод больше не используется.

Параметры

mixed $value
Значение, которое нужно преобразовать в строку.

Возвращает

string

Подробное описание свойств

$_formatsource

protected string|array

Формат времени для объекта DateTime

'H:i:s'

© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.8/class-Cake.Database.Type.TimeType.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API