+"""
+Parse dates / datetimes in a variety of formats. Some examples:
+
+ | today
+ | tomorrow
+ | yesterday
+ | 21:30
+ | 12:01am
+ | 12:01pm
+ | last Wednesday
+ | this Wednesday
+ | next Wed
+ | this coming Tues
+ | this past Mon
+ | 4 days ago
+ | 4 Mondays ago
+ | 4 months ago
+ | 3 days back
+ | 13 weeks from now
+ | 1 year from now
+ | 4 weeks from now
+ | 3 saturdays ago
+ | 4 months from today
+ | 5 years from yesterday
+ | 6 weeks from tomorrow
+ | april 15, 2005
+ | april 21
+ | 9:30am on last Wednesday
+ | 2005/apr/15
+ | 2005 apr 15
+ | the 1st wednesday in may
+ | the last sun of june
+ | this easter
+ | last xmas
+ | Christmas, 1999
+ | next MLK day
+ | Halloween, 2020
+ | 5 work days after independence day
+ | 50 working days from last wed
+ | 25 working days before xmas
+ | today +1 week
+ | sunday -3 weeks
+ | 3 weeks before xmas, 1999
+ | 3 days before new years eve, 2000
+ | july 4th
+ | the ides of march
+ | the nones of april
+ | the kalends of may
+ | 4 sundays before veterans' day
+ | xmas eve
+ | this friday at 5pm
+ | presidents day
+ | memorial day, 1921
+ | thanksgiving
+ | 2 sun in jun
+ | easter -40 days
+ | 2 days before last xmas at 3:14:15.92a
+ | 3 weeks after xmas, 1995 at midday
+ | 4 months before easter, 1992 at midnight
+ | 5 months before halloween, 1995 at noon
+ | 4 days before last wednesday
+ | 44 months after today
+ | 44 years before today
+ | 44 weeks ago
+ | 15 minutes to 3am
+ | quarter past 4pm
+ | half past 9
+ | 4 seconds to midnight
+ | 4 seconds to midnight, tomorrow
+ | 2021/apr/15T21:30:44.55
+ | 2021/apr/15 at 21:30:44.55
+ | 2021/4/15 at 21:30:44.55
+ | 2021/04/15 at 21:30:44.55Z
+ | 2021/04/15 at 21:30:44.55EST
+ | 13 days after last memorial day at 12 seconds before 4pm
+
+This code is used by other code in the pyutils library; for example,
+when using :file:`argparse_utils.py` to pass an argument of type
+datetime it allows the user to use free form English expressions.
+
+See the `unittest <https://wannabe.guru.org/gitweb/?p=pyutils.git;a=blob_plain;f=tests/datetimez/dateparse_utils_test.py;h=93c7b96e4c19af217fbafcf1ed5dbde13ec599c5;hb=HEAD>`_ for more examples and the `grammar <https://wannabe.guru.org/gitweb/?p=pyutils.git;a=blob_plain;f=src/pyutils/datetimez/dateparse_utils.g4;hb=HEAD>`_ for more details.
+"""