Add async datetime parameter tests and document timezone handling

Author: vgvoleg

docs/types.rst

@@ -184,6 +184,14 @@ Date and time
    * - ``PrimitiveType.Interval64``
      - extended-range interval
 
+.. note::
+
+   When a ``datetime.datetime`` is passed for ``Datetime``, ``Datetime64``,
+   ``Timestamp`` or ``Timestamp64``, a tz-naive value is written as-is (its
+   wall-clock value), while a tz-aware value is converted to UTC first.
+   Integer inputs (seconds for ``Datetime``/``Datetime64``, microseconds for
+   ``Timestamp``/``Timestamp64`` since the Unix epoch) are still accepted.
+
 Other
 ^^^^^
 

tests/aio/test_types.py

@@ -59,11 +59,12 @@ async def test_types(driver, database, value, ydb_type):
 @pytest.mark.parametrize(
     "value,ydb_type,result_value",
     [
-        # FIXME: TypeError: 'datetime.datetime' object cannot be interpreted as an integer
-        # (test_dt_today, "Datetime", test_dt_today),
         (test_today, "Date", test_today),
         (365, "Date", date(1971, 1, 1)),
         (3600 * 24 * 365, "Datetime", datetime(1971, 1, 1, 0, 0)),
+        (datetime(1971, 1, 1, 0, 0), "Datetime", datetime(1971, 1, 1, 0, 0)),
+        (datetime(1970, 1, 1, 4, 0, tzinfo=tz4h), "Datetime", datetime(1970, 1, 1, 0, 0)),
+        (datetime(1969, 1, 1, 0, 0), "Datetime64", datetime(1969, 1, 1, 0, 0)),
         (datetime(1970, 1, 1, 4, 0, tzinfo=tz4h), "Timestamp", datetime(1970, 1, 1, 0, 0)),
         (test_td, "Interval", test_td),
         (test_now, "Timestamp", test_now),