Make pytz optional, docs

.circleci/config.yml

@@ -34,7 +34,7 @@ jobs:
  /opt/python/cp311-cp311/bin/python -m venv ~/virtualenvs/pandas-dev
  . ~/virtualenvs/pandas-dev/bin/activate
  python -m pip install --no-cache-dir -U pip wheel setuptools meson-python==0.13.1 meson[ninja]==1.2.1
- python -m pip install --no-cache-dir versioneer[toml] cython numpy python-dateutil pytz pytest>=7.3.2 pytest-xdist>=2.2.0 hypothesis>=6.46.1
+ python -m pip install --no-cache-dir versioneer[toml] cython numpy python-dateutil pytest>=7.3.2 pytest-xdist>=2.2.0 hypothesis>=6.46.1
  python -m pip install --no-cache-dir --no-build-isolation -e . --config-settings=setup-args="--werror"
  python -m pip list --no-cache-dir
  - run: |

.github/workflows/unit-tests.yml

@@ -274,7 +274,7 @@ jobs:
  . ~/virtualenvs/pandas-dev/bin/activate
  python -m pip install --no-cache-dir -U pip wheel setuptools meson[ninja]==1.2.1 meson-python==0.13.1
  python -m pip install numpy --config-settings=setup-args="-Dallow-noblas=true"
- python -m pip install --no-cache-dir versioneer[toml] cython python-dateutil pytz pytest>=7.3.2 pytest-xdist>=2.2.0 hypothesis>=6.46.1
+ python -m pip install --no-cache-dir versioneer[toml] cython python-dateutil pytest>=7.3.2 pytest-xdist>=2.2.0 hypothesis>=6.46.1
  python -m pip install --no-cache-dir --no-build-isolation -e . --config-settings=setup-args="--werror"
  python -m pip list --no-cache-dir
  export PANDAS_CI=1
@@ -312,7 +312,7 @@ jobs:
  /opt/python/cp311-cp311/bin/python -m venv ~/virtualenvs/pandas-dev
  . ~/virtualenvs/pandas-dev/bin/activate
  python -m pip install --no-cache-dir -U pip wheel setuptools meson-python==0.13.1 meson[ninja]==1.2.1
- python -m pip install --no-cache-dir versioneer[toml] cython numpy python-dateutil pytz pytest>=7.3.2 pytest-xdist>=2.2.0 hypothesis>=6.46.1
+ python -m pip install --no-cache-dir versioneer[toml] cython numpy python-dateutil pytest>=7.3.2 pytest-xdist>=2.2.0 hypothesis>=6.46.1
  python -m pip install --no-cache-dir --no-build-isolation -e . --config-settings=setup-args="--werror"
  python -m pip list --no-cache-dir
 
@@ -333,7 +333,7 @@ jobs:
  # In general, this will remain frozen(present, but not running) until:
  # - The next unreleased Python version has released beta 1
  # - This version should be available on GitHub Actions.
- # - Our required build/runtime dependencies(numpy, pytz, Cython, python-dateutil)
+ # - Our required build/runtime dependencies(numpy, Cython, python-dateutil)
  # support that unreleased Python version.
  # To unfreeze, comment out the ``if: false`` condition, and make sure you update
  # the name of the workflow and Python version in actions/setup-python ``python-version:``
@@ -385,7 +385,7 @@ jobs:
  python -m pip install --upgrade pip setuptools wheel meson[ninja]==1.2.1 meson-python==0.13.1
  python -m pip install --pre --extra-index-url https://pypi.anaconda.org/scientific-python-nightly-wheels/simple numpy
  python -m pip install versioneer[toml]
- python -m pip install python-dateutil pytz tzdata cython hypothesis>=6.46.1 pytest>=7.3.2 pytest-xdist>=2.2.0 pytest-cov
+ python -m pip install python-dateutil tzdata cython hypothesis>=6.46.1 pytest>=7.3.2 pytest-xdist>=2.2.0 pytest-cov
  python -m pip install -ve . --no-build-isolation --no-index --no-deps --config-settings=setup-args="--werror"
  python -m pip list
 

README.md

@@ -114,7 +114,6 @@ details, see the commit logs at https://github.com/pandas-dev/pandas.
 ## Dependencies
 - [NumPy - Adds support for large, multi-dimensional arrays, matrices and high-level mathematical functions to operate on these arrays](https://www.numpy.org)
 - [python-dateutil - Provides powerful extensions to the standard datetime module](https://dateutil.readthedocs.io/en/stable/index.html)
-- [pytz - Brings the Olson tz database into Python which allows accurate and cross platform timezone calculations](https://github.com/stub42/pytz)
 
 See the [full installation instructions](https://pandas.pydata.org/pandas-docs/stable/install.html#dependencies) for minimum supported versions of required, recommended and optional dependencies.
 

ci/deps/actions-310.yaml

@@ -21,7 +21,6 @@ dependencies:
  # required dependencies
  - python-dateutil
  - numpy
- - pytz
 
  # optional dependencies
  - beautifulsoup4>=4.11.2
@@ -47,6 +46,7 @@ dependencies:
  - pyreadstat>=1.2.0
  - pytables>=3.8.0
  - python-calamine>=0.1.7
+ - pytz>=2020.1
  - pyxlsb>=1.0.10
  - s3fs>=2022.11.0
  - scipy>=1.10.0

ci/deps/actions-311-downstream_compat.yaml

@@ -22,7 +22,6 @@ dependencies:
  # required dependencies
  - python-dateutil
  - numpy
- - pytz
 
  # optional dependencies
  - beautifulsoup4>=4.11.2
@@ -48,6 +47,7 @@ dependencies:
  - pyreadstat>=1.2.0
  - pytables>=3.8.0
  - python-calamine>=0.1.7
+ - pytz>=2020.1
  - pyxlsb>=1.0.10
  - s3fs>=2022.11.0
  - scipy>=1.10.0

ci/deps/actions-311-numpydev.yaml

@@ -21,7 +21,6 @@ dependencies:
 
  # pandas dependencies
  - python-dateutil
- - pytz
  - pip
 
  - pip:

ci/deps/actions-311-pyarrownightly.yaml

@@ -19,7 +19,6 @@ dependencies:
  # required dependencies
  - python-dateutil
  - numpy
- - pytz
  - pip
 
  - pip:

ci/deps/actions-311-sanitizers.yaml

@@ -23,7 +23,6 @@ dependencies:
  # required dependencies
  - python-dateutil
  - numpy
- - pytz
 
  # pandas dependencies
  - pip

ci/deps/actions-311.yaml

@@ -21,7 +21,6 @@ dependencies:
  # required dependencies
  - python-dateutil
  - numpy
- - pytz
 
  # optional dependencies
  - beautifulsoup4>=4.11.2
@@ -47,6 +46,7 @@ dependencies:
  - pyreadstat>=1.2.0
  - pytables>=3.8.0
  - python-calamine>=0.1.7
+ - pytz>=2020.1
  - pyxlsb>=1.0.10
  - s3fs>=2022.11.0
  - scipy>=1.10.0

ci/deps/actions-312.yaml

@@ -21,7 +21,6 @@ dependencies:
  # required dependencies
  - python-dateutil
  - numpy
- - pytz
 
  # optional dependencies
  - beautifulsoup4>=4.11.2
@@ -47,6 +46,7 @@ dependencies:
  - pyreadstat>=1.2.0
  # - pytables>=3.8.0
  - python-calamine>=0.1.7
+ - pytz>=2020.1
  - pyxlsb>=1.0.10
  - s3fs>=2022.11.0
  - scipy>=1.10.0

ci/deps/actions-39-minimum_versions.yaml

@@ -23,7 +23,6 @@ dependencies:
  # required dependencies
  - python-dateutil=2.8.2
  - numpy=1.23.5
- - pytz=2020.1
 
  # optional dependencies
  - beautifulsoup4=4.11.2
@@ -49,6 +48,7 @@ dependencies:
  - pyreadstat=1.2.0
  - pytables=3.8.0
  - python-calamine=0.1.7
+ - pytz=2020.1
  - pyxlsb=1.0.10
  - s3fs=2022.11.0
  - scipy=1.10.0

ci/deps/actions-39.yaml

@@ -21,7 +21,6 @@ dependencies:
  # required dependencies
  - python-dateutil
  - numpy
- - pytz
 
  # optional dependencies
  - beautifulsoup4>=4.11.2
@@ -47,6 +46,7 @@ dependencies:
  - pyreadstat>=1.2.0
  - pytables>=3.8.0
  - python-calamine>=0.1.7
+ - pytz>=2020.1
  - pyxlsb>=1.0.10
  - s3fs>=2022.11.0
  - scipy>=1.10.0

ci/deps/actions-pypy-39.yaml

@@ -22,6 +22,5 @@ dependencies:
  # required
  - numpy
  - python-dateutil
- - pytz
  - pip:
  - tzdata>=2022.7

ci/deps/circle-310-arm64.yaml

@@ -21,7 +21,6 @@ dependencies:
  # required dependencies
  - python-dateutil
  - numpy
- - pytz
 
  # optional dependencies
  - beautifulsoup4>=4.11.2
@@ -47,6 +46,7 @@ dependencies:
  - pyreadstat>=1.2.0
  - pytables>=3.8.0
  - python-calamine>=0.1.7
+ - pytz>=2020.1
  - pyxlsb>=1.0.10
  - s3fs>=2022.11.0
  - scipy>=1.10.0

ci/meta.yaml

@@ -37,7 +37,6 @@ requirements:
  - numpy >=1.21.6 # [py<311]
  - numpy >=1.23.2 # [py>=311]
  - python-dateutil >=2.8.2
- - pytz >=2020.1
  - python-tzdata >=2022.7
 
 test:

doc/source/getting_started/install.rst

@@ -205,7 +205,6 @@ Package Minimum support
 ================================================================ ==========================
 `NumPy <https://numpy.org>`__ 1.23.5
 `python-dateutil <https://dateutil.readthedocs.io/en/stable/>`__ 2.8.2
-`pytz <https://pypi.org/project/pytz/>`__ 2020.1
 `tzdata <https://pypi.org/project/tzdata/>`__ 2022.7
 ================================================================ ==========================
 
@@ -428,3 +427,14 @@ Dependency Minimum Version pip extra Notes
 ========================= ================== =================== =============================================================
 dataframe-api-compat 0.1.7 consortium-standard Consortium Standard-compatible implementation based on pandas
 ========================= ================== =================== =============================================================
+
+Timezone
+^^^^^^^^
+
+Installable with ``pip install "pandas[timezone]"``
+
+========================= ================== =================== =============================================================
+Dependency Minimum Version pip extra Notes
+========================= ================== =================== =============================================================
+pytz 2020.1 timezone Alternative timezone library to ``zoneinfo``.
+========================= ================== =================== =============================================================

doc/source/user_guide/io.rst

@@ -5096,7 +5096,7 @@ Caveats
  convenience you can use ``store.flush(fsync=True)`` to do this for you.
 * Once a ``table`` is created columns (DataFrame)
  are fixed; only exactly the same columns can be appended
-* Be aware that timezones (e.g., ``pytz.timezone('US/Eastern')``)
+* Be aware that timezones (e.g., ``zoneinfo.ZoneInfo('US/Eastern')``)
  are not necessarily equal across timezone versions. So if data is
  localized to a specific timezone in the HDFStore using one version
  of a timezone library and that data is updated with another version, the data

doc/source/user_guide/timeseries.rst

@@ -2358,9 +2358,9 @@ To return ``dateutil`` time zone objects, append ``dateutil/`` before the string
 
  import dateutil
 
- # pytz
- rng_pytz = pd.date_range("3/6/2012 00:00", periods=3, freq="D", tz="Europe/London")
- rng_pytz.tz
+ # zoneinfo
+ rng_zinfo = pd.date_range("3/6/2012 00:00", periods=3, freq="D", tz="Europe/London")
+ rng_zinfo.tz
 
  # dateutil
  rng_dateutil = pd.date_range("3/6/2012 00:00", periods=3, freq="D")

environment.yml

@@ -23,7 +23,6 @@ dependencies:
  # required dependencies
  - python-dateutil
  - numpy<2
- - pytz
 
  # optional dependencies
  - beautifulsoup4>=4.11.2
@@ -49,6 +48,7 @@ dependencies:
  - pyreadstat>=1.2.0
  - pytables>=3.8.0
  - python-calamine>=0.1.7
+ - pytz>=2020.1
  - pyxlsb>=1.0.10
  - s3fs>=2022.11.0
  - scipy>=1.10.0

pandas/__init__.py

@@ -6,7 +6,7 @@
 __docformat__ = "restructuredtext"
 
 # Let users know if they're missing any of our hard dependencies
-_hard_dependencies = ("numpy", "pytz", "dateutil")
+_hard_dependencies = ("numpy", "dateutil")
 _missing_dependencies = []
 
 for _dependency in _hard_dependencies:

pandas/_testing/_hypothesis.py

@@ -5,7 +5,6 @@
 
 from hypothesis import strategies as st
 from hypothesis.extra.dateutil import timezones as dateutil_timezones
-from hypothesis.extra.pytz import timezones as pytz_timezones
 
 from pandas.compat import is_platform_windows
 
@@ -56,7 +55,7 @@
 DATETIME_JAN_1_1900_OPTIONAL_TZ = st.datetimes(
  min_value=pd.Timestamp(1900, 1, 1).to_pydatetime(), # pyright: ignore[reportGeneralTypeIssues]
  max_value=pd.Timestamp(1900, 1, 1).to_pydatetime(), # pyright: ignore[reportGeneralTypeIssues]
- timezones=st.one_of(st.none(), dateutil_timezones(), pytz_timezones()),
+ timezones=st.one_of(st.none(), dateutil_timezones(), st.timezones()),
 )
 
 DATETIME_IN_PD_TIMESTAMP_RANGE_NO_TZ = st.datetimes(

pandas/compat/_optional.py

@@ -43,6 +43,7 @@
  "pyarrow": "10.0.1",
  "pyreadstat": "1.2.0",
  "pytest": "7.3.2",
+ "pytz": "2020.1",
  "python-calamine": "0.1.7",
  "pyxlsb": "1.0.10",
  "s3fs": "2022.11.0",

pandas/core/arrays/datetimes.py

@@ -593,7 +593,7 @@ def tz(self) -> tzinfo | None:
 
  Returns
  -------
- datetime.tzinfo, pytz.tzinfo.BaseTZInfo, dateutil.tz.tz.tzfile, or None
+ zoneinfo.ZoneInfo, datetime.tzinfo, pytz.tzinfo.BaseTZInfo, dateutil.tz.tz.tzfile, or None
  Returns None when the array is tz-naive.
 
  Examples
@@ -615,7 +615,7 @@ def tz(self) -> tzinfo | None:
  ... "2/1/2020 11:00:00+00:00"])
  >>> idx.tz
  datetime.timezone.utc
- """
+ """ # noqa: E501
  # GH 18595
  return getattr(self.dtype, "tz", None)
 
@@ -863,7 +863,7 @@ def tz_convert(self, tz) -> Self:
 
  Parameters
  ----------
- tz : str, pytz.timezone, dateutil.tz.tzfile, datetime.tzinfo or None
+ tz : str, zoneinfo.ZoneInfo, pytz.timezone, dateutil.tz.tzfile, datetime.tzinfo or None
  Time zone for time. Corresponding timestamps would be converted
  to this time zone of the Datetime Array/Index. A `tz` of None will
  convert to UTC and remove the timezone information.
@@ -920,7 +920,7 @@ def tz_convert(self, tz) -> Self:
  '2014-08-01 08:00:00',
  '2014-08-01 09:00:00'],
  dtype='datetime64[ns]', freq='h')
- """
+ """ # noqa: E501
  tz = timezones.maybe_get_tz(tz)
 
  if self.tz is None:
@@ -952,7 +952,7 @@ def tz_localize(
 
  Parameters
  ----------
- tz : str, pytz.timezone, dateutil.tz.tzfile, datetime.tzinfo or None
+ tz : str, zoneinfo.ZoneInfo, pytz.timezone, dateutil.tz.tzfile, datetime.tzinfo or None
  Time zone to convert timestamps to. Passing ``None`` will
  remove the time zone information preserving local time.
  ambiguous : 'infer', 'NaT', bool array, default 'raise'
@@ -1078,7 +1078,7 @@ def tz_localize(
  0 2015-03-29 03:30:00+02:00
  1 2015-03-29 03:30:00+02:00
  dtype: datetime64[ns, Europe/Warsaw]
- """
+ """ # noqa: E501
  nonexistent_options = ("raise", "NaT", "shift_forward", "shift_backward")
  if nonexistent not in nonexistent_options and not isinstance(
  nonexistent, timedelta

pandas/util/_print_versions.py

@@ -67,7 +67,6 @@ def _get_dependency_info() -> dict[str, JSONSerializable]:
  "pandas",
  # required
  "numpy",
- "pytz",
  "dateutil",
  # install / build,
  "setuptools",

pyproject.toml

@@ -33,7 +33,6 @@ dependencies = [
  "numpy>=1.23.5; python_version<'3.12'",
  "numpy>=1.26.0; python_version>='3.12'",
  "python-dateutil>=2.8.2",
- "pytz>=2020.1",
  "tzdata>=2022.7"
 ]
 classifiers = [
@@ -85,6 +84,7 @@ output-formatting = ['jinja2>=3.1.2', 'tabulate>=0.9.0']
 clipboard = ['PyQt5>=5.15.9', 'qtpy>=2.3.0']
 compression = ['zstandard>=0.19.0']
 consortium-standard = ['dataframe-api-compat>=0.1.7']
+timezone = ['pytz>=2020.1']
 all = ['adbc-driver-postgresql>=0.8.0',
  'adbc-driver-sqlite>=0.8.0',
  'beautifulsoup4>=4.11.2',
@@ -113,6 +113,7 @@ all = ['adbc-driver-postgresql>=0.8.0',
  'pytest>=7.3.2',
  'pytest-xdist>=2.2.0',
  'python-calamine>=0.1.7',
+ 'pytz>=2020.1',
  'pyxlsb>=1.0.10',
  'qtpy>=2.3.0',
  'scipy>=1.10.0',