class documentation

class INTERVAL(sqltypes.NativeForEmulated, sqltypes._AbstractInterval):

Known subclasses: sqlalchemy.dialects.postgresql.pg8000._PGInterval

View In Hierarchy

PostgreSQL INTERVAL type.
Class Method adapt​_emulated​_to​_native Given an impl, adapt this type's class to the impl assuming "native".
Method __init__ Construct an INTERVAL.
Method as​_generic Return an instance of the generic type corresponding to this type using heuristic rule. The method may be overridden if this heuristic rule is not sufficient.
Method coerce​_compared​_value See .TypeEngine.coerce_compared_value for a description.
Class Variable __visit​_name__ Undocumented
Class Variable native Undocumented
Instance Variable fields Undocumented
Instance Variable precision Undocumented
Property ​_type​_affinity Return a rudimental 'affinity' value expressing the general class of type.
Property python​_type Return the Python type object expected to be returned by instances of this type, if known.

Inherited from NativeForEmulated:

Class Method adapt​_native​_to​_emulated Given an impl, adapt this type's class to the impl assuming "emulated".

Inherited from _AbstractInterval:

Property ​_expression​_adaptations Undocumented

Inherited from _LookupExpressionAdapter (via _AbstractInterval):

Class ​Comparator Undocumented

Inherited from TypeEngine (via _AbstractInterval):

Class ​Comparator Base class for custom comparison operations defined at the type level. See .TypeEngine.comparator_factory.
Method adapt Produce an "adapted" form of this type, given an "impl" class to work with.
Method bind​_expression Given a bind value (i.e. a .BindParameter instance), return a SQL expression in its place.
Method bind​_processor Return a conversion function for processing bind values.
Method column​_expression Given a SELECT column expression, return a wrapping SQL expression.
Method compare​_against​_backend Compare this type against the given backend type.
Method compare​_values Compare two values for equality.
Method compile Produce a string-compiled form of this .TypeEngine.
Method dialect​_impl Return a dialect-specific implementation for this .TypeEngine.
Method evaluates​_none Return a copy of this type which has the .should_evaluate_none flag set to True.
Method get​_dbapi​_type Return the corresponding type object from the underlying DB-API, if any.
Method literal​_processor Return a conversion function for processing literal values that are to be rendered directly without using binds.
Method result​_processor Return a conversion function for processing result row values.
Method with​_variant Produce a new type object that will utilize the given type when applied to the dialect of the given name.
Class Variable hashable Flag, if False, means values from this type aren't hashable.
Class Variable should​_evaluate​_none If True, the Python constant None is considered to be handled explicitly by this type.
Class Variable sort​_key​_function A sorting function that can be passed as the key to sorted.
Static Method ​_to​_instance Undocumented
Method __repr__ Undocumented
Method __str__ Undocumented
Method ​_cached​_bind​_processor Return a dialect-specific bind processor for this type.
Method ​_cached​_custom​_processor Undocumented
Method ​_cached​_literal​_processor Return a dialect-specific literal processor for this type.
Method ​_cached​_result​_processor Return a dialect-specific result processor for this type.
Method ​_compare​_type​_affinity Undocumented
Method ​_default​_dialect Undocumented
Method ​_dialect​_info Return a dialect-specific registry which caches a dialect-specific implementation, bind processing function, and one or more result processing functions.
Method ​_gen​_dialect​_impl Undocumented
Method ​_resolve​_for​_literal adjust this type given a literal Python value that will be stored in a bound parameter.
Method ​_unwrapped​_dialect​_impl Return the 'unwrapped' dialect impl for this type.
Method copy Undocumented
Method copy​_value Undocumented
Class Variable ​_is​_array Undocumented
Class Variable ​_is​_table​_value Undocumented
Class Variable ​_is​_tuple​_type Undocumented
Class Variable ​_is​_type​_decorator Undocumented
Class Variable ​_isnull Undocumented
Class Variable ​_sqla​_type Undocumented
Property ​_generic​_type​_affinity Undocumented
Property ​_has​_bind​_expression memoized boolean, check if bind_expression is implemented.
Property ​_has​_column​_expression memoized boolean, check if column_expression is implemented.
Property ​_static​_cache​_key Undocumented

Inherited from Traversible (via _AbstractInterval, TypeEngine):

Method get​_children Return immediate child .visitors.Traversible elements of this .visitors.Traversible.
Method __class​_getitem__ Undocumented
@classmethod
def adapt_emulated_to_native(cls, interval, **kw):

Given an impl, adapt this type's class to the impl assuming "native".

The impl will be an .Emulated class but not a .NativeForEmulated.

e.g.: postgresql.ENUM produces a type given an Enum instance.

def __init__(self, precision=None, fields=None):
Construct an INTERVAL.
Parameters
precisionoptional integer precision value
fields

string fields specifier. allows storage of fields to be limited, such as "YEAR", "MONTH", "DAY TO HOUR", etc.

New in version 1.2.
def as_generic(self, allow_nulltype=False):

Return an instance of the generic type corresponding to this type using heuristic rule. The method may be overridden if this heuristic rule is not sufficient.

>>> from sqlalchemy.dialects.mysql import INTEGER
>>> INTEGER(display_width=4).as_generic()
Integer()
>>> from sqlalchemy.dialects.mysql import NVARCHAR
>>> NVARCHAR(length=100).as_generic()
Unicode(length=100)
New in version 1.4.0b2.

See Also

:ref:`metadata_reflection_dbagnostic_types` - describes the use of _types.TypeEngine.as_generic in conjunction with the _sql.DDLEvents.column_reflect event, which is its intended use.

def coerce_compared_value(self, op, value):
See .TypeEngine.coerce_compared_value for a description.
__visit_name__: str =

Undocumented

native: bool =

Undocumented

fields =

Undocumented

precision =

Undocumented

@property
_type_affinity =
Return a rudimental 'affinity' value expressing the general class of type.
@property
python_type =

Return the Python type object expected to be returned by instances of this type, if known.

Basically, for those types which enforce a return type, or are known across the board to do such for all common DBAPIs (like int for example), will return that type.

If a return type is not defined, raises NotImplementedError.

Note that any type also accommodates NULL in SQL which means you can also get back None from any type in practice.