datefield.php

<?php
namespace Bitrix\Main\ORM\Fields;
 
use Bitrix\Main;
use Bitrix\Main\ArgumentException;
use Bitrix\Main\ArgumentTypeException;
use Bitrix\Main\DB\SqlExpression;
use Bitrix\Main\Type;
use Bitrix\Main\Type\Date;
 
class DateField extends ScalarField
{
    protected $format = null;
 
    public function __construct($name, $parameters = array())
    {
        parent::__construct($name, $parameters);
 
        $this->addFetchDataModifier(array($this, 'assureValueObject'));
    }
 
    public function configureFormat($format)
    {
        $this->format = $format;
 
        return $this;
    }
 
    public function getValidators()
    {
        $validators = parent::getValidators();
 
        if ($this->validation === null)
        {
            $validators[] = new Validators\DateValidator;
        }
 
        return $validators;
    }
 
    public function assureValueObject($value)
    {
        if ($value instanceof Type\DateTime)
        {
            // oracle sql helper returns datetime instead of date - it doesn't see the difference
            $value = new Type\Date(
                $value->format(Main\UserFieldTable::MULTIPLE_DATE_FORMAT),
                Main\UserFieldTable::MULTIPLE_DATE_FORMAT
            );
        }
 
        return $value;
    }
 
    public function cast($value)
    {
        if ($value instanceof SqlExpression)
        {
            return $value;
        }
 
        if (!empty($value) && !($value instanceof Type\Date))
        {
            return new Type\Date($value, $this->format);
        }
 
        return $value;
    }
 
    public function convertValueFromDb($value)
    {
        return $this->getConnection()->getSqlHelper()->convertFromDbDate($value);
    }
 
    public function convertValueToDb($value)
    {
        if ($value instanceof SqlExpression)
        {
            return $value;
        }
 
        try
        {
            return $value === null && $this->is_nullable
                ? $value
                : $this->getConnection()->getSqlHelper()->convertToDbDate($value);
        }
        catch (ArgumentTypeException $e)
        {
            throw new ArgumentException(
                "Type error in `{$this->name}` of `{$this->entity->getFullName()}`: ".$e->getMessage()
            );
        }
    }
 
    public function getGetterTypeHint()
    {
        return $this->getNullableTypeHint('\\'.Date::class);
    }
 
    public function getSetterTypeHint()
    {
        return $this->getNullableTypeHint('\\'.Date::class);
    }
}