- clarify the purpose of "timezone", alleviate confusion in [ticket:2326]

diff --git a/lib/sqlalchemy/types.py b/lib/sqlalchemy/types.py
index ae15a5d169035c95738256ab8ea8367c4cfe9278..a4714d3d8370f4fefe69cd2cb68713abbc23f4da 100644 (file)
--- a/lib/sqlalchemy/types.py
+++ b/lib/sqlalchemy/types.py
@@ -1488,6 +1488,14 @@ class DateTime(_DateAffinity, TypeEngine):
     __visit_name__ = 'datetime'
 
     def __init__(self, timezone=False):
+        """Construct a new :class:`.DateTime`.
+        
+        :param timezone: boolean.  If True, and supported by the
+        backend, will produce 'TIMESTAMP WITH TIMEZONE'. For backends
+        that don't support timezone aware timestamps, has no
+        effect.
+        
+        """
         self.timezone = timezone
 
     def get_dbapi_type(self, dbapi):