pandas.api.types.is_datetime64tz_dtype#

pandas.api.types.is_datetime64tz_dtype(arr_or_dtype)[source]#

Check whether an array-like or dtype is of a DatetimeTZDtype dtype.

Deprecated since version 2.1.0: Use isinstance(dtype, pd.DatetimeTZDtype) instead.

Parameters:

arr_or_dtypearray-like or dtype: The array-like or dtype to check.

Returns:

boolean: Whether or not the array-like or dtype is of a DatetimeTZDtype dtype.

See also

api.types.is_datetime64_dtype: Check whether an array-like or dtype is of the datetime64 dtype.
api.types.is_datetime64_any_dtype: Check whether the provided array or dtype is of the datetime64 dtype.

Examples

>>> from pandas.api.types import is_datetime64tz_dtype
>>> is_datetime64tz_dtype(object)
False
>>> is_datetime64tz_dtype([1, 2, 3])
False
>>> is_datetime64tz_dtype(pd.DatetimeIndex([1, 2, 3]))  # tz-naive
False
>>> is_datetime64tz_dtype(pd.DatetimeIndex([1, 2, 3], tz="US/Eastern"))
True

>>> from pandas.core.dtypes.dtypes import DatetimeTZDtype
>>> dtype = DatetimeTZDtype("ns", tz="US/Eastern")
>>> s = pd.Series([], dtype=dtype)
>>> is_datetime64tz_dtype(dtype)
True
>>> is_datetime64tz_dtype(s)
True