$dateTimeClass
$dateTimeClass : string
The class to use for representing date objects
This property can only be used before an instance of this type
class is constructed. After that use useMutable()
or useImmutable()
instead.
Class DateType
Use to convert datetime instances to strings & back.
None found |
$setToDateStart : boolean
In this class we want Date objects to have their time set to the beginning of the day.
This is primarily to avoid subclasses needing to re-implement the same functionality.
None found |
$_useLocaleParser : boolean
Whether dates should be parsed using a locale aware parser when marshalling string inputs.
None found |
$_localeFormat : string|array|integer
The date format to use for parsing incoming dates for marshalling.
None found |
$_datetimeInstance : \DateTime
An instance of the configured dateTimeClass, used to quickly generate new instances without calling the constructor.
None found |
None found |
None found |
$_types : array<mixed,string>|array<mixed,\Cake\Database\Type>
List of supported database types. A human readable identifier is used as key and a complete namespaced class name as value representing the class that will do actual type conversions.
None found |
$_basicTypes : array
List of basic type mappings, used to avoid having to instantiate a class for doing conversion on these.
None found |
$_builtTypes : array<mixed,\Cake\Database\Type>
Contains a map of type object instances to be reused if needed.
None found |
__construct(string|null $name = null)
Constructor
string|null | $name | The name identifying this type |
None found |
toDatabase(mixed $value, \Cake\Database\Driver $driver) : mixed
Casts given value from a PHP type to one acceptable by a database.
mixed | $value | Value to be converted to a database equivalent. |
\Cake\Database\Driver | $driver | Object from which database preferences and configuration will be extracted. |
Given PHP type casted to one acceptable by a database.
None found |
setTimezone(string|\DateTimeZone|null $timezone) : $this
Set database timezone.
Specified timezone will be set for DateTime objects before generating
datetime string for saving to database. If null
no timezone conversion
will be done.
string|\DateTimeZone|null | $timezone | Database timezone. |
None found |
toPHP(mixed $value, \Cake\Database\Driver $driver) : mixed
Casts given value from a database type to PHP equivalent
mixed | $value | Value to be converted to PHP equivalent |
\Cake\Database\Driver | $driver | Object from which database preferences and configuration will be extracted |
None found |
manyToPHP(array $values, array $fields, \Cake\Database\Driver $driver) : array
Returns an array of the values converted to the PHP representation of this type.
array | $values | The original array of values containing the fields to be casted |
array | $fields | The field keys to cast |
\Cake\Database\Driver | $driver | Object from which database preferences and configuration will be extracted. |
None found |
marshal(mixed $value) : \DateTimeInterface
Convert request data into a datetime object.
Most useful for converting request data into PHP objects, that make sense for the rest of the ORM/Database layers.
mixed | $value | Request data |
None found |
useLocaleParser(boolean $enable = true) : $this
Sets whether or not to parse dates passed to the marshal() function by using a locale aware parser.
boolean | $enable | Whether or not to enable |
None found |
setLocaleFormat(string|array $format) : $this
Sets the format string to use for parsing dates in this class. The formats that are accepted are documented in the `Cake\I18n\Time::parseDateTime()` function.
string|array | $format | The format in which the string are passed. |
None found |
useImmutable() : $this
Change the preferred class name to the FrozenDate implementation.
None found |
getDateTimeClassName() : string
Get the classname used for building objects.
None found |
useMutable() : $this
Change the preferred class name to the mutable Date implementation.
None found |
toStatement(mixed $value, \Cake\Database\Driver $driver) : mixed
Casts given value to its Statement equivalent.
mixed | $value | Value to be converted to PDO statement. |
\Cake\Database\Driver | $driver | Object from which database preferences and configuration will be extracted. |
Given value casted to its Statement equivalent.
None found |
build(string $name) : \Cake\Database\Type
Returns a Type object capable of converting a type identified by name.
string | $name | type identifier |
If type identifier is unknown
None found |
buildAll() : array
Returns an arrays with all the mapped type objects, indexed by name.
None found |
set(string $name, \Cake\Database\Type $instance) : void
Returns a Type object capable of converting a type identified by $name
string | $name | The type identifier you want to set. |
\Cake\Database\Type | $instance | The type instance you want to set. |
None found |
map(string|array<mixed,string>|array<mixed,\Cake\Database\Type>|null $type = null, string|\Cake\Database\Type|null $className = null) : array|string|null
Registers a new type identifier and maps it to a fully namespaced classname, If called with no arguments it will return current types map array If $className is omitted it will return mapped class for $type
Deprecated 3.6.2:
string|array<mixed,string>|array<mixed,\Cake\Database\Type>|null | $type | If string name of type to map, if array list of arrays to be mapped |
string|\Cake\Database\Type|null | $className | The classname or object instance of it to register. |
If $type is null then array with current map, if $className is null string configured class name for give $type, null otherwise
None found |
setMap(array<mixed,string> $map) : void
Set type to classname mapping.
array<mixed,string> | $map | List of types to be mapped. |
since | 3.6.2 |
---|
getMap(string|null $type = null) : array|string|\Cake\Database\TypeInterface|null
Get mapped class name or instance for type(s).
string|null | $type | Type name to get mapped class for or null to get map array. |
Configured class name or instance for give $type or map array.
since | 3.6.2 |
---|
clear() : void
Clears out all created instances and mapped types classes, useful for testing
None found |
getName() : string
Returns type identifier name for this object.
The type identifier name for this object.
None found |
getBaseType() : string
Returns the base type name that this class is inheriting.
This is useful when extending base type for adding extra functionality, but still want the rest of the framework to use the same assumptions it would do about the base type it inherits from.
The base type name that this class is inheriting.
None found |
boolval(mixed $value) : boolean
Type converter for boolean values.
Will convert string true/false into booleans.
mixed | $value | The value to convert to a boolean. |
None found |
strval(mixed $value) : string
Type converter for string values.
Will convert values into strings
mixed | $value | The value to convert to a string. |
None found |
newId() : mixed
Generate a new primary key value for a given type.
This method can be used by types to create new primary key values when entities are inserted.
A new primary key value.
None found |
__debugInfo() : array
Returns an array that can be used to describe the internal state of this object.
None found |
_compare(\Cake\I18n\Time|\DateTime $date, mixed $value) : boolean
\Cake\I18n\Time|\DateTime | $date | DateTime object |
mixed | $value | Request data |
None found |
_setClassName(string $class, string $fallback) : void
Set the classname to use when building objects.
string | $class | The classname to use. |
string | $fallback | The classname to use when the preferred class does not exist. |
None found |
_parseValue(string $value) : \Cake\I18n\Time|null
Converts a string into a DateTime object after parsing it using the locale aware parser with the specified format.
string | $value | The value to parse and convert to an object. |
None found |
_basicTypeCast(mixed $value) : mixed
Checks whether this type is a basic one and can be converted using a callback If it is, returns converted value
mixed | $value | Value to be converted to PHP equivalent |
None found |