feat: datediff in datetime_parser

[zhaoyongjie]

SUMMARY

The PR introduced a new function in date time expression that is datediff(<from>, <to>, [time unit],), it returns a integer, so the return value should apply in the dateadd function.

The basic form is:

# return value is 9
datediff(datetime('2018-01-01T00:00:00'), datetime('2018-01-10T00:00:00'))

# return value is -9
datediff(datetime('2018-01-10T00:00:00'), datetime('2018-01-01T00:00:00'))

The from and to parameter is able to be set any date time expression:

# return value is -365
datediff(dateadd(datetime('2018-01-01T00:00:00'), 1, year), datetime('2018-01-10T00:00:00'))

The datediff also be in dateadd as a time delta

# return value is "datetime(2017, 12, 23, 0, 0, 0)"
dateadd(
    datetime('2018-01-01T00:00:00'),
    datediff(datetime('2018-01-10T00:00:00'), datetime('2018-01-01T00:00:00')),
    day,
)

BEFORE/AFTER SCREENSHOTS OR ANIMATED GIF

N/A

TESTING INSTRUCTIONS

The unit test was covered 100% cases.

ADDITIONAL INFORMATION

• Has associated issue: the PR: refactor(plugins): Time Comparison Utils #27145 and feat(plugins): Time Comparison in Table Chart #27355 should make refactoring that build time_range in frontend.
• Required feature flags:
• Changes UI
• Includes DB Migration (follow approval process in SIP-59)
  • Migration is atomic, supports rollback & is backwards-compatible
  • Confirm DB migration upgrade and downgrade tested
  • Runtime estimates and downtime expectations provided
• Introduces new feature or API
• Removes existing feature or API

[zhaoyongjie]

By catch, to use "new typing" rather than the old one.

[codecov]

Codecov Report

Attention: Patch coverage is 95.45455% with 1 line in your changes missing coverage. Please review.

Project coverage is 69.73%. Comparing base (f453d5d) to head (4b1bbf5).
Report is 1458 commits behind head on master.

Files with missing lines	Patch %	Lines
superset/utils/date_parser.py	95.45%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master   #27368      +/-   ##
==========================================
+ Coverage   69.61%   69.73%   +0.12%     
==========================================
  Files        1908     1908              
  Lines       74543    74560      +17     
  Branches     8316     8316              
==========================================
+ Hits        51895    51998     +103     
+ Misses      20595    20509      -86     
  Partials     2053     2053              

Flag	Coverage Δ
hive	53.77% <45.45%> (?)
mysql	77.98% <50.00%> (-0.03%)	⬇️
postgres	78.08% <50.00%> (-0.03%)	⬇️
presto	53.72% <45.45%> (?)
python	83.13% <95.45%> (+0.24%)	⬆️
sqlite	77.60% <50.00%> (-0.03%)	⬇️
unit	56.52% <95.45%> (+0.01%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.