From 60c913979f191a434c4ca66cd27bc4b5126a47e1 Mon Sep 17 00:00:00 2001 From: hau887 Date: Mon, 25 Sep 2023 15:51:12 -0700 Subject: [PATCH 1/5] Added paragraph about wall time and absolute time --- docs/relativedelta.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/relativedelta.rst b/docs/relativedelta.rst index e2994d2c..53ccdf82 100644 --- a/docs/relativedelta.rst +++ b/docs/relativedelta.rst @@ -218,3 +218,22 @@ We can use the non-leap year day to ignore this: >>> date(2000, 1, 1)+relativedelta(nlyearday=260) datetime.date(2000, 9, 17) + +Remember: relativedelta.relativedelta provides the calendar time delta, Wall Time, not Absolute Time. +Wall time is the time on the clock: adding or subrtracting time changes time on a specified number of minutes, hours, +days, weeks, etc. Absolute time counts switching of time regions, change of the winter time to summer time, etc. +Example around 03/11/2023, day of the switch to summer time: + +.. doctest:: relativedelta + # winter time + >>> winter_time = datetime(2023, 3, 11, 2, 55, 0, tzinfo=tz.gettz('America/Los_Angeles')) + 2023-03-11 02:55:00-08:00 + # summer time + >>> summer_time = winter_time + relativedelta.relativedelta(days=1) + 2023-03-12 02:55:00-07:00 + # wall time (in hours) + >>> (summer_time - winter_time).days * 24.0 + 24.0 + # absolute time (converting to UTC timestamp) + >>> (summer_time.timestamp() - winter_time.timestamp())/3600 + 23.0 \ No newline at end of file From 0b831007e5917ccb7ed7cec71dd0aaf150138e06 Mon Sep 17 00:00:00 2001 From: hau887 Date: Mon, 25 Sep 2023 16:39:43 -0700 Subject: [PATCH 2/5] Added paragraph about wall time and absolute time --- docs/relativedelta.rst | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/docs/relativedelta.rst b/docs/relativedelta.rst index 53ccdf82..f97ad5cb 100644 --- a/docs/relativedelta.rst +++ b/docs/relativedelta.rst @@ -225,15 +225,12 @@ days, weeks, etc. Absolute time counts switching of time regions, change of the Example around 03/11/2023, day of the switch to summer time: .. doctest:: relativedelta - # winter time + >>> winter_time = datetime(2023, 3, 11, 2, 55, 0, tzinfo=tz.gettz('America/Los_Angeles')) 2023-03-11 02:55:00-08:00 - # summer time >>> summer_time = winter_time + relativedelta.relativedelta(days=1) 2023-03-12 02:55:00-07:00 - # wall time (in hours) >>> (summer_time - winter_time).days * 24.0 24.0 - # absolute time (converting to UTC timestamp) >>> (summer_time.timestamp() - winter_time.timestamp())/3600 23.0 \ No newline at end of file From 8f6cfd9a9ea6a0ea2687a9ced7e4e39e00d78549 Mon Sep 17 00:00:00 2001 From: hau887 Date: Mon, 25 Sep 2023 16:47:51 -0700 Subject: [PATCH 3/5] Added paragraph about wall time and absolute time --- docs/relativedelta.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/relativedelta.rst b/docs/relativedelta.rst index f97ad5cb..25c7eaaf 100644 --- a/docs/relativedelta.rst +++ b/docs/relativedelta.rst @@ -228,7 +228,7 @@ Example around 03/11/2023, day of the switch to summer time: >>> winter_time = datetime(2023, 3, 11, 2, 55, 0, tzinfo=tz.gettz('America/Los_Angeles')) 2023-03-11 02:55:00-08:00 - >>> summer_time = winter_time + relativedelta.relativedelta(days=1) + >>> summer_time = winter_time + relativedelta(days=1) 2023-03-12 02:55:00-07:00 >>> (summer_time - winter_time).days * 24.0 24.0 From 9e3904ae853c3818dfd2e0dccd69ab3dc2868062 Mon Sep 17 00:00:00 2001 From: hau887 Date: Mon, 25 Sep 2023 18:06:53 -0700 Subject: [PATCH 4/5] Added paragraph about wall time and absolute time --- docs/relativedelta.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/relativedelta.rst b/docs/relativedelta.rst index 25c7eaaf..f97ad5cb 100644 --- a/docs/relativedelta.rst +++ b/docs/relativedelta.rst @@ -228,7 +228,7 @@ Example around 03/11/2023, day of the switch to summer time: >>> winter_time = datetime(2023, 3, 11, 2, 55, 0, tzinfo=tz.gettz('America/Los_Angeles')) 2023-03-11 02:55:00-08:00 - >>> summer_time = winter_time + relativedelta(days=1) + >>> summer_time = winter_time + relativedelta.relativedelta(days=1) 2023-03-12 02:55:00-07:00 >>> (summer_time - winter_time).days * 24.0 24.0 From baa826c3c4d06c16de22dcf1d521adb33602a996 Mon Sep 17 00:00:00 2001 From: hau887 Date: Mon, 25 Sep 2023 18:10:22 -0700 Subject: [PATCH 5/5] Added paragraph about wall time and absolute time --- docs/relativedelta.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/relativedelta.rst b/docs/relativedelta.rst index f97ad5cb..4793475a 100644 --- a/docs/relativedelta.rst +++ b/docs/relativedelta.rst @@ -220,8 +220,8 @@ We can use the non-leap year day to ignore this: datetime.date(2000, 9, 17) Remember: relativedelta.relativedelta provides the calendar time delta, Wall Time, not Absolute Time. -Wall time is the time on the clock: adding or subrtracting time changes time on a specified number of minutes, hours, -days, weeks, etc. Absolute time counts switching of time regions, change of the winter time to summer time, etc. +Wall Time is the time on the clock: adding or subrtracting time changes time on a specified number of minutes, hours, +days, weeks, etc. Absolute Time counts switching of time regions, change of the winter time to summer time, etc. Example around 03/11/2023, day of the switch to summer time: .. doctest:: relativedelta