From 9a2f718f68b1bd8f3037b883ea7dce9838757f2b Mon Sep 17 00:00:00 2001
From: Rouven Bauer <rouven.bauer@neo4j.com>
Date: Tue, 2 Nov 2021 17:40:12 +0100
Subject: [PATCH] Adding examples for Python's temporal types

---
 pythonManual/asciidoc/cypher-workflow.adoc | 103 +++++++++++++++++++++
 1 file changed, 103 insertions(+)

diff --git a/pythonManual/asciidoc/cypher-workflow.adoc b/pythonManual/asciidoc/cypher-workflow.adoc
index 8d43d553..c8cc37de 100644
--- a/pythonManual/asciidoc/cypher-workflow.adoc
+++ b/pythonManual/asciidoc/cypher-workflow.adoc
@@ -129,6 +129,109 @@ include::{common-content}/cypher-workflow.adoc[tag=type-mapping]
 ======
 
 
+[[python-driver-temporal-types]]
+=== Temporal Types
+
+This section lists some basic usage of the temporal types provided by the Python Driver.
+
+
+[[python-driver-temporal-types-datetime]]
+==== `DateTime`
+
+Represents an instant capturing the date, the time, and the timezone identifier.
+
+[source, python]
+----
+include::{python-examples}/test_temporal_types_example.py[tags=temporal-types-datetime-import]
+----
+
+[source, python]
+----
+include::{python-examples}/test_temporal_types_example.py[tags=temporal-types-datetime]
+----
+
+
+[[python-driver-temporal-types-date]]
+==== `Date`
+
+Represents an instant capturing the date, but not the time, nor the timezone.
+
+[source, python]
+----
+include::{python-examples}/test_temporal_types_example.py[tags=temporal-types-date-import]
+----
+
+[source, python]
+----
+include::{python-examples}/test_temporal_types_example.py[tags=temporal-types-date]
+----
+
+
+[[python-driver-temporal-types-time]]
+==== `Time`
+
+Represents an instant capturing the time of day, and the timezone offset in seconds, but not the date.
+
+[source, python]
+----
+include::{python-examples}/test_temporal_types_example.py[tags=temporal-types-time-import]
+----
+
+[source, python]
+----
+include::{python-examples}/test_temporal_types_example.py[tags=temporal-types-time]
+----
+
+
+[[python-driver-temporal-types-local-datetime]]
+==== `Local DateTime`
+
+Represents an instant capturing the date and the time, but not the timezone.
+
+[source, python]
+----
+include::{python-examples}/test_temporal_types_example.py[tags=temporal-types-local-datetime-import]
+----
+
+[source, python]
+----
+include::{python-examples}/test_temporal_types_example.py[tags=temporal-types-local-datetime]
+----
+
+
+[[python-driver-temporal-types-local-time]]
+==== `Local Time`
+
+Represents an instant capturing the time of day, but not the date, nor the timezone.
+
+[source, python]
+----
+include::{python-examples}/test_temporal_types_example.py[tags=temporal-types-local-time-import]
+----
+
+[source, python]
+----
+include::{python-examples}/test_temporal_types_example.py[tags=temporal-types-local-time]
+----
+
+
+[[python-driver-temporal-types-duration]]
+==== `Duration`
+
+Represents an ISO 8601 duration.
+Contains both date-based values (years, months, days) and time-based values (seconds, nanoseconds).
+
+[source, python]
+----
+include::{python-examples}/test_temporal_types_example.py[tags=temporal-types-duration-import]
+----
+
+[source, python]
+----
+include::{python-examples}/test_temporal_types_example.py[tags=temporal-types-duration]
+----
+
+
 [[python-driver-exceptions-errors]]
 == Exceptions and error handling