New Issue: 'DateTime' module stabilization - removing ambiguous functions

18834, "aconsroe-hpe", "'DateTime' module stabilization - removing ambiguous functions", "2021-12-09T23:24:59Z"

As part of the DateTime module review, we identified two functions that seem ambiguous and eligible for deprecation and ultimately removing. They are:

  • datetime.today - This function refers to today for a datetime, where the time portion is ambiguous what the user desires.
    • Suggested to replace uses with datetime.now or date.today
  • operator datetime.-(dt: datetime, d: date):timedelta - the date gets promoted to datetime with time 00:00:00.
    • Suggested to replace uses with dt.date - d or dt - new datetime(d, new time()) (with a new datetime init overload)