W3cubDocs

/pandas 0.23

pandas.api.types.is_datetimetz

pandas.api.types.is_datetimetz(arr) [source]

Check whether an array-like is a datetime array-like with a timezone component in its dtype.

Parameters:

arr : array-like

The array-like to check.

Returns:

boolean : Whether or not the array-like is a datetime array-like with

a timezone component in its dtype.

Examples

>>> is_datetimetz([1, 2, 3])
False

Although the following examples are both DatetimeIndex objects, the first one returns False because it has no timezone component unlike the second one, which returns True.

>>> is_datetimetz(pd.DatetimeIndex([1, 2, 3]))
False
>>> is_datetimetz(pd.DatetimeIndex([1, 2, 3], tz="US/Eastern"))
True

The object need not be a DatetimeIndex object. It just needs to have a dtype which has a timezone component.

>>> dtype = DatetimeTZDtype("ns", tz="US/Eastern")
>>> s = pd.Series([], dtype=dtype)
>>> is_datetimetz(s)
True

© 2008–2012, AQR Capital Management, LLC, Lambda Foundry, Inc. and PyData Development Team
Licensed under the 3-clause BSD License.
http://pandas.pydata.org/pandas-docs/version/0.23.4/generated/pandas.api.types.is_datetimetz.html