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
@@ -32,6 +32,9 @@
     "Float64",
     "Float32",
     "Bool",
+    "Datetime",
+    "Duration",
+    "String",
 ]
 
 
@@ -238,4 +241,27 @@ class Float32:
     """Floating point type with 32 bits of precision."""
 
 class Bool:
-    """Boolean type with 8 bits of precision."""
+    """Boolean type."""
+
+class Datetime:
+    """
+    Datetime type.
+
+    Attributes
+    ----------
+    time_unit : Literal['ms', 'us', 'ns']
+        Precision of the datetime type. There is no guarantee that the full
+        range of dates available for the specified precision is supported.
+    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."""
+    time_unit: Literal['ms', 'us', 'ns']
+
+class String:
+    """String type."""

spec/API_specification/index.rst

@@ -27,6 +27,9 @@ of objects and functions in the top-level namespace. The latter are:
    Float64
    Float32
    Bool
+   Datetime
+   Duration
+   String
    column_from_sequence
    column_from_1d_array
    dataframe_from_dict