Spec-Zone.ru › CakePHP 3.7

Класс DateType

Класс DateType

Cake\Database\Type implements Cake\Database\TypeInterface
Extended by Cake\Database\Type\DateTimeType implements Cake\Database\TypeInterface, Cake\Database\Type\BatchCastingInterface
Extended by Cake\Database\Type\DateType
Пространство имён: Cake\Database\Type
Расположение: Database/Type/DateType.php

Краткое описание свойств

  • $_format protected
    string|array
    Формат даты для объекта DateTime
  • $dateTimeClass public static
    string
    Класс для представления объектов даты
  • $setToDateStart protected
    boolean

    В этом классе мы хотим, чтобы объекты 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 $name optional 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( )

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

Возвращает

string

manyToPHP()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()
END_OF_DOCUMENT_MARKER

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 эквивалент

Возвращает

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

'Y-m-d'

$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

Spec-Zone.ru

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