Time & Date Deprecated

yousuo · September 20, 2021, 1:01pm

The datetime classes Time and Date are deprecated. 
Use their immutable alternatives FrozenTime and FrozenDate instead.

I find Time & Date kinda useful. Is there a reason why Time & Date is deprecated ?

Zuluru · September 20, 2021, 1:35pm

What do you find useful about them, which FrozenTime and FrozenDate can’t do?

KevinPfeifer · September 20, 2021, 3:08pm

FrozenTime and FrozenDate are basically the same as Time and Date, just that they are immutable.

github.com

cakephp/cakephp/blob/4.x/src/I18n/FrozenTime.php#L28

    
      
          
          
use Cake\Chronos\Chronos;
          use DateTimeInterface;
          use DateTimeZone;
          use IntlDateFormatter;
          
          
/**
           * Extends the built-in DateTime class to provide handy methods and locale-aware
           * formatting helpers
           *
           * This object provides an immutable variant of Cake\I18n\Time
           */
          class FrozenTime extends Chronos implements I18nDateTimeInterface
          {
              use DateFormatTrait;
          
          
    /**
               * The format to use when formatting a time using `Cake\I18n\FrozenTime::i18nFormat()`
               * and `__toString`. This format is also used by `parseDateTime()`.
               *
               * The format should be either the formatting constants from IntlDateFormatter as

github.com

cakephp/cakephp/blob/4.x/src/I18n/FrozenDate.php#L27

    
      
          namespace Cake\I18n;
          
          
use Cake\Chronos\Date as ChronosDate;
          use IntlDateFormatter;
          
          
/**
           * Extends the Date class provided by Chronos.
           *
           * Adds handy methods and locale-aware formatting helpers
           *
           * This object provides an immutable variant of Cake\I18n\Date
           */
          class FrozenDate extends ChronosDate implements I18nDateTimeInterface
          {
              use DateFormatTrait;
          
          
    /**
               * The format to use when formatting a time using `Cake\I18n\Date::i18nFormat()`
               * and `__toString`. This format is also used by `parseDateTime()`.
               *
               * The format should be either the formatting constants from IntlDateFormatter as

yousuo · September 21, 2021, 3:00am

yes, i am aware of frozenDate/Time are immutable objects. It would be an extra step for me to change the date/time as frozenDate/Time creates a new instance when changed. An extra step for me.

Just curious why it is deprecated, since Time/Date has been there for so long.

Zuluru · September 21, 2021, 5:01pm

I think it’s because of the number of bugs that people get when they do things like $entity->some_date->addYear()->format('xxx') to generate a readable version of a year after the date in question, without realizing that this changes the date in the entity. Making everything immutable means that you have to make your intention clear when you want to change it.

Topic		Replies	Views
Date and time localized format Need Help	8	419	November 10, 2020
FronzenTime Example Not Working i18n	3	507	June 6, 2021
Formatting Date time in view in CakePHP 3 Need Help behavior , i18n	3	16938	September 13, 2018
Cake 4 Date time format in the data array (SOLVED) Need Help	2	302	April 28, 2020
DifferenceFormatter Need Help	1	223	February 28, 2023

Time & Date Deprecated

Releases

Documentation

Community

Time & Date Deprecated

Related Topics

Releases

Documentation

Community