Класс DateType
Класс DateType
- Cake\Database\Type implements Cake\Database\TypeInterface
-
Cake\Database\Type\DateTimeType implements Cake\Database\TypeInterface, Cake\Database\Type\BatchCastingInterface
-
Cake\Database\Type\DateType
Краткое описание свойств
-
$_formatprotectedФормат даты для объекта DateTimestring|array - Класс для представления объектов даты
string -
$setToDateStartprotectedbooleanВ этом классе мы хотим, чтобы объекты Date имели время, установленное в начало дня.
Унаследованные свойства
-
_className,_datetimeInstance,_localeFormat,_name,_useLocaleParser,dbTimezone_basicTypes,_builtTypes,_types
Краткое описание методов
- _parseValue() protected
Преобразует строку в объект DateTime после её разбора с использованием локально-зависимого парсера с указанным форматом.
- marshal() publicПреобразовать данные запроса в объект datetime.
- useImmutable() publicИзменить предпочтительное имя класса на FrozenDate.
- useMutable() publicИзменить предпочтительное имя класса на изменяемый тип Date.
Подробное описание методов
_parseValue()source protected
_parseValue( string $value )
Преобразует строку в объект DateTime после её разбора с использованием локально-зависимого парсера с указанным форматом.
Параметры
- string
$value - Значение для разбора и преобразования в объект.
Возвращает
Cake\I18n\Time|nullПереопределяет
Cake\Database\Type\DateTimeType::_parseValue() marshal()source public
marshal( mixed $value )
Преобразовать данные запроса в объект datetime.
Параметры
- mixed
$value - Данные запроса
Возвращает
DateTimeInterfaceПереопределяет
Cake\Database\Type\DateTimeType::marshal() useImmutable()source public
useImmutable( )
Изменить предпочтительное имя класса на FrozenDate.
Возвращает
$this
Переопределяет
Cake\Database\Type\DateTimeType::useImmutable() useMutable()source public
useMutable( )
Изменить предпочтительное имя класса на изменяемый тип Date.
Возвращает
$this
Переопределяет
Cake\Database\Type\DateTimeType::useMutable() Унаследованные методы из Cake\Database\Type\DateTimeType
__construct()source public
__construct( string|null $name = null )
Конструктор
Параметры
- string|null
$nameoptional null - Имя, идентифицирующее этот тип
Переопределяет
Cake\Database\Type::__construct() _compare()source protected
_compare( Cake\I18n\Time|DateTime $date , mixed $value )
Параметры
-
Cake\I18n\Time|DateTime$date - Объект DateTime
- mixed
$value - Данные запроса
Возвращает
boolean_setClassName()source protected
_setClassName( string $class , string $fallback )
Устанавливает имя класса для создания объектов.
Параметры
- string
$class - Имя класса для использования.
- string
$fallback - Имя класса для использования, если предпочтительный класс не существует.
getDateTimeClassName()source public
getDateTimeClassName( )
Получить имя класса, используемого для создания объектов.
Возвращает
stringmanyToPHP()source public
manyToPHP( array $values , array $fields , Cake\Database\Driver $driver )
Возвращает массив значений, преобразованных в представление PHP этого типа.
Параметры
- array
$values - Исходный массив значений, содержащий поля для преобразования
- array
$fields - Ключи полей для преобразования
-
Cake\Database\Driver$driver - Объект, из которого будут извлечены настройки и конфигурация базы данных.
Возвращает
arrayРеализация
Cake\Database\Type\BatchCastingInterface::manyToPHP() setLocaleFormat()source public
setLocaleFormat( string|array $format )
Устанавливает строку формата, используемую для разбора дат в этом классе. Форматы, которые принимаются, описаны в функции Cake\I18n\Time::parseDateTime().
Параметры
- string|array
$format - Формат, в котором передаются строки.
Возвращает
$this
См.
\Cake\I18n\Time::parseDateTime()setTimezone()source public
setTimezone( string|DateTimeZone|null $timezone )
Установить часовой пояс базы данных.
Указанный часовой пояс будет установлен для объектов DateTime перед генерацией строки datetime для сохранения в базе данных. Если null преобразование часовых поясов не будет выполнено.
Параметры
- string|DateTimeZone|null
$timezone - Часовой пояс базы данных.
Возвращает
$this
toDatabase()source public
toDatabase( string|integer|DateTime|DateTimeImmutable $value , Cake\Database\Driver $driver )
Преобразовать экземпляр DateTime в строки.
Параметры
- string|integer|DateTime|DateTimeImmutable
$value - Значение для преобразования.
-
Cake\Database\Driver$driver - Экземпляр драйвера для преобразования.
Возвращает
string|nullПереопределяет
Cake\Database\Type::toDatabase() Реализация
Cake\Database\TypeInterface::toDatabase() toPHP()source public
toPHP( string $value , Cake\Database\Driver $driver )
Преобразовать строки в экземпляры DateTime.
Параметры
- string
$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 )
Преобразует заданное значение в эквивалент оператора Statement
Параметры
- mixed
$value - значение, которое необходимо преобразовать в оператор PDO
-
Cake\Database\Driver$driver - объект, из которого будут извлечены настройки и конфигурация базы данных
Возвращает
mixedПереопределяет
Cake\Database\Type::toStatement() Реализация
Cake\Database\TypeInterface::toStatement() useLocaleParser()source public
useLocaleParser( boolean $enable = true )
Устанавливает, использовать ли локально-зависимый анализатор дат, передаваемых в функцию marshal().
Параметры
- boolean
$enableнеобязательно true - Включить или отключить
Возвращает
$this
Методы, унаследованные от Cake\Database\Type
__debugInfo()source public
__debugInfo( )
Возвращает массив, который можно использовать для описания внутреннего состояния этого объекта.
Возвращает
array_basicTypeCast()source protected deprecated
_basicTypeCast( mixed $value )
Проверяет, является ли этот тип базовым и может ли он быть преобразован с помощью обратного вызова. Если это так, возвращает преобразованное значение.
Устарело
3.1 Все типы теперь должны быть отдельным классомПараметры
- mixed
$value - Значение, которое необходимо преобразовать в PHP эквивалент
Возвращает
mixedboolval()source public static deprecated
boolval( mixed $value )
Конвертер типов для логических значений.
Преобразует строки true/false в булевы значения.
Устарело
3.1.8 Этот метод больше не используется.Параметры
- mixed
$value - Значение, которое необходимо преобразовать в булевое.
Возвращает
booleanbuild()source public static
build( string $name )
Возвращает объект Type, способный преобразовать тип, идентифицированный по имени.
Параметры
- string
$name - идентификатор типа
Возвращает
Cake\Database\TypeИсключения
InvalidArgumentExceptionЕсли идентификатор типа неизвестен
buildAll()source public static
buildAll( )
Возвращает массив со всеми сопоставленными объектами типа, индексированными по имени.
Возвращает
arrayclear()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.2getName()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.2strval()source public static deprecated
strval( mixed $value )
Конвертер типов для строковых значений.
Преобразует значения в строки.
Устарело
3.1.8 Этот метод больше не используется.Параметры
- mixed
$value - Значение, которое необходимо преобразовать в строку.
Возвращает
stringПодробности свойств
$dateTimeClasssource
public static string
Класс, который используется для представления объектов дат
Это свойство можно использовать только до создания экземпляра этого класса. После этого используйте useMutable() или useImmutable() вместо него.
Устарело
3.2.0 Используйте DateType::useMutable() или DateType::useImmutable() вместо этого.'Cake\I18n\Date'
$setToDateStartsource
protected boolean
В этом классе мы хотим, чтобы объекты Date имели время, установленное в начало дня.
true
© 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.7/class-Cake.Database.Type.DateType.html