'epoch2num', 'num2epoch', 'mx2num', 'DateFormatter',

'ConciseDateFormatter', 'IndexDateFormatter', 'AutoDateFormatter',

'DateLocator', 'RRuleLocator', 'AutoDateLocator', 'YearLocator',

'MonthLocator', 'WeekdayLocator',

'DayLocator', 'HourLocator', 'MinuteLocator',

'SecondLocator', 'MicrosecondLocator',

'rrule', 'MO', 'TU', 'WE', 'TH', 'FR', 'SA', 'SU',

'YEARLY', 'MONTHLY', 'WEEKLY', 'DAILY',

'HOURLY', 'MINUTELY', 'SECONDLY', 'MICROSECONDLY', 'relativedelta',

"""Retrieve the preferred timezone from the rcParams dictionary."""

s = matplotlib.rcParams['timezone']

if s == 'UTC':

return UTC

"""

# Convert to UTC

tzi = getattr(dt, 'tzinfo', None)

if tzi is not None:

dt = dt.astimezone(UTC)

tzi = UTC

base = float(dt.toordinal())

# If it's sufficiently datetime-like, it will have a `date()` method

cdate = getattr(dt, 'date', lambda: None)()

if cdate is not None:

# Get a datetime object at midnight UTC

midnight_time = datetime.time(0, tzinfo=tzi)

rdt = datetime.datetime.combine(cdate, midnight_time)

# Append the seconds as a fraction of a day

base += (dt - rdt).total_seconds() / SEC_PER_DAY

"""

# the "extra" ensures that we at least allow the dynamic range out to

# seconds. That should get out to +/-2e11 years.

extra = (d - d.astype('datetime64[s]')).astype('timedelta64[ns]')

t0 = np.datetime64('0001-01-01T00:00:00', 's')

dt = (d.astype('datetime64[s]') - t0).astype(np.float64)

dt += extra.astype(np.float64) / 1.0e9

dt = dt / SEC_PER_DAY + 1.0

NaT_int = np.datetime64('NaT').astype(np.int64)

d_int = d.astype(np.int64)

try:

dt[d_int == NaT_int] = np.nan

except TypeError:

if d_int == NaT_int:

dt = np.nan

"""

if tz is None:

tz = _get_rc_timezone()

ix, remainder = divmod(x, 1)

ix = int(ix)

if ix < 1:

raise ValueError('Cannot convert {} to a date. This often happens if '

'non-datetime values are passed to an axis that '

'expects datetime objects.'.format(ix))

dt = datetime.datetime.fromordinal(ix).replace(tzinfo=UTC)

# Since the input date `x` float is unable to preserve microsecond

# precision of time representation in non-antique years, the

# resulting datetime is rounded to the nearest multiple of

# `musec_prec`. A value of 20 is appropriate for current dates.

musec_prec = 20

remainder_musec = int(round(remainder * MUSECONDS_PER_DAY / musec_prec)

* musec_prec)

# For people trying to plot with full microsecond precision, enable

# an early-year workaround

if x < 30 * 365:

remainder_musec = int(round(remainder * MUSECONDS_PER_DAY))

# add hours, minutes, seconds, microseconds

dt += datetime.timedelta(microseconds=remainder_musec)

"""

def __init__(self, fmt):

""" fmt: any valid strptime format is supported """

self.fmt = fmt

def __call__(self, s):

"""s : string to be converted

"""

def __init__(self, fmt, encoding='utf-8'):

"""

super().__init__(fmt)

self.encoding = encoding

def __call__(self, b):

"""

s = b.decode(self.encoding)

"""

if isinstance(d, str):

dt = dateutil.parser.parse(d, default=default)

return date2num(dt)

else:

if default is not None:

d = [dateutil.parser.parse(s, default=default) for s in d]

d = np.asarray(d)

if not d.size:

return d

"""

if hasattr(d, "values"):

# this unpacks pandas series or dataframes...

d = d.values

if not np.iterable(d):

if (isinstance(d, np.datetime64) or

(isinstance(d, np.ndarray) and

np.issubdtype(d.dtype, np.datetime64))):

return _dt64_to_ordinalf(d)

return _to_ordinalf(d)

else:

d = np.asarray(d)

if np.issubdtype(d.dtype, np.datetime64):

return _dt64_to_ordinalf(d)

if not d.size:

return d

"""

if np.iterable(j):

j = np.asarray(j)

"""

if np.iterable(n):

n = np.asarray(n)

"""

if tz is None:

tz = _get_rc_timezone()

if not np.iterable(x):

return _from_ordinalf(x, tz)

else:

x = np.asarray(x)

if not x.size:

return x

"""

if not np.iterable(x):

return _ordinalf_to_timedelta(x)

else:

x = np.asarray(x)

if not x.size:

return x

"""

f1 = date2num(dstart)

f2 = date2num(dend)

step = delta.total_seconds() / SEC_PER_DAY

# calculate the difference between dend and dstart in times of delta

num = int(np.ceil((f2 - f1) / step))

# calculate end of the interval which will be generated

dinterval_end = dstart + num * delta

# ensure, that an half open interval will be generated [dstart, dend)

if dinterval_end >= dend:

# if the endpoint is greater than dend, just subtract one delta

dinterval_end -= delta

num -= 1

f2 = date2num(dinterval_end) # new float-endpoint

"""

illegal_s = re.compile(r"((^|[^%])(%%)*%s)")

def __init__(self, fmt, tz=None):

"""

if tz is None:

tz = _get_rc_timezone()

self.fmt = fmt

self.tz = tz

def __call__(self, x, pos=0):

if x == 0:

raise ValueError('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()')

return num2date(x, self.tz).strftime(self.fmt)

def set_tzinfo(self, tz):

self.tz = tz

@cbook.deprecated("3.0")

def _replace_common_substr(self, s1, s2, sub1, sub2, replacement):

"""Helper function for replacing substrings sub1 and sub2

# Find common indexes of substrings sub1 in s1 and sub2 in s2

# and make substitutions inplace. Because this is inplace,

# it is okay if len(replacement) != len(sub1), len(sub2).

i = 0

while True:

j = s1.find(sub1, i)

if j == -1:

break

i = j + 1

if s2[j:j + len(sub2)] != sub2:

continue

s1 = s1[:j] + replacement + s1[j + len(sub1):]

s2 = s2[:j] + replacement + s2[j + len(sub2):]

return s1, s2

@cbook.deprecated("3.0")

def strftime_pre_1900(self, dt, fmt=None):

"""Call time.strftime for years before 1900 by rolling

if fmt is None:

fmt = self.fmt

# Since python's time module's strftime implementation does not

# support %f microsecond (but the datetime module does), use a

# regular expression substitution to replace instances of %f.

# Note that this can be useful since python's floating-point

# precision representation for datetime causes precision to be

# more accurate closer to year 0 (around the year 2000, precision

# can be at 10s of microseconds).

fmt = re.sub(r'((^|[^%])(%%)*)%f',

r'\g<1>{0:06d}'.format(dt.microsecond), fmt)

year = dt.year

# For every non-leap year century, advance by

# 6 years to get into the 28-year repeat cycle

delta = 2000 - year

off = 6 * (delta // 100 + delta // 400)

year = year + off

# Move to between the years 1973 and 2000

year1 = year + ((2000 - year) // 28) * 28

year2 = year1 + 28

timetuple = dt.timetuple()

# Generate timestamp string for year and year+28

s1 = time.strftime(fmt, (year1,) + timetuple[1:])

s2 = time.strftime(fmt, (year2,) + timetuple[1:])

# Replace instances of respective years (both 2-digit and 4-digit)

# that are located at the same indexes of s1, s2 with dt's year.

# Note that C++'s strftime implementation does not use padded

# zeros or padded whitespace for %y or %Y for years before 100, but

# uses padded zeros for %x. (For example, try the runnable examples

# with .tm_year in the interval [-1900, -1800] on

# http://en.cppreference.com/w/c/chrono/strftime.) For ease of

# implementation, we always use padded zeros for %y, %Y, and %x.

s1, s2 = self._replace_common_substr(s1, s2,

"{0:04d}".format(year1),

"{0:04d}".format(year2),

"{0:04d}".format(dt.year))

s1, s2 = self._replace_common_substr(s1, s2,

"{0:02d}".format(year1 % 100),

"{0:02d}".format(year2 % 100),

"{0:02d}".format(dt.year % 100))

return cbook.unicode_safe(s1)

@cbook.deprecated("3.0")

def strftime(self, dt, fmt=None):

"""

if fmt is None:

fmt = self.fmt

fmt = self.illegal_s.sub(r"\1", fmt)

fmt = fmt.replace("%s", "s")

if dt.year >= 1900:

# Note: in python 3.3 this is okay for years >= 1000,

# refer to http://bugs.python.org/issue1777412

return cbook.unicode_safe(dt.strftime(fmt))

"""

def __init__(self, t, fmt, tz=None):

"""

if tz is None:

tz = _get_rc_timezone()

self.t = t

self.fmt = fmt

self.tz = tz

def __call__(self, x, pos=0):

'Return the label for time *x* at position *pos*'

ind = int(np.round(x))

if ind >= len(self.t) or ind <= 0:

return ''

"""

def __init__(self, locator, tz=None, formats=None, offset_formats=None,

zero_formats=None, show_offset=True):

"""

self._locator = locator

self._tz = tz

self.defaultfmt = '%Y'

# there are 6 levels with each level getting a specific format

# 0: mostly years, 1: months, 2: days,

# 3: hours, 4: minutes, 5: seconds

if formats:

if len(formats) != 6:

raise ValueError('formats argument must be a list of '

'6 format strings (or None)')

self.formats = formats

else:

self.formats = ['%Y', # ticks are mostly years

'%b', # ticks are mostly months

'%d', # ticks are mostly days

'%H:%M', # hrs

'%H:%M', # min

'%S.%f', # secs

]

# fmt for zeros ticks at this level. These are

# ticks that should be labeled w/ info the level above.

# like 1 Jan can just be labled "Jan". 02:02:00 can

# just be labeled 02:02.

if zero_formats:

if len(formats) != 6:

raise ValueError('zero_formats argument must be a list of '

'6 format strings (or None)')

self.zero_formats = zero_formats

elif formats:

# use the users formats for the zero tick formats

self.zero_formats = [''] + self.formats[:-1]

else:

# make the defaults a bit nicer:

self.zero_formats = [''] + self.formats[:-1]

self.zero_formats[3] = '%b-%d'

if offset_formats:

if len(offset_formats) != 6:

raise ValueError('offsetfmts argument must be a list of '

'6 format strings (or None)')

self.offset_formats = offset_formats

else:

self.offset_formats = ['',

'%Y',

'%Y-%b',

'%Y-%b-%d',

'%Y-%b-%d',

'%Y-%b-%d %H:%M']

self.offset_string = ''

self.show_offset = show_offset

def __call__(self, x, pos=None):

formatter = DateFormatter(self.defaultfmt, self._tz)

return formatter(x, pos=pos)

def format_ticks(self, values):

tickdatetime = [num2date(value) for value in values]

tickdate = np.array([tdt.timetuple()[:6] for tdt in tickdatetime])

# basic algorithm:

# 1) only display a part of the date if it changes over the ticks.

# 2) don't display the smaller part of the date if:

# it is always the same or if it is the start of the

# year, month, day etc.

# fmt for most ticks at this level

fmts = self.formats

# format beginnings of days, months, years, etc...

zerofmts = self.zero_formats

# offset fmt are for the offset in the upper left of the

# or lower right of the axis.

offsetfmts = self.offset_formats

# determine the level we will label at:

# mostly 0: years, 1: months, 2: days,

# 3: hours, 4: minutes, 5: seconds, 6: microseconds

for level in range(5, -1, -1):

if len(np.unique(tickdate[:, level])) > 1:

break

# level is the basic level we will label at.

# now loop through and decide the actual ticklabels

zerovals = [0, 1, 1, 0, 0, 0, 0]

labels = [''] * len(tickdate)

for nn in range(len(tickdate)):

if level < 5:

if tickdate[nn][level] == zerovals[level]:

fmt = zerofmts[level]

else:

fmt = fmts[level]

else:

# special handling for seconds + microseconds

if (tickdatetime[nn].second == tickdatetime[nn].microsecond

== 0):

fmt = zerofmts[level]

else:

fmt = fmts[level]

labels[nn] = tickdatetime[nn].strftime(fmt)

# special handling of seconds and microseconds:

# strip extra zeros and decimal if possible.

# this is complicated by two factors. 1) we have some level-4 strings

# here (i.e. 03:00, '0.50000', '1.000') 2) we would like to have the

# same number of decimals for each string (i.e. 0.5 and 1.0).

if level >= 5:

trailing_zeros = min(

(len(s) - len(s.rstrip('0')) for s in labels if '.' in s),

default=None)

if trailing_zeros:

for nn in range(len(labels)):

if '.' in labels[nn]:

labels[nn] = labels[nn][:-trailing_zeros].rstrip('.')

if self.show_offset:

# set the offset string:

self.offset_string = tickdatetime[-1].strftime(offsetfmts[level])

return labels

def get_offset(self):

return self.offset_string

def format_data_short(self, value):

"""

# This can be improved by providing some user-level direction on

# how to choose the best format (precedence, etc...)

# Perhaps a 'struct' that has a field for each time-type where a

# zero would indicate "don't show" and a number would indicate

# "show" with some sort of priority. Same priorities could mean

# show all with the same priority.