U Cv fD@sdZddlmZddlZddlmZmZddlmZddlm Z ddl Z ddl Z ddlmZmZddlmZmZmZmZdd lmZmZdd lmZz ddlZWnek rdZYnXdpd d ZGdddZGdddeZddZ ddZ!ddZ"ddZ#dqddZ$drddZ%d d!Z&Gd"d#d#eZ'Gd$d%d%eZ(d&d'd(d)d*d+d,d-d.d/d0d1d2 Z)Gd3d4d4eZ*Gd5d6d6e*Z+Gd7d8d8e*Z,Gd9d:d:eZ-Gd;d<dd>e-Z/Gd?d@d@eZ0GdAdBdBeZ1GdCdDdDeZ2GdEdFdFeZ3GdGdHdHeZ4GdIdJdJeZ5e/e.e/e.ee,dKdLee+dMdLe(e'e0e1e2e2e3e4e4e5e5ee.dMdLee.dNdLee.ddLee.dOdLee.dPdLee.dQdLee.dRdLee.dSdLee.dTdLee.dUdLee.dVdLee.dKdLee/dMdLee/dNdLee/ddLee/dOdLee/dPdLee/dQdLee/dRdLee/dSdLee/dTdLee/dUdLee/dVdLee/dKdLee+dMdLee+dNdLee+ddLee+dOdLee+dPdLee+dQdLee+dRdLee+dSdLee+dTdLee+dUdLee+dVdLee+dKdLee,dMdLee,dNdLee,ddLee,dOdLee,dPdLee,dQdLee,dRdLee,dSdLee,dTdLee,dUdLee,dVdLee,dKdLdWAZ6dX7e68Z9dYe9dZZ:e0e1e2e3fZ;d[d\ZdadbZ?dcddZ@dedfZAdtdjdkZBdudldmZCdvdndoZDdS)wz8Time offset classes for use with cftime.datetime objects) annotationsN)datetime timedelta)partial)ClassVar) CFTimeIndex_parse_iso8601_with_reso)_is_standard_calendar_should_cftime_be_usedconvert_time_or_go_backformat_cftime_datetime)_contains_datetime_like_objectsis_np_datetime_like)count_not_noneTc CsZtdkrtdnDt|r$|s$tjStjtjtjtjtjtj tj tjtjd }||SdS)z6Return the cftime date type for a given calendar name.Nz8cftime is required for dates with non-standard calendars) ZnoleapZ360_dayZ365_dayZ366_dayZ gregorianZproleptic_gregorianZjulianZall_leapstandard) cftime ImportErrorr pd TimestampZDatetimeNoLeapZDatetime360DayZDatetimeAllLeapZDatetimeGregorianDatetimeProlepticGregorianZDatetimeJulian)calendar use_cftimeZ calendarsr@/tmp/pip-unpacked-wheel-h316xyqg/xarray/coding/cftime_offsets.py get_date_typeDs   rc@seZdZUdZded<dZded<d,dddd Zd d Zd d ZddZ ddZ ddZ ddZ ddZ ddZddZddZddZd d!Zd"d#Zd$d%Zd&d'Zd(d)Zd*d+ZdS)-BaseCFTimeOffsetNzClassVar[str | None]_freq _day_optionintncCs&t|tstdt|||_dS)NzXThe provided multiple 'n' must be an integer. Instead a value of type {!r} was provided.) isinstancer TypeErrorformattyper!)selfr!rrr__init__^s zBaseCFTimeOffset.__init__cCs|jSN)rr&rrr rule_codefszBaseCFTimeOffset.rule_codecCs|j|jko||kSr()r!r*r&otherrrr__eq__iszBaseCFTimeOffset.__eq__cCs ||k Sr(rr+rrr__ne__lszBaseCFTimeOffset.__ne__cCs ||Sr() __apply__r+rrr__add__oszBaseCFTimeOffset.__add__cCsRtdkrtdt|tjr&tdn(t|t|krJt||j|jStSdS)NNo module named 'cftime'z5Cannot subtract a cftime.datetime from a time offset.)rModuleNotFoundErrorr"rr#r%r!NotImplementedr+rrr__sub__rs  zBaseCFTimeOffset.__sub__cCs"t|tstSt|||jdS)Nr )r"rr3r%r!r+rrr__mul__}s zBaseCFTimeOffset.__mul__cCs|dS)Nrr)rrr__neg__szBaseCFTimeOffset.__neg__cCs ||Sr()r5r+rrr__rmul__szBaseCFTimeOffset.__rmul__cCs ||Sr()r0r+rrr__radd__szBaseCFTimeOffset.__radd__cCs,t|tr"t|t|kr"td| |S)Nz1Cannot subtract cftime offsets of differing types)r"rr%r#r+rrr__rsub__szBaseCFTimeOffset.__rsub__cCstSr()r3r)rrrr/szBaseCFTimeOffset.__apply__cCs|||}||kSxCheck if the given date is in the set of possible dates created using a length-one version of this offset class.r)r&dateZ test_daterrronOffsets zBaseCFTimeOffset.onOffsetcCs ||r|S|t|SdSr(r>r%r&r=rrr rollforwards zBaseCFTimeOffset.rollforwardcCs ||r|S|t|SdSr(r?r@rrrrollbacks zBaseCFTimeOffset.rollbackcCsdt|jd|jdS)N<: n=>)r%__name__r!r)rrr__str__szBaseCFTimeOffset.__str__cCst|Sr()strr)rrr__repr__szBaseCFTimeOffset.__repr__cCs t||jSr()_get_day_of_monthrr+rrr_get_offset_daysz BaseCFTimeOffset._get_offset_day)r)rF __module__ __qualname__r__annotations__rr'r*r-r.r0r4r5r7r8r9r:r/r>rArBrGrIrKrrrrrZs(    rc@s$eZdZddZddZddZdS)TickcCst|}|tttttfkr"tdt|tkrdksNntd||S)Nz_'self.month' must be an integer value between 1 and 12. Instead, it was set to a value of {!r}rrd)r"rr#r$rW)rgZ default_monthZ result_monthrrr_validate_monthTs ruc@s eZdZdZddZddZdS) MonthBeginMScCst|j|jd}t||dS)Nrr`)rlrir!rpr&r,r!rrrr/hszMonthBegin.__apply__cCs |jdkSr<rrir@rrrr>lszMonthBegin.onOffsetNrFrLrMrr/r>rrrrrvesrvc@s eZdZdZddZddZdS)MonthEndMcCs t|j|jt|}t||dS)Nra)rlrir!rbrprxrrrr/uszMonthEnd.__apply__cCs|jt|kSr;)rirbr@rrrr>yszMonthEnd.onOffsetNr{rrrrr|rsr|ZJANZFEBZMARZAPRZMAYZJUNZJULZAUGZSEPZOCTZNOVZDEC) rrq rdc@s\eZdZUdZded<ded<ddd Zd d Zd d ZddZddZ ddZ ddZ dS) QuarterOffsetz>Quarter representation copied off of pandas/tseries/offsets.py ClassVar[str]r ClassVar[int]_default_monthrNcCst||t||j|_dSr(rr'rurrgr&r!rgrrrr's zQuarterOffset.__init__cCsF|jd|jd}t||j|j|jdd}|d|}t|||jS)Nrq)rcrr)rgrtr!rrp)r&r,rsZqtrsrorrrr/s zQuarterOffset.__apply__cCs(|j|jd}|dko&|j||kS)r<rqr)rgrirK)r&r=Z mod_monthrrrr>szQuarterOffset.onOffsetcCsdtdkrtdt|tjr&tdn:t|t|kr\|j|jkr\t||j|j|jdStSdSNr1z,Cannot subtract cftime.datetime from offset.rg rr2r"rr#r%rgr!r3r+rrrr4s  zQuarterOffset.__sub__cCs&t|trtSt|||j|jdSN)r!rgr"r[r3r%r!rgr+rrrr5s zQuarterOffset.__mul__cCs|jdt|jSN-r_MONTH_ABBREVIATIONSrgr)rrrr*szQuarterOffset.rule_codecCs"dt|jd|jd|jdSNrCrDz, month=rEr%rFr!rgr)rrrrGszQuarterOffset.__str__)rN) rFrLrM__doc__rNr'r/r>r4r5r*rGrrrrrs    rc@s(eZdZdZdZdZddZddZdS) QuarterBeginrqQSr`cCs"||r|S|t|jdSdS)z-Roll date forward to nearest start of quarterrNr>rrgr@rrrrAs zQuarterBegin.rollforwardcCs"||r|S|t|jdSdS)z.Roll date backward to nearest start of quarterrNrr@rrrrBs zQuarterBegin.rollbackNrFrLrMrrrrArBrrrrrs rc@s(eZdZdZdZdZddZddZdS) QuarterEndrqQracCs"||r|S|t|jdSdS)z+Roll date forward to nearest end of quarterrNr>rrgr@rrrrAs zQuarterEnd.rollforwardcCs"||r|S|t|jdSdS)z,Roll date backward to nearest end of quarterrNrr@rrrrBs zQuarterEnd.rollbackNrrrrrrs rc@sXeZdZUded<ded<ded<ddd Zd d Zd d ZddZddZddZ dS) YearOffsetrrrrrrNcCst||t||j|_dSr(rrrrrr's zYearOffset.__init__cCs@t||j}t||j|j|}|d|j|j}t|||jS)Nrd)rJrrmr!rgrp)r&r,rkZyearsrorrrr/s zYearOffset.__apply__cCsdtdkrtdt|tjr&tdn:t|t|kr\|j|jkr\t||j|j|jdStSdSrrr+rrrr4s  zYearOffset.__sub__cCs&t|trtSt|||j|jdSrrr+rrrr5s zYearOffset.__mul__cCs|jdt|jSrrr)rrrr*szYearOffset.rule_codecCs"dt|jd|jd|jdSrrr)rrrrGszYearOffset.__str__)rN) rFrLrMrNr'r/r4r5r*rGrrrrrs   rc@s0eZdZdZdZdZddZddZdd Zd S) YearBeginASr`rcCs|jdko|j|jkSry)rirgr@rrrr> szYearBegin.onOffsetcCs"||r|S|t|jdSdS)z*Roll date forward to nearest start of yearrNr>rrgr@rrrrA%s zYearBegin.rollforwardcCs"||r|S|t|jdSdS)z+Roll date backward to nearest start of yearrNrr@rrrrB,s zYearBegin.rollbackN rFrLrMrrrr>rArBrrrrrs rc@s0eZdZdZdZdZddZddZdd Zd S) YearEndArardcCs|jt|ko|j|jkSr;)rirbrgr@rrrr>9szYearEnd.onOffsetcCs"||r|S|t|jdSdS)z(Roll date forward to nearest end of yearrNr>rrgr@rrrrA>s zYearEnd.rollforwardcCs"||r|S|t|jdSdS)z)Roll date backward to nearest end of yearrNrr@rrrrBEs zYearEnd.rollbackNrrrrrr4s rc@s eZdZdZddZddZdS)rRDcCs t|jdS)Nrerr!r)rrrr_PszDay.as_timedeltacCs ||Sr(r_r+rrrr/Ssz Day.__apply__NrFrLrMrr_r/rrrrrRMsrRc@s eZdZdZddZddZdS)rSHcCs t|jdS)N)hoursrr)rrrr_ZszHour.as_timedeltacCs ||Sr(rr+rrrr/]szHour.__apply__NrrrrrrSWsrSc@s eZdZdZddZddZdS)rTTcCs t|jdS)N)minutesrr)rrrr_dszMinute.as_timedeltacCs ||Sr(rr+rrrr/gszMinute.__apply__NrrrrrrTasrTc@s eZdZdZddZddZdS)rUScCs t|jdS)N)secondsrr)rrrr_nszSecond.as_timedeltacCs ||Sr(rr+rrrr/qszSecond.__apply__NrrrrrrUksrUc@s eZdZdZddZddZdS)rVLcCs t|jdS)N)Z millisecondsrr)rrrr_xszMillisecond.as_timedeltacCs ||Sr(rr+rrrr/{szMillisecond.__apply__NrrrrrrVusrVc@s eZdZdZddZddZdS)rXUcCs t|jdS)N) microsecondsrr)rrrr_szMicrosecond.as_timedeltacCs ||Sr(rr+rrrr/szMicrosecond.__apply__NrrrrrrXsrXrdrrr~rrrrrrrr)ArrYZYSrrr}rwrrrminrrmsruszAS-JANzAS-FEBzAS-MARzAS-APRzAS-MAYzAS-JUNzAS-JULzAS-AUGzAS-SEPzAS-OCTzAS-NOVzAS-DECzA-JANzA-FEBzA-MARzA-APRzA-MAYzA-JUNzA-JULzA-AUGzA-SEPzA-OCTzA-NOVzA-DECzQS-JANzQS-FEBzQS-MARzQS-APRzQS-MAYzQS-JUNzQS-JULzQS-AUGzQS-SEPzQS-OCTzQS-NOVzQS-DECzQ-JANzQ-FEBzQ-MARzQ-APRzQ-MAYzQ-JUNzQ-JULzQ-AUGzQ-SEPzQ-OCTzQ-NOVzQ-DEC|z!^((?P\d+)|())(?P(z))$cCsrt|tr|Sztt|}Wntk r>tdYnX|d}|d}|dkr\dnt|}t ||dS)zOConvert a frequency string to the appropriate subclass of BaseCFTimeOffset.z!Invalid frequency string providedfreqmultipleNrr ) r"rrematch_PATTERN groupdictAttributeErrorrWr _FREQUENCIES)rZ freq_dataZ multiplesrrr to_offsets rcCstdkrtdt|tr@|dkr*tdtt||\}}|St|tjrP|St|ttj frntj | St d |dS)Nr1zTIf converting a string to a cftime.datetime object, a calendar type must be providedzUdate_str_or_date must be a string or a subclass of cftime.datetime. Instead got {!r}.)rr2r"rHrWrrrrrr timetupler#r$)Zdate_str_or_daterr=_rrrto_cftime_datetimes$  rcCs|jdddddS)z Round datetime down to midnight.r)hourminutesecond microsecond)rn)r=rrrnormalize_datesrcCs|r t|S|SdS)z5Round datetime down to midnight if normalize is True.N)r)r= normalizerrr_maybe_normalize_datesrcCsTtdkrtd||}tjd||dd}dt|}|j}tj|||ddS)zGenerate an equally-spaced sequence of cftime.datetime objects between and including two dates (whose length equals the number of periods).Nr1gT)Zendpointzseconds since )unitsrZonly_use_cftime_datetimes)rr2 total_secondsr\Zlinspacer rZnum2date)r`raperiodsrvaluesrrrrr_generate_linear_range s rccs|r||}|r||}|dkr4||kr4d}d}|dkrL||d|}|dkrd||d|}|}|jdkr||kr|V||}||krtd|d|}qrn4||kr|V||}||krtd|d|}qdS)aGenerate a regular range of cftime.datetime objects with a given time offset. Adapted from pandas.tseries.offsets.generate_range. Parameters ---------- start : cftime.datetime, or None Start of range end : cftime.datetime, or None End of range periods : int, or None Number of elements in the sequence offset : BaseCFTimeOffset An offset class designed for working with cftime.datetime objects Returns ------- A generator object NrrzOffset z did not increment datez did not decrement date)rArBr!rW)r`raroffsetcurrentZ next_daterrr_generate_ranges2   rrFrc Cs2t||||dkrtd|dk r6t||}t||}|dk rRt||}t||}|dkrht|||}n t|} ttt |||| }d} d} |dkrd} d} n$|dkrd} n|dkrd} ntd| st |r|dk r|d |kr|d d}| s&t |r&|dk r&|d |kr&|dd }t ||d S) a%Return a fixed frequency CFTimeIndex. Parameters ---------- start : str or cftime.datetime, optional Left bound for generating dates. end : str or cftime.datetime, optional Right bound for generating dates. periods : int, optional Number of periods to generate. freq : str or None, default: "D" Frequency strings can have multiples, e.g. "5H". normalize : bool, default: False Normalize start/end dates to midnight before generating date range. name : str, default: None Name of the resulting index closed : {"left", "right"} or None, default: None Make the interval closed with respect to the given frequency to the "left", "right", or both sides (None). calendar : str, default: "standard" Calendar type for the datetimes. Returns ------- CFTimeIndex Notes ----- This function is an analog of ``pandas.date_range`` for use in generating sequences of ``cftime.datetime`` objects. It supports most of the features of ``pandas.date_range`` (e.g. specifying how the index is ``closed`` on either side, or whether or not to ``normalize`` the start and end bounds); however, there are some notable exceptions: - You cannot specify a ``tz`` (time zone) argument. - Start or end dates specified as partial-datetime strings must use the `ISO-8601 format `_. - It supports many, but not all, frequencies supported by ``pandas.date_range``. For example it does not currently support any of the business-related or semi-monthly frequencies. - Compound sub-monthly frequencies are not supported, e.g. '1H1min', as these can easily be written in terms of the finest common resolution, e.g. '61min'. Valid simple frequency strings for use with ``cftime``-calendars include any multiples of the following. +--------+--------------------------+ | Alias | Description | +========+==========================+ | A, Y | Year-end frequency | +--------+--------------------------+ | AS, YS | Year-start frequency | +--------+--------------------------+ | Q | Quarter-end frequency | +--------+--------------------------+ | QS | Quarter-start frequency | +--------+--------------------------+ | M | Month-end frequency | +--------+--------------------------+ | MS | Month-start frequency | +--------+--------------------------+ | D | Day frequency | +--------+--------------------------+ | H | Hour frequency | +--------+--------------------------+ | T, min | Minute frequency | +--------+--------------------------+ | S | Second frequency | +--------+--------------------------+ | L, ms | Millisecond frequency | +--------+--------------------------+ | U, us | Microsecond frequency | +--------+--------------------------+ Any multiples of the following anchored offsets are also supported. +----------+--------------------------------------------------------------------+ | Alias | Description | +==========+====================================================================+ | A(S)-JAN | Annual frequency, anchored at the end (or beginning) of January | +----------+--------------------------------------------------------------------+ | A(S)-FEB | Annual frequency, anchored at the end (or beginning) of February | +----------+--------------------------------------------------------------------+ | A(S)-MAR | Annual frequency, anchored at the end (or beginning) of March | +----------+--------------------------------------------------------------------+ | A(S)-APR | Annual frequency, anchored at the end (or beginning) of April | +----------+--------------------------------------------------------------------+ | A(S)-MAY | Annual frequency, anchored at the end (or beginning) of May | +----------+--------------------------------------------------------------------+ | A(S)-JUN | Annual frequency, anchored at the end (or beginning) of June | +----------+--------------------------------------------------------------------+ | A(S)-JUL | Annual frequency, anchored at the end (or beginning) of July | +----------+--------------------------------------------------------------------+ | A(S)-AUG | Annual frequency, anchored at the end (or beginning) of August | +----------+--------------------------------------------------------------------+ | A(S)-SEP | Annual frequency, anchored at the end (or beginning) of September | +----------+--------------------------------------------------------------------+ | A(S)-OCT | Annual frequency, anchored at the end (or beginning) of October | +----------+--------------------------------------------------------------------+ | A(S)-NOV | Annual frequency, anchored at the end (or beginning) of November | +----------+--------------------------------------------------------------------+ | A(S)-DEC | Annual frequency, anchored at the end (or beginning) of December | +----------+--------------------------------------------------------------------+ | Q(S)-JAN | Quarter frequency, anchored at the end (or beginning) of January | +----------+--------------------------------------------------------------------+ | Q(S)-FEB | Quarter frequency, anchored at the end (or beginning) of February | +----------+--------------------------------------------------------------------+ | Q(S)-MAR | Quarter frequency, anchored at the end (or beginning) of March | +----------+--------------------------------------------------------------------+ | Q(S)-APR | Quarter frequency, anchored at the end (or beginning) of April | +----------+--------------------------------------------------------------------+ | Q(S)-MAY | Quarter frequency, anchored at the end (or beginning) of May | +----------+--------------------------------------------------------------------+ | Q(S)-JUN | Quarter frequency, anchored at the end (or beginning) of June | +----------+--------------------------------------------------------------------+ | Q(S)-JUL | Quarter frequency, anchored at the end (or beginning) of July | +----------+--------------------------------------------------------------------+ | Q(S)-AUG | Quarter frequency, anchored at the end (or beginning) of August | +----------+--------------------------------------------------------------------+ | Q(S)-SEP | Quarter frequency, anchored at the end (or beginning) of September | +----------+--------------------------------------------------------------------+ | Q(S)-OCT | Quarter frequency, anchored at the end (or beginning) of October | +----------+--------------------------------------------------------------------+ | Q(S)-NOV | Quarter frequency, anchored at the end (or beginning) of November | +----------+--------------------------------------------------------------------+ | Q(S)-DEC | Quarter frequency, anchored at the end (or beginning) of December | +----------+--------------------------------------------------------------------+ Finally, the following calendar aliases are supported. +--------------------------------+---------------------------------------+ | Alias | Date type | +================================+=======================================+ | standard, gregorian | ``cftime.DatetimeGregorian`` | +--------------------------------+---------------------------------------+ | proleptic_gregorian | ``cftime.DatetimeProlepticGregorian`` | +--------------------------------+---------------------------------------+ | noleap, 365_day | ``cftime.DatetimeNoLeap`` | +--------------------------------+---------------------------------------+ | all_leap, 366_day | ``cftime.DatetimeAllLeap`` | +--------------------------------+---------------------------------------+ | 360_day | ``cftime.Datetime360Day`` | +--------------------------------+---------------------------------------+ | julian | ``cftime.DatetimeJulian`` | +--------------------------------+---------------------------------------+ Examples -------- This function returns a ``CFTimeIndex``, populated with ``cftime.datetime`` objects associated with the specified calendar type, e.g. >>> xr.cftime_range(start="2000", periods=6, freq="2MS", calendar="noleap") CFTimeIndex([2000-01-01 00:00:00, 2000-03-01 00:00:00, 2000-05-01 00:00:00, 2000-07-01 00:00:00, 2000-09-01 00:00:00, 2000-11-01 00:00:00], dtype='object', length=6, calendar='noleap', freq='2MS') As in the standard pandas function, three of the ``start``, ``end``, ``periods``, or ``freq`` arguments must be specified at a given time, with the other set to ``None``. See the `pandas documentation `_ for more examples of the behavior of ``date_range`` with each of the parameters. See Also -------- pandas.date_range rqzZOf the arguments 'start', 'end', 'periods', and 'freq', three must be specified at a time.NFTleftrightz-Closed must be either 'left', 'right' or Nonerrr6)name) rrWrrrrr\arraylistrlenr) r`rarrrrclosedrdatesrZ left_closedZ right_closedrrr cftime_rangeTs<4      ( rc Csddlm} |dk rd} | |r| dk rztj||||||||dWStjjk r|} z| dkrltd| W5d} ~ XYqXn| dkrtd|d t||||||||d S) aReturn a fixed frequency datetime index. The type (:py:class:`xarray.CFTimeIndex` or :py:class:`pandas.DatetimeIndex`) of the returned index depends on the requested calendar and on `use_cftime`. Parameters ---------- start : str or datetime-like, optional Left bound for generating dates. end : str or datetime-like, optional Right bound for generating dates. periods : int, optional Number of periods to generate. freq : str or None, default: "D" Frequency strings can have multiples, e.g. "5H". tz : str or tzinfo, optional Time zone name for returning localized DatetimeIndex, for example 'Asia/Hong_Kong'. By default, the resulting DatetimeIndex is timezone-naive. Only valid with pandas DatetimeIndex. normalize : bool, default: False Normalize start/end dates to midnight before generating date range. name : str, default: None Name of the resulting index closed : {"left", "right"} or None, default: None Make the interval closed with respect to the given frequency to the "left", "right", or both sides (None). calendar : str, default: "standard" Calendar type for the datetimes. use_cftime : boolean, optional If True, always return a CFTimeIndex. If False, return a pd.DatetimeIndex if possible or raise a ValueError. If None (default), return a pd.DatetimeIndex if possible, otherwise return a CFTimeIndex. Defaults to False if `tz` is not None. Returns ------- CFTimeIndex or pd.DatetimeIndex See also -------- pandas.date_range cftime_range date_range_like r)r NFT)r`rarrtzrrrzLDate range is invalid for pandas DatetimeIndex, try using `use_cftime=True`.zInvalid calendar z7 for pandas DatetimeIndex, try using `use_cftime=True`.)r`rarrrrrr)xarray.coding.timesr r date_rangeerrorsZOutOfBoundsDatetimerWr) r`rarrrrrrrrr errrrrr/sH8   rc CsFddlm}ddlm}t|tjtfsLt||r<|jdksDt |sLt d||}|dkrdt dt |||}|j }|j }t|jrd}t|}t|}nt|tr|j}n|jj}||krt|j|Ar|St||} t|| } t|| } |j|jkr.tt|ttttfr.| j| jd } t| | ||d S) aQGenerate a datetime array with the same frequency, start and end as another one, but in a different calendar. Parameters ---------- source : DataArray, CFTimeIndex, or pd.DatetimeIndex 1D datetime array calendar : str New calendar name. use_cftime : bool, optional If True, the output uses :py:class:`cftime.datetime` objects. If None (default), :py:class:`numpy.datetime64` values are used if possible. If False, :py:class:`numpy.datetime64` values are used or an error is raised. Returns ------- DataArray 1D datetime coordinate with the same start, end and frequency as the source, but in the new calendar. The start date is assumed to exist in the target calendar. If the end date doesn't exist, the code tries 1 and 2 calendar days before. There is a special case when the source time series is daily or coarser and the end of the input range is on the last day of the month. Then the output range will also end on the last day of the month in the new calendar. r) infer_freq) DataArrayrzH'source' must be a 1D array of datetime objects for inferring its range.Nz[`date_range_like` was unable to generate a range as the source frequency was not inferable.rrz)r`rarr) Zxarray.coding.frequenciesrZxarray.core.dataarrayrr"rZ DatetimeIndexrndimr rWr rrmaxrZdtyperrdtrr riZ daysinmonthrrrr|rRrnr isoformat) sourcerrrrrZ source_startZ source_endZsource_calendarZ date_typer`rarrrdate_range_likesV             r)T)r`)rq)N)NNNrFNNr) NNNrNFNNrN)N)Er __future__rrrr functoolsrtypingrZnumpyr\ZpandasrZxarray.coding.cftimeindexrrrr r r r Zxarray.core.commonr rZxarray.core.pdcompatrrrrrrOrJrbrlrmrprtrurvr|rrrrrrrrRrSrTrUrVrXrjoinkeysZ_FREQUENCY_CONDITIONrZ CFTIME_TICKSrrrrrrrrrrrrrs*)       W&    ) 4&                                                        E   9 ] _