From de4adecae6e77c0677a70e807bae5ac8cc4c6314 Mon Sep 17 00:00:00 2001
From: Daniel Hall <daniel.hall@moesol.com>
Date: Tue, 28 Jun 2022 15:03:34 -0400
Subject: [PATCH] 8152: add documentation for postgresql dialect time and
 timestamp types

add documentation for postgresql dialect time and timestamp types

This pull request is:

- [ X] A documentation / typographical error fix
	- Good to go, no issue or tests are needed

**Have a nice day!**

Closes: #8185
Pull-request: https://github.com/sqlalchemy/sqlalchemy/pull/8185
Pull-request-sha: 2b76fe080babd72f8e5615b34cb544abbc446a28

Change-Id: Ib71b35d106d0d0686e5551f07b88486b6c59624d
(cherry picked from commit 300ce85463474c0264b37c0f2a8baa5f3cf3d822)
---
 doc/build/dialects/postgresql.rst          |  6 +++++
 lib/sqlalchemy/dialects/postgresql/base.py | 26 ++++++++++++++++++++++
 2 files changed, 32 insertions(+)

diff --git a/doc/build/dialects/postgresql.rst b/doc/build/dialects/postgresql.rst
index d30c03885d..c58aaee9b4 100644
--- a/doc/build/dialects/postgresql.rst
+++ b/doc/build/dialects/postgresql.rst
@@ -89,6 +89,12 @@ construction arguments, are as follows:
 
 .. autoclass:: REGCLASS
 
+.. autoclass:: TIMESTAMP
+    :members: __init__
+
+.. autoclass:: TIME
+    :members: __init__
+
 .. autoclass:: TSVECTOR
 
 .. autoclass:: UUID
diff --git a/lib/sqlalchemy/dialects/postgresql/base.py b/lib/sqlalchemy/dialects/postgresql/base.py
index db88d9e6a8..dbaced5db5 100644
--- a/lib/sqlalchemy/dialects/postgresql/base.py
+++ b/lib/sqlalchemy/dialects/postgresql/base.py
@@ -1682,13 +1682,39 @@ class REGCLASS(sqltypes.TypeEngine):
 
 
 class TIMESTAMP(sqltypes.TIMESTAMP):
+
+    """Provide the PostgreSQL TIMESTAMP type."""
+
+    __visit_name__ = "TIMESTAMP"
+
     def __init__(self, timezone=False, precision=None):
+        """Construct a TIMESTAMP.
+
+        :param timezone: boolean value if timezone present, default False
+        :param precision: optional integer precision value
+
+         .. versionadded:: 1.4
+
+        """
         super(TIMESTAMP, self).__init__(timezone=timezone)
         self.precision = precision
 
 
 class TIME(sqltypes.TIME):
+
+    """PostgreSQL TIME type."""
+
+    __visit_name__ = "TIME"
+
     def __init__(self, timezone=False, precision=None):
+        """Construct a TIME.
+
+        :param timezone: boolean value if timezone present, default False
+        :param precision: optional integer precision value
+
+         .. versionadded:: 1.4
+
+        """
         super(TIME, self).__init__(timezone=timezone)
         self.precision = precision
 
-- 
2.47.2