Add some more dtypes: Date, Datetime, Duration, String

spec/API_specification/dataframe_api/__init__.py

@@ -3,7 +3,7 @@
 """
 from __future__ import annotations
 
-from typing import Mapping, Sequence, Any
+from typing import Mapping, Sequence, Any, Literal
 
 from .column_object import *
 from .dataframe_object import DataFrame
@@ -30,6 +30,10 @@
     "Float64",
     "Float32",
     "Bool",
+    "Date",
+    "Datetime",
+    "Duration",
+    "String",
 ]
 
 
@@ -177,3 +181,28 @@ class Float32:
 
 class Bool:
     """Boolean type with 8 bits of precision."""
+
+class Date:
+    """Date type."""
+
+class Datetime:
+    """
+    Datetime type.
+
+    Attributes
+    ----------
+    time_unit : Literal['ms', 'us', 'ns']
+        Precision of the datetime type.
+    time_zone : str | None
+        Time zone of the datetime type. Only IANA time zones are supported.
+        `None` indicates time-zone-naive data.
+    """
+    time_unit: Literal['ms', 'us', 'ns']
+    time_zone: str | None  # Only IANA time zones are supported
+
+class Duration:
+    """Duration type with 64 bits of precision."""
+    time_unit: Literal['ms', 'us', 'ns']
+
+class String:
+    """String type."""

spec/API_specification/index.rst

@@ -27,6 +27,10 @@ of objects and functions in the top-level namespace. The latter are:
    Float64
    Float32
    Bool
+   Date
+   Datetime
+   Duration
+   String
 
 The ``DataFrame``, ``Column`` and ``GroupBy`` objects have the following
 methods and attributes: