OwlCyberSecurity - MANAGER
Edit File: dates.cpython-38.pyc
U ��]� � @ s d Z ddlZddlZddlZddlZddlZddlZddlZddlm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZmZ ddlmZ ddlZddl Zddl Z ddl Z ddl m Z ddl!m"Z" ddl#m$Z$ ddl%m&Z& dZ'e�(e)�Z*ej+j,Z-dd� Z.e/e�d d d ��0� �Z1d Z2ed Z3d Z4d Z5d Z6dZ7dZ8dZ9dZ:e5e4 Z;e6e5 Z<e<e4 Z=e=e8 Z>de= Z?e e e e eeef\Z@ZAZBZCZDZEZFe@eAeBeCeDeEeFfZGdd� ZHe �IeH�ZJdd� ZKdedd�ZLe �IeL�ZMe$jNddd�G d d � d eO��ZPe$jNddd�G d d � d eP��ZQe �IejRjS�ZTdfd d!�ZUd"d#� ZVd$d%� ZWd&d'� ZXdgd(d)�ZYd*d+� ZZe �IeZ�Z[d,d-� Z\d.d/� Z]G d0d1� d1e&j^�Z_G d2d3� d3e&j^�Z`G d4d5� d5e&j^�ZaG d6d7� d7e&j^�ZbG d8d9� d9eO�ZcG d:d;� d;e&jd�ZeG d<d=� d=ee�ZfG d>d?� d?ee�ZgG d@dA� dAee�ZhG dBdC� dCef�ZiG dDdE� dEef�ZjG dFdG� dGef�ZkG dHdI� dIef�ZlG dJdK� dKef�ZmG dLdM� dMef�ZnG dNdO� dOee�ZodPdQ� ZpdRdS� ZqdTdU� ZrdhdWdX�Zse$�Nd�dYdZ� �Zte$�Nd�d[d\� �Zue$�Nd�d]d^� �Zve$�Nd�d_d`� �ZwG dadb� dbe"jx�ZyG dcdd� ddey�Zzey� e"j{e j|< ey� e"j{ej}< ey� e"j{ej< dS )ia� Matplotlib provides sophisticated date plotting capabilities, standing on the shoulders of python :mod:`datetime` and the add-on module :mod:`dateutil`. .. _date-format: Matplotlib date format ---------------------- Matplotlib represents dates using floating point numbers specifying the number of days since 0001-01-01 UTC, plus 1. For example, 0001-01-01, 06:00 is 1.25, not 0.25. Values < 1, i.e. dates before 0001-01-01 UTC, are not supported. There are a number of helper functions to convert between :mod:`datetime` objects and Matplotlib dates: .. currentmodule:: matplotlib.dates .. autosummary:: :nosignatures: datestr2num date2num num2date num2timedelta epoch2num num2epoch mx2num drange .. note:: Like Python's datetime, mpl uses the Gregorian calendar for all conversions between dates and floating point numbers. This practice is not universal, and calendar differences can cause confusing differences between what Python and mpl give as the number of days since 0001-01-01 and what other software and databases yield. For example, the US Naval Observatory uses a calendar that switches from Julian to Gregorian in October, 1582. Hence, using their calculator, the number of days between 0001-01-01 and 2006-04-01 is 732403, whereas using the Gregorian calendar via the datetime module we find:: In [1]: date(2006, 4, 1).toordinal() - date(1, 1, 1).toordinal() Out[1]: 732401 All the Matplotlib date converters, tickers and formatters are timezone aware. If no explicit timezone is provided, :rc:`timezone` is assumed. If you want to use a custom time zone, pass a `datetime.tzinfo` instance with the tz keyword argument to `num2date`, `~.Axes.plot_date`, and any custom date tickers or locators you create. A wide range of specific and general purpose date tick locators and formatters are provided in this module. See :mod:`matplotlib.ticker` for general information on tick locators and formatters. These are described below. The dateutil_ module provides additional code to handle date ticking, making it easy to place ticks on any kinds of dates. See examples below. .. _dateutil: https://dateutil.readthedocs.io Date tickers ------------ Most of the date tickers can locate single or multiple values. For example:: # import constants for the days of the week from matplotlib.dates import MO, TU, WE, TH, FR, SA, SU # tick on mondays every week loc = WeekdayLocator(byweekday=MO, tz=tz) # tick on mondays and saturdays loc = WeekdayLocator(byweekday=(MO, SA)) In addition, most of the constructors take an interval argument:: # tick on mondays every second week loc = WeekdayLocator(byweekday=MO, interval=2) The rrule locator allows completely general date ticking:: # tick every 5th easter rule = rrulewrapper(YEARLY, byeaster=1, interval=5) loc = RRuleLocator(rule) The available date tickers are: * `MicrosecondLocator`: locate microseconds * `SecondLocator`: locate seconds * `MinuteLocator`: locate minutes * `HourLocator`: locate hours * `DayLocator`: locate specified days of the month * `WeekdayLocator`: Locate days of the week, e.g., MO, TU * `MonthLocator`: locate months, e.g., 7 for july * `YearLocator`: locate years that are multiples of base * `RRuleLocator`: locate using a `matplotlib.dates.rrulewrapper`. `.rrulewrapper` is a simple wrapper around dateutil_'s `dateutil.rrule` which allow almost arbitrary date tick specifications. See :doc:`rrule example </gallery/ticks_and_spines/date_demo_rrule>`. * `AutoDateLocator`: On autoscale, this class picks the best `DateLocator` (e.g., `RRuleLocator`) to set the view limits and the tick locations. If called with ``interval_multiples=True`` it will make ticks line up with sensible multiples of the tick intervals. E.g. if the interval is 4 hours, it will pick hours 0, 4, 8, etc as ticks. This behaviour is not guaranteed by default. Date formatters --------------- The available date formatters are: * `AutoDateFormatter`: attempts to figure out the best format to use. This is most useful when used with the `AutoDateLocator`. * `ConciseDateFormatter`: also attempts to figure out the best format to use, and to make the format as compact as possible while still having complete date information. This is most useful when used with the `AutoDateLocator`. * `DateFormatter`: use `strftime` format strings. * `IndexDateFormatter`: date plots with implicit *x* indexing. � N)�rrule�MO�TU�WE�TH�FR�SA�SU�YEARLY�MONTHLY�WEEKLY�DAILY�HOURLY�MINUTELY�SECONDLY)� relativedelta)�rcParams),� datestr2num�date2num�num2date� num2timedelta�drange� epoch2num� num2epoch�mx2num� DateFormatter�ConciseDateFormatter�IndexDateFormatter�AutoDateFormatter� DateLocator� RRuleLocator�AutoDateLocator� YearLocator� MonthLocator�WeekdayLocator� DayLocator� HourLocator� MinuteLocator� SecondLocator�MicrosecondLocatorr r r r r r r r r r r r r r r � MICROSECONDLYr �seconds�minutes�hours�weeksc C s" t jd } | dkrtS tj�| �S )z=Retrieve the preferred timezone from the rcParams dictionary.�timezone�UTC)� matplotlibr r0 �dateutil�tzZgettz��s� r6 �2/usr/lib/python3/dist-packages/matplotlib/dates.py�_get_rc_timezone� s r8 i� � g �PD:Ag 8@g N@g (@g @g >@g �v@� ��.Ac C s| t | dd�}|dk r"| �t�} t}t| �� �}t | ddd� �� }|dk rxtjd|d�}tj�||�}|| | �� t 7 }|S )z� Convert :mod:`datetime` or :mod:`date` to the Gregorian date as UTC float days, preserving hours, minutes, seconds and microseconds. Return value is a :func:`float`. �tzinfoN�datec S s d S �Nr6 r6 r6 r6 r7 �<lambda>� � z _to_ordinalf.<locals>.<lambda>r �r; ) �getattr� astimezoner0 �float� toordinal�datetime�timeZcombine� total_seconds� SEC_PER_DAY)�dtZtzi�baseZcdateZ midnight_timeZrdtr6 r6 r7 � _to_ordinalf� s rK c C s� | | � d� � d�}t�dd�}| � d�| � tj�}||� tj�d 7 }|t d }t�d�� tj�}| � tj�}ztj|||k< W n" tk r� ||kr�tj}Y nX |S )au Convert `numpy.datetime64` or an ndarray of those types to Gregorian date as UTC float. Roundoff is via float64 precision. Practically: microseconds for dates between 290301 BC, 294241 AD, milliseconds for larger dates (see `numpy.datetime64`). Nanoseconds aren't possible because we do times compared to ``0001-01-01T00:00:00`` (plus one day). z datetime64[s]ztimedelta64[ns]z0001-01-01T00:00:00r5 g e��A� �?ZNaT)�astype�np� datetime64Zfloat64rH Zint64�nan� TypeError)�dZextraZt0rI ZNaT_intZd_intr6 r6 r7 �_dt64_to_ordinalf� s rS c C s� |dkrt � }t| d�\}}t|�}|dk r:td�|���tj�|�jtd�}d}tt |t | �| �}| dk r�tt |t ��}|tj |d�7 }|� |�S )ax Convert Gregorian float of the date, preserving hours, minutes, seconds and microseconds. Return value is a `.datetime`. The input date *x* is a float in ordinal days at UTC, and the output will be the specified `.datetime` object corresponding to that time in timezone *tz*, or if *tz* is ``None``, in the timezone specified in :rc:`timezone`. Nr9 z|Cannot convert {} to a date. This often happens if non-datetime values are passed to an axis that expects datetime objects.r@ � i�* )Z microseconds) r8 �divmod�int� ValueError�formatrE Z fromordinal�replacer0 �round�MUSECONDS_PER_DAY� timedeltarB )�xr3 ZixZ remainderrI Z musec_precZremainder_musecr6 r6 r7 �_from_ordinalf s" ��r^ z3.1z5time.strptime or dateutil.parser.parse or datestr2num)Z alternativec @ s e Zd ZdZdd� Zdd� ZdS )� strpdate2numz� Use this class to parse date strings to matplotlib datenums when you know the date format string of the date you are parsing. c C s || _ dS )z- fmt: any valid strptime format is supported N)�fmt)�selfr` r6 r6 r7 �__init__@ s zstrpdate2num.__init__c C s t tjt�|| j�dd� � �S )zMs : string to be converted return value: a date2num float N� )r rE rF �strptimer` )ra r5 r6 r6 r7 �__call__D s zstrpdate2num.__call__N��__name__� __module__� __qualname__�__doc__rb re r6 r6 r6 r7 r_ 9 s r_ c s. e Zd ZdZd� fdd� Z� fdd�Z� ZS )�bytespdate2numz� Use this class to parse date strings to matplotlib datenums when you know the date format string of the date you are parsing. See :doc:`/gallery/misc/load_converter.py`. �utf-8c s t � �|� || _dS )z� Args: fmt: any valid strptime format is supported encoding: encoding to use on byte input (default: 'utf-8') N)�superrb �encoding)ra r` rn �� __class__r6 r7 rb S s zbytespdate2num.__init__c s |� | j�}t� �|�S )zo Args: b: byte input to be converted Returns: A date2num float )�decodern rm re )ra �br5 ro r6 r7 re \ s zbytespdate2num.__call__)rl )rg rh ri rj rb re � __classcell__r6 r6 ro r7 rk K s rk c s` t | t�r"tjj| � d�}t|�S � dk r<� fdd�| D �} t�| �} | jsP| S tt | ��S dS )a Convert a date string to a datenum using :func:`dateutil.parser.parse`. Parameters ---------- d : string or sequence of strings The dates to convert. default : datetime instance, optional The default date to use when fields are missing in *d*. ��defaultNc s g | ]}t jj|� d ��qS )rt )r2 �parser�parse��.0r5 rt r6 r7 � <listcomp>| s z datestr2num.<locals>.<listcomp>) � isinstance�strr2 rv rw r rN �asarray�size�$_dateutil_parser_parse_np_vectorized)rR ru rI r6 rt r7 r k s r c C s� t | d�r| j} t�| �sRt| tj�sBt| tj�rJt�| jtj�rJt | �S t | �S t� | �} t�| jtj�rtt | �S | j s~| S t | �S dS )a# Convert datetime objects to Matplotlib dates. Parameters ---------- d : `datetime.datetime` or `numpy.datetime64` or sequences of these Returns ------- float or sequence of floats Number of days (fraction part represents hours, minutes, seconds, ms) since 0001-01-01 00:00:00 UTC, plus one. Notes ----- The addition of one here is a historical artifact. Also, note that the Gregorian calendar is assumed; this is not universal practice. For details see the module docstring. �valuesN)�hasattrr� rN �iterabler{ rO �ndarrayZ issubdtypeZdtyperS rK r} r~ �_to_ordinalf_np_vectorized�rR r6 r6 r7 r � s �� r c C s t �| �rt �| �} | t S )z� Convert a Julian date (or sequence) to a Matplotlib date (or sequence). Parameters ---------- j : float or sequence of floats Julian date(s) Returns ------- float or sequence of floats Matplotlib date(s) �rN r� r} � JULIAN_OFFSET)�jr6 r6 r7 � julian2num� s r� c C s t �| �rt �| �} | t S )z� Convert a Matplotlib date (or sequence) to a Julian date (or sequence). Parameters ---------- n : float or sequence of floats Matplotlib date(s) Returns ------- float or sequence of floats Julian date(s) r� )�nr6 r6 r7 � num2julian� s r� c C sH |dkrt � }t�| �s"t| |�S t�| �} | js6| S t| |��� S dS )a Convert Matplotlib dates to `~datetime.datetime` objects. Parameters ---------- x : float or sequence of floats Number of days (fraction part represents hours, minutes, seconds) since 0001-01-01 00:00:00 UTC, plus one. tz : string, optional Timezone of *x* (defaults to rcparams ``timezone``). Returns ------- `~datetime.datetime` or sequence of `~datetime.datetime` Dates are returned in timezone *tz*. If *x* is a sequence, a sequence of :class:`datetime` objects will be returned. Notes ----- The addition of one here is a historical artifact. Also, note that the Gregorian calendar is assumed; this is not universal practice. For details, see the module docstring. N)r8 rN r� r^ r} r~ � _from_ordinalf_np_vectorized�tolist)r] r3 r6 r6 r7 r � s r c C s t j| d�S )N)�days)rE r\ �r] r6 r6 r7 �_ordinalf_to_timedelta� s r� c C s6 t �| �st| �S t �| �} | js&| S t| ��� S dS )a� Convert number of days to a `~datetime.timedelta` object. If *x* is a sequence, a sequence of `~datetime.timedelta` objects will be returned. Parameters ---------- x : float, sequence of floats Number of days. The fraction part represents hours, minutes, seconds. Returns ------- `datetime.timedelta` or list[`datetime.timedelta`] N)rN r� r� r} r~ �$_ordinalf_to_timedelta_np_vectorizedr� r� r6 r6 r7 r � s r c C sp t | �}t |�}|�� t }tt�|| | ��}| || }||krV||8 }|d8 }t |�}t�|||d �S )a� Return a sequence of equally spaced Matplotlib dates. The dates start at *dstart* and reach up to, but not including *dend*. They are spaced by *delta*. Parameters ---------- dstart, dend : `~datetime.datetime` The date limits. delta : `datetime.timedelta` Spacing of the dates. Returns ------- drange : `numpy.array` A list floats representing Matplotlib dates. r9 )r rG rH rV rN �ceilZlinspace)ZdstartZdend�delta�f1�f2�step�numZ dinterval_endr6 r6 r7 r s r c @ sp e Zd ZdZe�d�Zddd�Zddd�Zd d � Z e � d �d d � �Z e � d �ddd��Z e � d �ddd��ZdS )r zU Format a tick (in seconds since the epoch) with a `strftime` format string. z((^|[^%])(%%)*%s)Nc C s |dkrt � }|| _|| _dS )z| Parameters ---------- fmt : str `strftime` format string tz : `tzinfo` N)r8 r` r3 )ra r` r3 r6 r6 r7 rb G s zDateFormatter.__init__r c C s$ |dkrt d��t|| j��| j�S )Nr z�DateFormatter found a value of x=0, which is an illegal date; this usually occurs because you have not informed the axis that it is plotting dates, e.g., with ax.xaxis_date())rW r r3 �strftimer` )ra r] �posr6 r6 r7 re T s zDateFormatter.__call__c C s || _ d S r= �r3 �ra r3 r6 r6 r7 � set_tzinfo\ s zDateFormatter.set_tzinfoz3.0c C s� d}|� ||�}|dkrq�|d }|||t|� � |kr<q|d|� | ||t|� d� }|d|� | ||t|� d� }q||fS )a& Helper function for replacing substrings sub1 and sub2 located at the same indexes in strings s1 and s2 respectively, with the string replacement. It is expected that sub1 and sub2 have the same length. Returns the pair s1, s2 after the substitutions. r ���r9 N)�find�len)ra �s1�s2Zsub1Zsub2Z replacement�ir� r6 r6 r7 �_replace_common_substr_ s $&z$DateFormatter._replace_common_substrc C s |dkr| j }t�dd�|j�|�}|j}d| }d|d |d }|| }|d| d d }|d }|�� }t�||f|d d� �} t�||f|d d� �} | � | | d �|�d �|�d �|j��\} } | � | | d �|d �d �|d �d �|jd ��\} } t � | �S ) a{ Call time.strftime for years before 1900 by rolling forward a multiple of 28 years. *fmt* is a :func:`strftime` format string. Dalke: I hope I did this math right. Every 28 years the calendar repeats, except through century leap years excepting the 400 year leap years. But only if you're using the Gregorian calendar. Nz((^|[^%])(%%)*)%fz \g<1>{0:06d}�� rc �d � � r9 z{0:04d}z{0:02d}) r` �re�subrX � microsecond�year� timetuplerF r� r� �cbook� unicode_safe) ra rI r` r� r� ZoffZyear1Zyear2r� r� r� r6 r6 r7 �strftime_pre_1900y s4 � � �z DateFormatter.strftime_pre_1900c C sN |dkr| j }| j�d|�}|�dd�}|jdkrBt�|�|��S | �||�S )a{ Refer to documentation for :meth:`datetime.datetime.strftime` *fmt* is a :meth:`datetime.datetime.strftime` format string. Warning: For years before 1900, depending upon the current locale it is possible that the year displayed with %x might be incorrect. For years before 100, %y and %Y will yield zero-padded strings. Nz\1z%sr5 il ) r` � illegal_sr� rY r� r� r� r� r� )ra rI r` r6 r6 r7 r� � s zDateFormatter.strftime)N)r )N)N)rg rh ri rj r� �compiler� rb re r� r� � deprecatedr� r� r� r6 r6 r6 r7 r @ s 9r c @ s$ e Zd ZdZddd�Zd dd�ZdS ) r za Use with :class:`~matplotlib.ticker.IndexLocator` to cycle format strings by index. Nc C s$ |dkrt � }|| _|| _|| _dS )zw *t* is a sequence of dates (floating point days). *fmt* is a :func:`strftime` format string. N)r8 �tr` r3 )ra r� r` r3 r6 r6 r7 rb � s zIndexDateFormatter.__init__r c C sB t t�|��}|t| j�ks$|dkr(dS t| j| | j��| j�S )z/Return the label for time *x* at position *pos*r � ) rV rN rZ r� r� r r3 r� r` )ra r] r� Zindr6 r6 r7 re � s zIndexDateFormatter.__call__)N)r rf r6 r6 r6 r7 r � s r c @ s< e Zd ZdZddd�Zddd�Zdd � Zd d � Zd d � ZdS )r a This class attempts to figure out the best format to use for the date, and to make it as compact as possible, but still be complete. This is most useful when used with the :class:`AutoDateLocator`:: >>> locator = AutoDateLocator() >>> formatter = ConciseDateFormatter(locator) Parameters ---------- locator : `.ticker.Locator` Locator that this axis is using. tz : string, optional Passed to `.dates.date2num`. formats : list of 6 strings, optional Format strings for 6 levels of tick labelling: mostly years, months, days, hours, minutes, and seconds. Strings use the same format codes as `strftime`. Default is ``['%Y', '%b', '%d', '%H:%M', '%H:%M', '%S.%f']`` zero_formats : list of 6 strings, optional Format strings for tick labels that are "zeros" for a given tick level. For instance, if most ticks are months, ticks around 1 Jan 2005 will be labeled "Dec", "2005", "Feb". The default is ``['', '%Y', '%b', '%b-%d', '%H:%M', '%H:%M']`` offset_formats : list of 6 strings, optional Format strings for the 6 levels that is applied to the "offset" string found on the right side of an x-axis, or top of a y-axis. Combined with the tick labels this should completely specify the date. The default is:: ['', '%Y', '%Y-%b', '%Y-%b-%d', '%Y-%b-%d', '%Y-%b-%d %H:%M'] show_offset : bool Whether to show the offset or not. Default is ``True``. Examples -------- See :doc:`/gallery/ticks_and_spines/date_concise_formatter` .. plot:: import datetime import matplotlib.dates as mdates base = datetime.datetime(2005, 2, 1) dates = np.array([base + datetime.timedelta(hours=(2 * i)) for i in range(732)]) N = len(dates) np.random.seed(19680801) y = np.cumsum(np.random.randn(N)) fig, ax = plt.subplots(constrained_layout=True) locator = mdates.AutoDateLocator() formatter = mdates.ConciseDateFormatter(locator) ax.xaxis.set_major_locator(locator) ax.xaxis.set_major_formatter(formatter) ax.plot(dates, y) ax.set_title('Concise Date Formatter') NTc C s� || _ || _d| _|r2t|�dkr*td��|| _nddddddg| _|rdt|�dkr\td��|| _n<|r�d g| jd d � | _n d g| jd d � | _d | jd < |r�t|�dkr�td��|| _nd dddddg| _d | _|| _ d S )z� Autoformat the date labels. The default format is used to form an initial string, and then redundant elements are removed. �%Yrc z=formats argument must be a list of 6 format strings (or None)z%bz%dz%H:%Mz%S.%fzBzero_formats argument must be a list of 6 format strings (or None)r� Nr� z%b-%d� z@offsetfmts argument must be a list of 6 format strings (or None)z%Y-%bz%Y-%b-%dz%Y-%b-%d %H:%M) �_locator�_tz� defaultfmtr� rW �formats� zero_formats�offset_formats� offset_string� show_offset)ra �locatorr3 r� r� r� r� r6 r6 r7 rb ) sF � �z ConciseDateFormatter.__init__c C s t | j| j�}|||d�S )N)r� )r r� r� )ra r] r� � formatterr6 r6 r7 re b s z ConciseDateFormatter.__call__c C s� dd� |D �}t �dd� |D ��}| j}| j}| j}tddd�D ]&}tt �|d d �|f ��dkr@ qhq@dddddddg}dgt|� } tt|��D ]|} |dk r�|| | || kr�|| } q�|| } n6|| j|| j kr�dkr�n n || } n|| } || � | �| | < q�|dk�rvt d d � | D �d d �} | �rvtt| ��D ]0} d | | k�rD| | d | � � d �| | < �qD| j �r�|d � || �| _| S ) Nc S s g | ] }t |��qS r6 )r )ry �valuer6 r6 r7 rz g s z5ConciseDateFormatter.format_ticks.<locals>.<listcomp>c S s g | ]}|� � d d� �qS )Nrc )r� )ry Ztdtr6 r6 r7 rz h s � r� r9 r r� c s s, | ]$}d |krt |�t |�d�� V qdS )�.�0N)r� �rstriprx r6 r6 r7 � <genexpr>� s z4ConciseDateFormatter.format_ticks.<locals>.<genexpr>rt r� )rN Zarrayr� r� r� �ranger� �unique�secondr� r� �minr� r� r� ) ra r� Z tickdatetimeZtickdateZfmtsZzerofmtsZ offsetfmts�levelZzerovals�labelsZnnr` Ztrailing_zerosr6 r6 r7 � format_ticksf sB � � z!ConciseDateFormatter.format_ticksc C s | j S r= )r� �ra r6 r6 r7 � get_offset� s z ConciseDateFormatter.get_offsetc C s t |��d�S )Nz%Y-%m-%d %H:%M:%S)r r� )ra r� r6 r6 r7 �format_data_short� s z&ConciseDateFormatter.format_data_short)NNNNT)N) rg rh ri rj rb re r� r� r� r6 r6 r6 r7 r � s E � 9 ?r c @ s, e Zd ZdZd dd�Zdd� Zd dd �ZdS ) r an This class attempts to figure out the best format to use. This is most useful when used with the :class:`AutoDateLocator`. The AutoDateFormatter has a scale dictionary that maps the scale of the tick (the distance in days between one major tick) and a format string. The default looks like this:: self.scaled = { DAYS_PER_YEAR: rcParams['date.autoformat.year'], DAYS_PER_MONTH: rcParams['date.autoformat.month'], 1.0: rcParams['date.autoformat.day'], 1. / HOURS_PER_DAY: rcParams['date.autoformat.hour'], 1. / (MINUTES_PER_DAY): rcParams['date.autoformat.minute'], 1. / (SEC_PER_DAY): rcParams['date.autoformat.second'], 1. / (MUSECONDS_PER_DAY): rcParams['date.autoformat.microsecond'], } The algorithm picks the key in the dictionary that is >= the current scale and uses that format string. You can customize this dictionary by doing:: >>> locator = AutoDateLocator() >>> formatter = AutoDateFormatter(locator) >>> formatter.scaled[1/(24.*60.)] = '%M:%S' # only show min and sec A custom :class:`~matplotlib.ticker.FuncFormatter` can also be used. The following example shows how to use a custom format function to strip trailing zeros from decimal seconds and adds the date to the first ticklabel:: >>> def my_format_function(x, pos=None): ... x = matplotlib.dates.num2date(x) ... if pos == 0: ... fmt = '%D %H:%M:%S.%f' ... else: ... fmt = '%H:%M:%S.%f' ... label = x.strftime(fmt) ... label = label.rstrip("0") ... label = label.rstrip(".") ... return label >>> from matplotlib.ticker import FuncFormatter >>> formatter.scaled[1/(24.*60.)] = FuncFormatter(my_format_function) N�%Y-%m-%dc C sr || _ || _|| _t| j|�| _ttd ttd dtd dt td dt td dt td dt td i| _ d S ) z� Autoformat the date labels. The default format is the one to use if none of the values in ``self.scaled`` are greater than the unit returned by ``locator._get_unit()``. zdate.autoformatter.yearzdate.autoformatter.monthrL zdate.autoformatter.dayzdate.autoformatter.hourzdate.autoformatter.minutezdate.autoformatter.secondz date.autoformatter.microsecondN) r� r� r� r � _formatter� DAYS_PER_YEARr �DAYS_PER_MONTH� HOURS_PER_DAY�MINUTES_PER_DAYrH r[ �scaled)ra r� r3 r� r6 r6 r7 rb � s$ �zAutoDateFormatter.__init__c C s || _ d S r= )r� )ra r� r6 r6 r7 � _set_locator� s z AutoDateFormatter._set_locatorc s� zt | j�� �� W n tk r* d� Y nX t� fdd�t| j�� �D �| j�}t |t �rvt || j �| _ | � ||�}n"t|�r�|||�}ntd�| ���|S )Nr9 c 3 s | ]\}}|� kr|V qd S r= r6 )ry Zscaler` �Zlocator_unit_scaler6 r7 r� s �z-AutoDateFormatter.__call__.<locals>.<genexpr>z Unexpected type passed to {0!r}.)rC r� � _get_unit�AttributeError�next�sortedr� �itemsr� r{ r| r r� r� �callablerQ rX )ra r] r� r` �resultr6 r� r7 re � s � zAutoDateFormatter.__call__)Nr� )N)rg rh ri rj rb r� re r6 r6 r6 r7 r � s : r c @ sH e Zd Zddd�Zdd� Zdd� Zdd � Zdd d �Zd d� Zdd� Z dS )� rrulewrapperNc K s ||d< || _ | jf |� d S )N�freq)� _base_tzinfo� _update_rrule)ra r� r; �kwargsr6 r6 r7 rb s zrrulewrapper.__init__c K s | j �|� | jf | j � d S r= )� _construct�updater� )ra r� r6 r6 r7 �set s zrrulewrapper.setc K s� | j }d|krJ|d }|jd k rJ|d kr0|j}n |�|�}|jd d�|d< d|kr�|d }|jd k r�|d k rx|�|�}ntd��|jd d�|d< |�� | _|| _tf | j�| _ d S )N�dtstartr@ �untilz<until cannot be aware if dtstart is naive and tzinfo is None) r� r; rB rY rW �copyr� �_tzinfor �_rrule)ra r� r; r� r� r6 r6 r7 r� s$ zrrulewrapper._update_rrulec C s$ t |d�r|j|dd�S |j|d�S )N�localizeT�Zis_dstr@ )r� r� rY )ra rI r; r6 r6 r7 �_attach_tzinfo? s zrrulewrapper._attach_tzinfoFc sZ �j dkr� S �fdd���fdd��|s<� ��fdd�}n� ��fdd�}t�� �|�S ) z>Decorator function that allows rrule methods to handle tzinfo.Nc s> t | tj�r:| jd k r:| j� jk r.| �� j�} | jd d�S | S )Nr@ )r{ rE r; r� rB rY )�argr� r6 r7 � normalize_argN s z9rrulewrapper._aware_return_wrapper.<locals>.normalize_argc s4 t � fdd�| D ��} � fdd�|�� D �}| |fS )Nc 3 s | ]}� |�V qd S r= r6 )ry r� �r� r6 r7 r� X s zMrrulewrapper._aware_return_wrapper.<locals>.normalize_args.<locals>.<genexpr>c s i | ]\}}|� |��qS r6 r6 )ry �kwr� r� r6 r7 � <dictcomp>Y s zNrrulewrapper._aware_return_wrapper.<locals>.normalize_args.<locals>.<dictcomp>)�tupler� )�argsr� r� r6 r7 �normalize_argsW s z:rrulewrapper._aware_return_wrapper.<locals>.normalize_argsc s& �| |�\} }� | |�}�� |�j�S r= �r� r� )r� r� rI ��fr� ra r6 r7 � inner_func` s z6rrulewrapper._aware_return_wrapper.<locals>.inner_funcc s* �| |�\} }� | |�}�fdd�|D �S )Nc s g | ]}� � |� j��qS r6 r� )ry rI r� r6 r7 rz h s zJrrulewrapper._aware_return_wrapper.<locals>.inner_func.<locals>.<listcomp>r6 )r� r� Zdtsr� r6 r7 r� e s )r� � functools�wraps)ra r� � returns_listr� r6 )r� r� r� ra r7 �_aware_return_wrapperF s z"rrulewrapper._aware_return_wrapperc C sP || j kr| j | S t| j|�}|dkr2| �|�S |dkrH| j|dd�S |S d S )N> �after�before> �xbefore�between�xafterT)r� )�__dict__rA r� r )ra �namer� r6 r6 r7 � __getattr__l s zrrulewrapper.__getattr__c C s | j �|� d S r= )r r� )ra �stater6 r6 r7 � __setstate__y s zrrulewrapper.__setstate__)N)F) rg rh ri rb r� r� r� r r r r6 r6 r6 r7 r� s & r� c @ sV e Zd ZdZdddd�Zddd�Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dS )r z� Determines the tick locations when plotting dates. This class is subclassed by other Locators and is not meant to be used on its own. r )�byhour�byminute�bysecondNc C s |dkrt � }|| _dS )z5 *tz* is a :class:`tzinfo` instance. N)r8 r3 r� r6 r6 r7 rb � s zDateLocator.__init__c C s || _ dS )z% Set time zone info. Nr� r� r6 r6 r7 r� � s zDateLocator.set_tzinfoc C sN | j �� \}}||kr || }}|dk r6td�|���t|| j�t|| j�fS )zA Convert axis data interval to datetime objects. r9 z�datalim minimum {} is less than 1 and is an invalid Matplotlib date value. This often happens if you pass a non-datetime value to an axis that has datetime units)�axis�get_data_intervalrW rX r r3 �ra �dmin�dmaxr6 r6 r7 � datalim_to_dt� s �zDateLocator.datalim_to_dtc C sN | j �� \}}||kr || }}|dk r6td�|���t|| j�t|| j�fS )zA Converts the view interval to datetime objects. r9 z�view limit minimum {} is less than 1 and is an invalid Matplotlib date value. This often happens if you pass a non-datetime value to an axis that has datetime units)r �get_view_intervalrW rX r r3 �ra �vmin�vmaxr6 r6 r7 � viewlim_to_dt� s �zDateLocator.viewlim_to_dtc C s dS )�j Return how many days a unit of the locator is; used for intelligent autoscaling. r9 r6 r� r6 r6 r7 r� � s zDateLocator._get_unitc C s dS )�; Return the number of units for each tick. r9 r6 r� r6 r6 r7 � _get_interval� s zDateLocator._get_intervalc C sH | � � }| �� }t|| �dk r@|d| | 8 }|d| | 7 }||fS )z� Given the proposed upper and lower extent, adjust the range if it is too close to being singular (i.e. a range of ~0). g���ư>� )r� r �abs)ra r r �unit�intervalr6 r6 r7 � nonsingular� s zDateLocator.nonsingular)N) rg rh ri rj �hms0drb r� r r r� r r r6 r6 r6 r7 r } s r c @ sJ e Zd Zddd�Zdd� Zdd� Zdd � Zed d � �Zd d � Z dd� Z dS )r Nc C s t �| |� || _d S r= )r rb �rule)ra �or3 r6 r6 r7 rb � s zRRuleLocator.__init__c C s6 z| � � \}}W n tk r( g Y S X | �||�S r= �r rW � tick_valuesr r6 r6 r7 re � s zRRuleLocator.__call__c C s� t ||�}z || }W n ttfk r6 td�}Y nX z || }W n ttfk rd td�}Y nX | jj||d� | j�||d�}t|�dkr�t||g�S | � t|��S )NrL �)�����KA�r� r� Tr ) r rW � OverflowErrorr^ r" r� r r� r Zraise_if_exceeds)ra r r r� �start�stopZdatesr6 r6 r7 r% � s zRRuleLocator.tick_valuesc C s | j jj}| �|�S )r )r" r� �_freq�get_unit_generic)ra r� r6 r6 r7 r� � s zRRuleLocator._get_unitc C sh | t kr tS | tkrtS | tkr$tS | tkr0dS | tkr@dt S | t krPdt S | t kr`dt S dS d S )NrL r� ) r r� r r� r � DAYS_PER_WEEKr r r� r r� r rH )r� r6 r6 r7 r, � s z RRuleLocator.get_unit_genericc C s | j jjS r= )r" r� � _intervalr� r6 r6 r7 r s zRRuleLocator._get_intervalc C s� | � � \}}t||�}z || }W n tk r> td�}Y nX z || }W n tk rh td�}Y nX | jj||d� | � � \}}| j�|d�}|s�|}| j�|d�}|s�|}t|�}t|�}| � ||�S )�@ Set the view limits to include the data range. rL r& r' T) r r rW r^ r" r� r r r r )ra r r r� r) r* r r r6 r6 r7 � autoscale s* zRRuleLocator.autoscale)N) rg rh ri rb re r% r� � staticmethodr, r r0 r6 r6 r6 r7 r � s r c @ sZ e Zd ZdZddd�Zdd� Zd d � Zd d � Zd d� Zdd� Z dd� Z dd� Z dd� Z dS )r! z} On autoscale, this class picks the best :class:`DateLocator` to set the view limits and the tick locations. Nr� Tc C s� t �| |� t|d�| _t| _ttttt t t g| _ || _ tdtdtdtdt dt dt di| _|dk r�z| j�|� W n$ tk r� t�| j |�| _Y nX || _tdddd d d d d dddddddddgtdddddgtddddddgtddddddgt dd d d d gt dd d d d gt ddd d d d dddddddd d d d!d"d#gi| _|�rZddddddg| jt< dtdd$�tdd%�td&d'�td&d(�td&d(�dg| _dS ))a� *minticks* is the minimum number of ticks desired, which is used to select the type of ticking (yearly, monthly, etc.). *maxticks* is the maximum number of ticks desired, which controls any interval between ticks (ticking every other, every 3, etc.). For really fine-grained control, this can be a dictionary mapping individual rrule frequency constants (YEARLY, MONTHLY, etc.) to their own maximum number of ticks. This can be used to keep the number of ticks appropriate to the format chosen in :class:`AutoDateFormatter`. Any frequency not specified in this dictionary is given a default value. *tz* is a :class:`tzinfo` instance. *interval_multiples* is a boolean that indicates whether ticks should be chosen to be multiple of the interval. This will lock ticks to 'nicer' locations. For example, this will force the ticks to be at hours 0,6,12,18 when hourly ticking is done at 6 hour intervals. The AutoDateLocator has an interval dictionary that maps the frequency of the tick (a constant from dateutil.rrule) and a multiple allowed for that ticking. The default looks like this:: self.intervald = { YEARLY : [1, 2, 4, 5, 10, 20, 40, 50, 100, 200, 400, 500, 1000, 2000, 4000, 5000, 10000], MONTHLY : [1, 2, 3, 4, 6], DAILY : [1, 2, 3, 7, 14], HOURLY : [1, 2, 3, 4, 6, 12], MINUTELY: [1, 5, 10, 15, 30], SECONDLY: [1, 5, 10, 15, 30], MICROSECONDLY: [1, 2, 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000, 10000, 20000, 50000, 100000, 200000, 500000, 1000000], } The interval is used to specify multiples that are appropriate for the frequency of ticking. For instance, every 7 days is sensible for daily ticks, but for minutes/seconds, 15 or 30 make sense. You can customize this dictionary by doing:: locator = AutoDateLocator() locator.intervald[HOURLY] = [3] # only show every 3 hours r� � � � Nr9 r � r� � rT �( �2 r� �� r� i� �� r� i� i� i' r� rc � � � � � i N iP� i�� i@ i � i@B � � r � �< )r rb r" r� r r+ r r r r r r* �_freqs�minticks�maxticksr� rQ �dict�fromkeys�interval_multiples� intervaldr� � _byranges)ra r3 rE rF rI r6 r6 r7 rb < sx 0 � � � �� �zAutoDateLocator.__init__c C s | � � | �� S )z!Return the locations of the ticks)�refreshr� r� r6 r6 r7 re � s zAutoDateLocator.__call__c C s | � ||��||�S r= )� get_locatorr% r r6 r6 r7 r% � s zAutoDateLocator.tick_valuesc C s( ||kr |t d }|t d }||fS )Nr )r� r r6 r6 r7 r � s zAutoDateLocator.nonsingularc C s t �| |� | j�|� d S r= )r �set_axisr� �ra r r6 r6 r7 rN � s zAutoDateLocator.set_axisc C s | � � \}}| �||�| _dS )z5Refresh internal information based on current limits.N)r rM r� r r6 r6 r7 rL � s zAutoDateLocator.refreshc C s$ | j tfkrdt S t�| j �S d S )NrL )r+ r* r[ r r, r� r6 r6 r7 r� � s zAutoDateLocator._get_unitc C s$ | � � \}}| �||�| _| j�� S )z,Try to choose the view limits intelligently.)r rM r� r0 r r6 r6 r7 r0 � s zAutoDateLocator.autoscalec C s� t ||�}|| }||kr&| }| }t|j�}|t |j }|j}|t |j }|t |j } t � |� � �} t � |� � d �} ||||| | | g} dgd dg } dddddddg}t t| j| ��D ]�\}\}}|| jk r�d||< q�| j| D ] }||| j| d kr� �q q�t�d�|�� || _| j| �r�| j�r�| j| dd|� ||< |ttfk�r�|d k�rxdd g||< n|d k�r�dd d d g||< d}n| j| ||< �q�q�td��|t k�r�| j�r�t || j d�}nt| | �r |\}}}}}}}t | j||||||||d� }t || j �}n.t!|| j d�}|j"dk�rL|dk �rLt#�$d� |�%| j&� | j&dk �r�|j'| j&�(� � |j)| j&�*� � |S )z*Pick the best locator based on a distance.r: Trc FNr9 r z�AutoDateLocator was unable to pick an appropriate interval for this date range. It may be necessary to add an interval value to the AutoDateLocator's intervald dictionary. Defaulting to {0}.r< r> r; r4 � z=No sensible date limit could be found in the AutoDateLocator.r� )r r� r� �bymonth� bymonthdayr r r rT r: zwPlotting microsecond time intervals is not well supported. Please see the MicrosecondLocator documentation for details.)+r rC �years�MONTHS_PER_YEAR�monthsr� r� r- � MIN_PER_HOURr, rN ZfloorrG � enumerate�ziprD rE rJ rF r� Z_warn_externalrX r+ rK rI r r rW r r" r3 r� r r) r� �_logZwarningrN r �set_view_intervalr �set_data_intervalr )ra r r r� ZtdeltaZnumYearsZ numMonthsZnumDaysZnumHoursZ numMinutesZ numSecondsZnumMicrosecondsZnumsZuse_rrule_locatorZbyrangesr� r� r� r r� �_rQ rR r r r r r6 r6 r7 rM � s| � � � zAutoDateLocator.get_locator)Nr� NT) rg rh ri rj rb re r% r rN rL r� r0 rM r6 r6 r6 r7 r! 6 s � Vr! c @ s2 e Zd ZdZd dd�Zdd� Zdd � Zd d � ZdS ) r" z� Make ticks on a given day of each year that is a multiple of base. Examples:: # Tick every year on Jan 1st locator = YearLocator() # Tick every 5 years on July 4th locator = YearLocator(5, month=7, day=4) r9 Nc C sD t �| |� t�|d�| _||dddd�| _t|d�s@|| jd< dS )zh Mark years that are multiple of base on a given month and day (default jan 1). r )�month�dayZhourZminuter� r� r; N)r rb �tickerZ _Edge_integerrJ �replacedr� )ra rJ r] r^ r3 r6 r6 r7 rb / s � zYearLocator.__init__c C s6 z| � � \}}W n tk r( g Y S X | �||�S r= r$ r r6 r6 r7 re A s zYearLocator.__call__c C s� | j �|j�| j j }| j �|j�| j j }|jf d|i| j��}t| jd�rd|j sd| jj |dd�}|g}|d }|j|kr�t |�S |j| j j }|jf d|i| j��}t| jd�r�|j s�| jj |dd�}|� |� qjd S )Nr� r� Tr� r� ) rJ �ler� r� �gerY r` r� r3 r; r� r �append)ra r r �ymin�ymax�ticksrI r� r6 r6 r7 r% J s zYearLocator.tick_valuesc C s� | � � \}}| j�|j�}| j�|j�}|jf d|i| j��}|�| j�}|jf d|i| j��}|�| j�}t |�}t |�}| � ||�S )r/ r� ) r rJ ra r� rb rY r` rB r3 r r )ra r r rd re r r r6 r6 r7 r0 c s zYearLocator.autoscale)r9 r9 r9 N)rg rh ri rj rb re r% r0 r6 r6 r6 r7 r" # s r" c @ s e Zd ZdZddd�ZdS )r# zB Make ticks on occurrences of each month, e.g., 1, 3, 12. Nr9 c C s` |dkrt dd�}n t|tj�r4dd� |�t�D �}ttf|||d�| j��}t � | ||� dS )a Mark every month in *bymonth*; *bymonth* can be an int or sequence. Default is ``range(1,13)``, i.e. every month. *interval* is the interval between each iteration. For example, if ``interval=2``, mark every second occurrence. Nr9 r@ c S s g | ] }|� � �qS r6 ��item�ry r] r6 r6 r7 rz � s z)MonthLocator.__init__.<locals>.<listcomp>)rQ rR r ) r� r{ rN r� rM rV r� r r! r rb )ra rQ rR r r3 r" r6 r6 r7 rb y s ��zMonthLocator.__init__)Nr9 r9 N�rg rh ri rj rb r6 r6 r6 r7 r# u s r# c @ s e Zd ZdZddd�ZdS )r$ z4 Make ticks on occurrences of each weekday. r9 Nc C sJ t |tj�r dd� |�t�D � ttf||d�| j��}t� | ||� dS )a� Mark every weekday in *byweekday*; *byweekday* can be a number or sequence. Elements of *byweekday* must be one of MO, TU, WE, TH, FR, SA, SU, the constants from :mod:`dateutil.rrule`, which have been imported into the :mod:`matplotlib.dates` namespace. *interval* specifies the number of weeks to skip. For example, ``interval=2`` plots every second week. c S s g | ] }|� � �qS r6 rg ri r6 r6 r7 rz � s z+WeekdayLocator.__init__.<locals>.<listcomp>)� byweekdayr N) r{ rN r� rM rV r� r r! r rb )ra rk r r3 r" r6 r6 r7 rb � s ��zWeekdayLocator.__init__)r9 r9 Nrj r6 r6 r6 r7 r$ � s r$ c @ s e Zd ZdZddd�ZdS )r% zZ Make ticks on occurrences of each day of the month. For example, 1, 15, 30. Nr9 c C sz |t |�kr|dk r td��|dkr0tdd�}n t|tj�rPdd� |�t �D �}ttf||d�| j ��}t � | ||� dS )z� Mark every day in *bymonthday*; *bymonthday* can be an int or sequence. Default is to tick every day of the month: ``bymonthday=range(1,32)`` r9 z*interval must be an integer greater than 0NrA c S s g | ] }|� � �qS r6 rg ri r6 r6 r7 rz � s z'DayLocator.__init__.<locals>.<listcomp>)rR r ) rV rW r� r{ rN r� rM r� r r! r rb )ra rR r r3 r" r6 r6 r7 rb � s ��zDayLocator.__init__)Nr9 Nrj r6 r6 r6 r7 r% � s r% c @ s e Zd ZdZddd�ZdS )r& z1 Make ticks on occurrences of each hour. Nr9 c C s4 |dkrt d�}tt||ddd�}t�| ||� dS )a Mark every hour in *byhour*; *byhour* can be an int or sequence. Default is to tick every hour: ``byhour=range(24)`` *interval* is the interval between each iteration. For example, if ``interval=2``, mark every second occurrence. NrB r )r r r r )r� r� r r rb )ra r r r3 r" r6 r6 r7 rb � s �zHourLocator.__init__)Nr9 Nrj r6 r6 r6 r7 r& � s r& c @ s e Zd ZdZddd�ZdS )r' z3 Make ticks on occurrences of each minute. Nr9 c C s2 |dkrt d�}tt||dd�}t�| ||� dS )a Mark every minute in *byminute*; *byminute* can be an int or sequence. Default is to tick every minute: ``byminute=range(60)`` *interval* is the interval between each iteration. For example, if ``interval=2``, mark every second occurrence. NrC r )r r r )r� r� r r rb )ra r r r3 r" r6 r6 r7 rb � s �zMinuteLocator.__init__)Nr9 Nrj r6 r6 r6 r7 r' � s r' c @ s e Zd ZdZddd�ZdS )r( z3 Make ticks on occurrences of each second. Nr9 c C s0 |dkrt d�}tt||d�}t�| ||� dS )a Mark every second in *bysecond*; *bysecond* can be an int or sequence. Default is to tick every second: ``bysecond = range(60)`` *interval* is the interval between each iteration. For example, if ``interval=2``, mark every second occurrence. NrC )r r )r� r� r r rb )ra r r r3 r" r6 r6 r7 rb � s zSecondLocator.__init__)Nr9 Nrj r6 r6 r6 r7 r( � s r( c @ sR e Zd ZdZddd�Zdd� Zdd � Zd d � Zd d � Zdd� Z dd� Z dd� Z dS )r) a� Make ticks on regular intervals of one or more microsecond(s). .. note:: Due to the floating point representation of time in days since 0001-01-01 UTC (plus 1), plotting data with microsecond time resolution does not work well with current dates. If you want microsecond resolution time plots, it is strongly recommended to use floating point seconds, not datetime-like time representation. If you really must use datetime.datetime() or similar and still need microsecond precision, your only chance is to use very early years; using year 0001 is recommended. r9 Nc C s || _ t�|�| _|| _dS )z� *interval* is the interval between each iteration. For example, if ``interval=2``, mark every second microsecond. N)r. r_ ZMultipleLocator�_wrapped_locatorr3 )ra r r3 r6 r6 r7 rb s zMicrosecondLocator.__init__c C s | j �|� t�| |�S r= )rl rN r rO r6 r6 r7 rN s zMicrosecondLocator.set_axisc C s | j �||� t�| ||�S r= )rl rZ r r r6 r6 r7 rZ " s z$MicrosecondLocator.set_view_intervalc C s | j �||� t�| ||�S r= )rl r[ r r r6 r6 r7 r[ & s z$MicrosecondLocator.set_data_intervalc C s6 z| � � \}}W n tk r( g Y S X | �||�S r= r$ r r6 r6 r7 re * s zMicrosecondLocator.__call__c C s@ t ||f�\}}|t9 }|t9 }| j�||�}dd� |D �}|S )Nc S s g | ] }|t �qS r6 �r[ )ry Ztickr6 r6 r7 rz 8 s z2MicrosecondLocator.tick_values.<locals>.<listcomp>)r r[ rl r% )ra r r ZnminZnmaxrf r6 r6 r7 r% 3 s z MicrosecondLocator.tick_valuesc C s dt S )r rL rm r� r6 r6 r7 r� ; s z MicrosecondLocator._get_unitc C s | j S )r )r. r� r6 r6 r7 r B s z MicrosecondLocator._get_interval)r9 N) rg rh ri rj rb rN rZ r[ re r% r� r r6 r6 r6 r7 r) s r) c C s t t�| �t S )ze Convert an epoch or sequence of epochs to the new date format, that is days since 0001. )� EPOCH_OFFSETrN r} rH )�er6 r6 r7 r I s r c C s t �| �t t S )zM Convert days since 0001 to epoch. *d* can be a number or sequence. )rN r} rn rH r� r6 r6 r7 r Q s r c C s> d}t �| �sd}| g} tdd� | D ��}|r6|d S |S dS )zi Convert mx :class:`datetime` instance (or sequence of mx instances) to the new date format. FTc S s g | ] }|� � �qS r6 )rf )ry �mr6 r6 r7 rz a s zmx2num.<locals>.<listcomp>r N)rN r� r )ZmxdatesZscalarZretr6 r6 r7 r X s r r� c C s | dkrdt } | t }| t }| }| t }| t }| t }||kr^tt|| �|d�} d} n�||krvt|d�} d} n�||kr�t|d�} d} nz||kr�t t � || �|d�} d} nV||kr�t t � || �|d�} d } n2||kr�t t � || �|d�} d } nt |d�} d } t| |d�} | | fS ) z� Create a date locator with *numticks* (approx) and a date formatter for *span* in days. Return value is (locator, formatter). r r9 r� r� z%b %Yz %a, %b %d)r r3 z%b %dz %H:%M %b %dz%H:%M:%S)r� r� r- r� r� r" rV r# r$ r% �mathr� r& r' r ) �spanr3 ZnumticksZminsZhrsr� ZwksrU rS r� r` r� r6 r6 r7 �date_ticker_factoryh s< rs c C s | t S )z! Return seconds as days. )rH r4 r6 r6 r7 r+ � s r+ c C s | t S )z! Return minutes as days. )r� )rp r6 r6 r7 r, � s r, c C s | t S )z Return hours as days. )r� )�hr6 r6 r7 r- � s r- c C s | t S )z Return weeks as days. )r- )�wr6 r6 r7 r. � s r. c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) � DateConverter�� Converter for datetime.date and datetime.datetime data, or for date/time data represented as it would be converted by :func:`date2num`. The 'unit' tag for such data is None or a tzinfo instance. c C sL | }t |d�}t||d�}t�ddd�}t�ddd�}tj||d||fd�S )�� Return the :class:`~matplotlib.units.AxisInfo` for *unit*. *unit* is a tzinfo instance or None. The *axis* argument is required but not used. r� r� r9 �� r� ��majloc�majfmtZlabelZdefault_limits)r! r rE r< �units�AxisInfo)r r r3 r{ r| �datemin�datemaxr6 r6 r7 �axisinfo� s �zDateConverter.axisinfoc C s t | �S )z� If *value* is not already a number or sequence of numbers, convert it with :func:`date2num`. The *unit* and *axis* arguments are not used. )r )r� r r r6 r6 r7 �convert� s zDateConverter.convertc C s^ t | tj�r| �� } zt�| �} W n ttfk r: Y nX z| jW S t k rX Y nX dS )zT Return the tzinfo instance of *x* or of its first element, or None N) r{ rN r� Zravelr� Zsafe_first_elementrQ � StopIterationr; r� )r] r r6 r6 r7 � default_units� s zDateConverter.default_unitsN)rg rh ri rj r1 r� r� r� r6 r6 r6 r7 rv � s rv c s* e Zd ZdZd� fdd� Zdd� Z� ZS ) �ConciseDateConverterrw NTc s& || _ || _|| _|| _t� �� d S r= )�_formats� _zero_formats�_offset_formats� _show_offsetrm rb )ra r� r� r� r� ro r6 r7 rb � s z ConciseDateConverter.__init__c C s\ |}t |d�}t||| j| j| j| jd�}t�ddd�}t�ddd�}tj ||d||fd�S )rx r� )r3 r� r� r� r� r� r9 ry r� rz ) r! r r� r� r� r� rE r< r} r~ )ra r r r3 r{ r| r r� r6 r6 r7 r� � s � �z ConciseDateConverter.axisinfo)NNNT)rg rh ri rj rb r� rs r6 r6 ro r7 r� � s �r� )N)N)N)Nr� )~rj rE r� Zloggingrq r� rF �warningsZdateutil.rruler r r r r r r r r r r r r r r Zdateutil.relativedeltar Zdateutil.parserr2 Z dateutil.tzZnumpyrN r1 r Zmatplotlib.unitsr} Zmatplotlib.cbookr� Zmatplotlib.tickerr_ �__all__Z getLoggerrg rY r/ Zutcr0 r8 rC rD rn r� r* r� rV Z SEC_PER_MINrT r- r� r� r� Z SEC_PER_HOURrH Z SEC_PER_WEEKr[ ZMONDAYZTUESDAYZ WEDNESDAYZTHURSDAYZFRIDAYZSATURDAYZSUNDAYZWEEKDAYSrK Z vectorizer� rS r^ r� r� �objectr_ rk rv rw r r r r� r� r r� r� r r Z Formatterr r r r r� ZLocatorr r r! r" r# r$ r% r& r' r( r) r r r rs r+ r, r- r. ZConversionInterfacerv r� �registryrO r< r6 r6 r6 r7 �<module> s� D � ( � � ' % * JhiPi nR H * 9&