U
    f/e:C                     @  s  d dl mZ d dlZd dlZd dlmZ d dlmZm	Z	 d dl
mZmZmZmZmZ d dlmZmZ d dlmZmZmZmZ d dlmZ d d	lmZ d d
lmZmZmZ d dl m!Z! d dl"m#Z# dZ$e$d Z%e%d Z&de& Z'de' Z(de( Z)ddddddddddddddddddddddddddddZ*ddd d!d"d#d$d%d&g	Z+e+D ],Z,eD ] Z-e, d'e- Z.e*e, e*e.< qJqBd(D ](Z,eD ]Z-e, d'e- Z/e/e*e/< q|qteD ]Z0d)e0 e*d)e0 < qd*d+d,d-d.Z1d*d/d0d1d2Z2dWd4d+d5d6d7Z3G d8d9 d9Z4G d:d; d;e4Z5d<d4d=d>d?Z6d*d@d*dAdBdCZ7d4dDdEdFZ8d4dDdGdHZ9d*dDdIdJZ:d*d*d4dKdLdMZ;d*d4dNdOdPZ<d*d4dNdQdRZ=d*d4dNdSdTZ>d*d4dNdUdVZ?dS )X    )annotationsN)unique_deltas)	Timestamptzconversion)DAYSMONTH_ALIASESMONTH_NUMBERSMONTHSint_to_weekday)build_field_sarraymonth_position_check)
DateOffsetDay_get_offset	to_offset)get_rule_month)cache_readonly)is_datetime64_dtypeis_period_dtypeis_timedelta64_dtype)	ABCSeries)uniquei  <      DMQACBTSLUNHW)ZWEEKDAYZEOMBMBQSQSBQBAASBASMSr   r   r   r    r!   r"   r#   r$   r%   r   r   r&   r   YBYYSBYSr)   r*   r(   r1   r,   r0   r+   r2   r-   -)r   r   W-str
str | None)
offset_strreturnc                 C  s   t | dS )z4
    Alias to closest period strings BQ->Q etc.
    N)_offset_to_period_mapget)r7    r;   >/tmp/pip-unpacked-wheel-tiezk1ph/pandas/tseries/frequencies.pyget_period_aliasa   s    r=   r   )namer8   c                 C  s   t jdtdd t| S )z
    Return DateOffset object associated with rule name.

    .. deprecated:: 1.0.0

    Examples
    --------
    get_offset('EOM') --> BMonthEnd(1)
    zWget_offset is deprecated and will be removed in a future version, use to_offset instead   )
stacklevel)warningswarnFutureWarningr   )r>   r;   r;   r<   
get_offseth   s    
rD   Tbool)rB   r8   c                 C  s   ddl }t| trF| j}t|sBt|sB|jtksBtd| j |} t	| dsRn2t
| jrftdnt| jrt| |d}| S t| |jrt| |jst| |j|jfrtdt|  | j} t| |js|| } t| |d}| S )a  
    Infer the most likely frequency given the input index. If the frequency is
    uncertain, a warning will be printed.

    Parameters
    ----------
    index : DatetimeIndex or TimedeltaIndex
      If passed a Series will use the values of the series (NOT THE INDEX).
    warn : bool, default True

    Returns
    -------
    str or None
        None if no discernible frequency.

    Raises
    ------
    TypeError
        If the index is not datetime-like.
    ValueError
        If there are fewer than three values.

    Examples
    --------
    >>> idx = pd.date_range(start='2020/12/01', end='2020/12/30', periods=30)
    >>> pd.infer_freq(idx)
    'D'
    r   Nz>cannot infer freq from a non-convertible dtype on a Series of dtypezJPeriodIndex given. Check the `freq` attribute instead of using infer_freq.rB   z4cannot infer freq from a non-convertible index type )Zpandas
isinstancer   Z_valuesr   r   rF   object	TypeErrorhasattrr   _TimedeltaFrequencyInfererget_freqZIndexZDatetimeIndexZ
Int64IndexZFloat64Indextype_FrequencyInferer)indexrB   pdvaluesZinfererr;   r;   r<   
infer_freq   s@    





rS   c                   @  s  e Zd ZdZd0ddddZedd Zed	d
 ZeddddZeddddZ	ddddZ
edd Zedd Zedd Zedd Zdd Zedd Zedd  Zddd!d"Zddd#d$Zddd%d&Zddd'd(Zddd)d*Zddd+d,Zddd-d.Zd/S )1rO   z8
    Not sure if I can avoid the state machine here
    TrE   rG   c                 C  sd   || _ |j| _t|dr4|jd k	r4t| j|j| _|| _t|dk rNt	d| j j
p\| j j| _d S )Ntz   z(Need at least 3 dates to infer frequency)rP   asi8i8valuesrK   rT   r   Ztz_convert_from_utcrB   len
ValueErrorZ_is_monotonic_increasingZ_is_monotonic_decreasingis_monotonic)selfrP   rB   r;   r;   r<   __init__   s    

 z_FrequencyInferer.__init__c                 C  s
   t | jS N)r   rW   r[   r;   r;   r<   deltas   s    z_FrequencyInferer.deltasc                 C  s   t | jjS r]   )r   rP   rV   r^   r;   r;   r<   deltas_asi8   s    z_FrequencyInferer.deltas_asi8r8   c                 C  s   t | jdkS N   )rX   r_   r^   r;   r;   r<   	is_unique   s    z_FrequencyInferer.is_uniquec                 C  s   t | jdkS rb   )rX   r`   r^   r;   r;   r<   is_unique_asi8   s    z _FrequencyInferer.is_unique_asi8r6   c                 C  s   | j r| jjsdS | jd }|r2t|tr2|  S | jddgddgdddgfkrTdS | js^dS | j	d }t|t
rtd|t
 S t|trtd|t S t|trtd	|t S t|trtd
|t S t|trtd|t S td|S dS )z
        Find the appropriate frequency string to describe the inferred
        frequency of self.i8values

        Returns
        -------
        str or None
        Nr   rc      A   ZBHr%   r    r!   r"   r#   r$   )rZ   rP   Z
_is_uniquer_   _is_multiple_ONE_DAY_infer_daily_rulehour_deltasre   r`   	_ONE_HOUR_maybe_add_count_ONE_MINUTE_ONE_SECOND
_ONE_MILLI
_ONE_MICRO)r[   deltar;   r;   r<   rM      s*    	






z_FrequencyInferer.get_freqc                 C  s   dd | j D S )Nc                 S  s   g | ]}|t  qS r;   )ri   .0xr;   r;   r<   
<listcomp>#  s     z0_FrequencyInferer.day_deltas.<locals>.<listcomp>r_   r^   r;   r;   r<   
day_deltas!  s    z_FrequencyInferer.day_deltasc                 C  s   dd | j D S )Nc                 S  s   g | ]}|t  qS r;   )rl   rs   r;   r;   r<   rv   '  s     z1_FrequencyInferer.hour_deltas.<locals>.<listcomp>rw   r^   r;   r;   r<   rk   %  s    z_FrequencyInferer.hour_deltasc                 C  s
   t | jS r]   )r   rW   r^   r;   r;   r<   fields)  s    z_FrequencyInferer.fieldsc                 C  s   t | jd S Nr   )r   rW   r^   r;   r;   r<   	rep_stamp-  s    z_FrequencyInferer.rep_stampc                 C  s   t | j| jjS r]   )r   ry   rP   Z	dayofweekr^   r;   r;   r<   r   1  s    z&_FrequencyInferer.month_position_checkc                 C  s&   | j d d | j d  }t|dS )Nr/      r   i8)ry   r   astype)r[   Znmonthsr;   r;   r<   mdiffs4  s    z_FrequencyInferer.mdiffsc                 C  s   t | jd dS )Nr/   r}   )r   ry   r~   r^   r;   r;   r<   ydiffs9  s    z_FrequencyInferer.ydiffsc           
      C  s   |   }|r:| jd }t| jj }| d| }t||S |  }|r| jd d }dddd}t|| jjd   }| d| }t||S |  }|rt|| jd S | j	r| 
 S |  rdS |  }	|	r|	S d S )	Nr   r3   rU   r|      
   )r   r?   rc   r   )_get_annual_ruler   r   r{   monthrm   _get_quarterly_ruler   _get_monthly_rulerd   _get_daily_rule_is_business_daily_get_wom_rule)
r[   Zannual_ruleZnyearsr   aliasZquarterly_ruleZ	nquartersmod_dictZmonthly_ruleZwom_ruler;   r;   r<   rj   =  s0    


z#_FrequencyInferer._infer_daily_rulec                 C  sN   | j d t }|d dkr@t| j  }d| }t||d S td|S d S )Nr      r4   r   )r_   ri   r
   r{   weekdayrm   )r[   dayswdr   r;   r;   r<   r   ]  s    
z!_FrequencyInferer._get_daily_rulec                 C  sH   t | jdkrd S t t| jd dkr,d S |  }ddddd|S )Nrc   r   r,   r-   r   r+   csbsZcebe)rX   r   r   ry   r   r:   r[   Z	pos_checkr;   r;   r<   r   g  s    z"_FrequencyInferer._get_annual_rulec                 C  sD   t | jdkrd S | jd d dks(d S |  }ddddd|S )	Nrc   r   rU   r)   r(   r   r*   r   rX   r   r   r:   r   r;   r;   r<   r   q  s    z%_FrequencyInferer._get_quarterly_rulec                 C  s.   t | jdkrd S |  }ddddd|S )Nrc   r.   ZBMSr   r'   r   r   r   r;   r;   r<   r   {  s    z#_FrequencyInferer._get_monthly_rulec                 C  s~   | j ddgkrdS | jd  }t| jj}t|t}t|t	| d}t
|dk|dk@ |dk|dk@ |dk@ B S )Nrc   rU   Fr   r      )rx   rP   r   npZdiffrV   Zfloor_divideri   modZcumsumall)r[   Zfirst_weekdayZshiftsweekdaysr;   r;   r<   r     s    z$_FrequencyInferer._is_business_dailyc                 C  s~   t | jj}t|dkrd S t | jjd d }||dk  }t|dksTt|dkrXd S |d d }t|d  }d| | S )Nrc   r   r   r   zWOM-)r   rP   r   rX   dayr
   )r[   r   Zweek_of_monthsweekr   r;   r;   r<   r     s    z_FrequencyInferer._get_wom_ruleN)T)__name__
__module____qualname____doc__r\   r   r_   r`   rd   re   rM   rx   rk   ry   r{   r   r   r   rj   r   r   r   r   r   r   r;   r;   r;   r<   rO      s>   

.





 


rO   c                   @  s   e Zd Zdd ZdS )rL   c                 C  s   | j r|  S d S r]   )rd   r   r^   r;   r;   r<   rj     s    z,_TimedeltaFrequencyInferer._infer_daily_ruleN)r   r   r   rj   r;   r;   r;   r<   rL     s   rL   int)multr8   c                 C  s   | | dkS rz   r;   )usr   r;   r;   r<   rh     s    rh   float)basecountr8   c                 C  s4   |dkr,|t |kstt |}| |  S | S d S rb   )r   AssertionError)r   r   r;   r;   r<   rm     s
    rm   ra   c                 C  s2  |dks| dkrdS t | } t |}t|rNt| rFtt| t|S | dkS t|r^| dkS t|rn| dkS t|r| |ddddd	d
dddh
kS |dkr| dkS |dkr| dkS |dkr| dkS |dkr| dkS |d	kr| dkS |d
k r| dkS |dkr| dkS |dkr| dkS |dkr*| dkS dS dS )a  
    Returns True if downsampling is possible between source and target
    frequencies

    Parameters
    ----------
    source : str or DateOffset
        Frequency converting from
    target : str or DateOffset
        Frequency converting to

    Returns
    -------
    bool
    NF
   r    r   r   r"   r   r$   r   r!   r%   r#   	   r    r   r   r"   r   r$   r!   r%   r#   r   r   r   r%   r    r!   r"   r#   r$   >   r    r"   r   r$   r!   r%   r#   >   r    r   r"   r$   r!   r%   r#   >   r    r   r"   r$   r!   r%   r#      r    r"   r$   r!   r%   r#      r    r"   r$   r!   r#      r!   r#   r"   r$      r#   r"   r$      r#   r$      r$   )_maybe_coerce_freq
_is_annual_is_quarterly_quarter_months_conformr   _is_monthly
_is_weekly)sourcetargetr;   r;   r<   is_subperiod  sH     



r   c                 C  sV  |dks| dkrdS t | } t |}t| rnt|rDt| t|kS t|rft| }t|}t||S |dkS t| r~|dkS t| r|dkS t| r|| ddddd	d
dddh
kS | dkr|dkS | dkr|dkS | dkr|dkS | dk r|dkS | d	kr|dkS | d
kr|dkS | dkr*|dkS | dkr<|dkS | dkrN|dkS dS dS )a  
    Returns True if upsampling is possible between source and target
    frequencies

    Parameters
    ----------
    source : str or DateOffset
        Frequency converting from
    target : str or DateOffset
        Frequency converting to

    Returns
    -------
    bool
    NFr   r   r   r   r   r%   r    r!   r"   r#   r$   r   r   r   r   r   r   )r   r   r   r   r   r   r   )r   r   ZsmonthZtmonthr;   r;   r<   is_superperiod  sJ    






r   c                 C  s$   | dk	st t| tr| j} |  S )zwe might need to coerce a code to a rule_code
    and uppercase it

    Parameters
    ----------
    source : str or DateOffset
        Frequency converting from

    Returns
    -------
    str
    N)r   rH   r   Z	rule_codeupper)coder;   r;   r<   r   2  s    
r   )r   r   r8   c                 C  s    t |  }t | }|d |d kS )NrU   )r   )r   r   ZsnumZtnumr;   r;   r<   r   E  s    r   )ruler8   c                 C  s   |   } | dkp| dS )Nr   zA-r   
startswithr   r;   r;   r<   r   K  s    r   c                 C  s$   |   } | dkp"| dp"| dS )Nr   zQ-r*   r   r   r;   r;   r<   r   P  s    r   c                 C  s   |   } | dkp| dkS )Nr   r'   )r   r   r;   r;   r<   r   U  s    r   c                 C  s   |   } | dkp| dS )Nr&   r4   r   r   r;   r;   r<   r   Z  s    r   )T)@
__future__r   rA   Znumpyr   Zpandas._libs.algosr   Zpandas._libs.tslibsr   r   Zpandas._libs.tslibs.ccalendarr   r   r   r	   r
   Zpandas._libs.tslibs.fieldsr   r   Zpandas._libs.tslibs.offsetsr   r   r   r   Zpandas._libs.tslibs.parsingr   Zpandas.util._decoratorsr   Zpandas.core.dtypes.commonr   r   r   Zpandas.core.dtypes.genericr   Zpandas.core.algorithmsr   rq   rp   ro   rn   rl   ri   r9   Z_need_suffix_prefix_mkey_aliasZ_dr=   rD   rS   rO   rL   rh   rm   r   r   r   r   r   r   r   r   r;   r;   r;   r<   <module>   s   H c8: