
.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "gallery/ticks/date_formatters_locators.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. meta::
        :keywords: codex

    .. note::
        :class: sphx-glr-download-link-note

        :ref:`Go to the end <sphx_glr_download_gallery_ticks_date_formatters_locators.py>`
        to download the full example code

.. rst-class:: sphx-glr-example-title

.. _sphx_glr_gallery_ticks_date_formatters_locators.py:


=================================
Date tick locators and formatters
=================================

This example illustrates the usage and effect of the various date locators and
formatters.

.. GENERATED FROM PYTHON SOURCE LINES 9-37

.. code-block:: Python


    import matplotlib.pyplot as plt
    import numpy as np

    from matplotlib.dates import (FR, MO, MONTHLY, SA, SU, TH, TU, WE,
                                  AutoDateFormatter, AutoDateLocator,
                                  ConciseDateFormatter, DateFormatter, DayLocator,
                                  HourLocator, MicrosecondLocator, MinuteLocator,
                                  MonthLocator, RRuleLocator, SecondLocator,
                                  WeekdayLocator, YearLocator, rrulewrapper)
    import matplotlib.ticker as ticker


    def plot_axis(ax, locator=None, xmax='2002-02-01', fmt=None, formatter=None):
        """Set up common parameters for the Axes in the example."""
        ax.spines[['left', 'right', 'top']].set_visible(False)
        ax.yaxis.set_major_locator(ticker.NullLocator())
        ax.tick_params(which='major', width=1.00, length=5)
        ax.tick_params(which='minor', width=0.75, length=2.5)
        ax.set_xlim(np.datetime64('2000-02-01'), np.datetime64(xmax))
        if locator:
            ax.xaxis.set_major_locator(eval(locator))
            ax.xaxis.set_major_formatter(DateFormatter(fmt))
        else:
            ax.xaxis.set_major_formatter(eval(formatter))
        ax.text(0.0, 0.2, locator or formatter, transform=ax.transAxes,
                fontsize=14, fontname='Monospace', color='tab:blue')








.. GENERATED FROM PYTHON SOURCE LINES 38-40

:ref:`date-locators`
--------------------

.. GENERATED FROM PYTHON SOURCE LINES 40-63

.. code-block:: Python



    locators = [
        # locator as str, xmax, fmt
        ('AutoDateLocator(maxticks=8)', '2003-02-01', '%Y-%m'),
        ('YearLocator(month=4)', '2003-02-01', '%Y-%m'),
        ('MonthLocator(bymonth=[4, 8, 12])', '2003-02-01', '%Y-%m'),
        ('DayLocator(interval=180)', '2003-02-01', '%Y-%m-%d'),
        ('WeekdayLocator(byweekday=SU, interval=4)', '2000-07-01', '%a %Y-%m-%d'),
        ('HourLocator(byhour=range(0, 24, 6))', '2000-02-04', '%H h'),
        ('MinuteLocator(interval=15)', '2000-02-01 02:00', '%H:%M'),
        ('SecondLocator(bysecond=(0, 30))', '2000-02-01 00:02', '%H:%M:%S'),
        ('MicrosecondLocator(interval=1000)', '2000-02-01 00:00:00.005', '%S.%f'),
        ('RRuleLocator(rrulewrapper(freq=MONTHLY, \nbyweekday=(MO, TU, WE, TH, FR), '
         'bysetpos=-1))', '2000-07-01', '%Y-%m-%d'),
    ]

    fig, axs = plt.subplots(len(locators), 1, figsize=(8, len(locators) * .8),
                            layout='constrained')
    fig.suptitle('Date Locators')
    for ax, (locator, xmax, fmt) in zip(axs, locators):
        plot_axis(ax, locator, xmax, fmt)




.. image-sg:: /gallery/ticks/images/sphx_glr_date_formatters_locators_001.png
   :alt: Date Locators
   :srcset: /gallery/ticks/images/sphx_glr_date_formatters_locators_001.png, /gallery/ticks/images/sphx_glr_date_formatters_locators_001_2_00x.png 2.00x
   :class: sphx-glr-single-img





.. GENERATED FROM PYTHON SOURCE LINES 64-66

:ref:`date-formatters`
----------------------

.. GENERATED FROM PYTHON SOURCE LINES 66-80

.. code-block:: Python


    formatters = [
        'AutoDateFormatter(ax.xaxis.get_major_locator())',
        'ConciseDateFormatter(ax.xaxis.get_major_locator())',
        'DateFormatter("%b %Y")',
    ]

    fig, axs = plt.subplots(len(formatters), 1, figsize=(8, len(formatters) * .8),
                            layout='constrained')
    fig.suptitle('Date Formatters')
    for ax, fmt in zip(axs, formatters):
        plot_axis(ax, formatter=fmt)





.. image-sg:: /gallery/ticks/images/sphx_glr_date_formatters_locators_002.png
   :alt: Date Formatters
   :srcset: /gallery/ticks/images/sphx_glr_date_formatters_locators_002.png, /gallery/ticks/images/sphx_glr_date_formatters_locators_002_2_00x.png 2.00x
   :class: sphx-glr-single-img





.. GENERATED FROM PYTHON SOURCE LINES 81-100

.. admonition:: References

   The use of the following functions, methods, classes and modules is shown
   in this example:

   - `matplotlib.dates.AutoDateLocator`
   - `matplotlib.dates.YearLocator`
   - `matplotlib.dates.MonthLocator`
   - `matplotlib.dates.DayLocator`
   - `matplotlib.dates.WeekdayLocator`
   - `matplotlib.dates.HourLocator`
   - `matplotlib.dates.MinuteLocator`
   - `matplotlib.dates.SecondLocator`
   - `matplotlib.dates.MicrosecondLocator`
   - `matplotlib.dates.RRuleLocator`
   - `matplotlib.dates.rrulewrapper`
   - `matplotlib.dates.DateFormatter`
   - `matplotlib.dates.AutoDateFormatter`
   - `matplotlib.dates.ConciseDateFormatter`


.. rst-class:: sphx-glr-timing

   **Total running time of the script:** (0 minutes 1.499 seconds)


.. _sphx_glr_download_gallery_ticks_date_formatters_locators.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download Jupyter notebook: date_formatters_locators.ipynb <date_formatters_locators.ipynb>`

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download Python source code: date_formatters_locators.py <date_formatters_locators.py>`

    .. container:: sphx-glr-download sphx-glr-download-zip

      :download:`Download zipped: date_formatters_locators.zip <date_formatters_locators.zip>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_
