даты

matplotlib.dates

Matplotlib предоставляет расширенные возможности для построения графиков дат, опираясь на возможности python datetime, дополняющих модулей pytz и dateutil. datetime объекты преобразуются в числа с плавающей запятой, представляющие время в днях с 0001-01-01 UTC, плюс 1. Например, 0001-01-01, 06:00 — это 1.25, а не 0.25. Вспомогательные функции date2num(), num2date() и drange() используются для лёгкого преобразования в и из datetime и числовых диапазонов.

In [31]:date(2006,4,1).toordinal() - date(1,1,1).toordinal()
Out[31]:732401

В этом модуле предоставляется широкий спектр специфических и общих тикеров и форматирователей дат. См. matplotlib.ticker для общей информации о тикерах и форматирователях. Они описаны ниже.

Все преобразователи, тикееры и форматировщики дат matplotlib учитывают часовой пояс, а по умолчанию часовой пояс задаётся параметром timezone в вашем matplotlibrc файле. Если вы не указываете экземпляр tz часового пояса, используется значение по умолчанию из вашего файла rc. Если вы хотите использовать пользовательский часовой пояс, передайте экземпляр pytz.timezone с ключевым аргументом tz к num2date(), plot_date(), и любым созданным вами пользовательским тикерам или локерам дат. См. pytz для получения информации о pytz и обработке часовых поясов.

Модуль dateutil предоставляет дополнительный код для обработки маркировки дат, что упрощает размещение меток на любых типах дат. См. примеры ниже.

Тикеры дат

Большинство тикеров дат могут определять одно или несколько значений. Например:

# 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))

Кроме того, большинство конструкторов принимают аргумент интервала:

# tick on mondays every second week
loc = WeekdayLocator(byweekday=MO, interval=2)

Локатор rrule позволяет полностью настроить маркировку дат:

# tick every 5th easter
rule = rrulewrapper(YEARLY, byeaster=1, interval=5)
loc = RRuleLocator(rule)

Ниже приведены все тикеры дат:

• MinuteLocator: определяет минуты
• HourLocator: определяет часы
• DayLocator: определяет указанные дни месяца
• WeekdayLocator: определяет дни недели, например, ПО, ВТ
• MonthLocator: определяет месяцы, например, 7 для июля
• YearLocator: определяет года, кратные основанию
• RRuleLocator: определяет с помощью matplotlib.dates.rrulewrapper. rrulewrapper — это простой оболочка вокруг dateutil.rrule (dateutil), который позволяет задавать практически любые параметры маркировки дат. См. пример rrule.
• AutoDateLocator: При автоматическом масштабировании этот класс выбирает лучший MultipleDateLocator для установки пределов просмотра и положения меток.

Форматировщики дат

Вот все форматировщики дат:

• AutoDateFormatter: пытается определить лучший формат. Это наиболее полезно при использовании с AutoDateLocator.
• DateFormatter: используйте strftime() строки форматирования
• IndexDateFormatter: графики дат с неявным индексированием x.

matplotlib.dates.date2num(d)

Преобразует объекты datetime в даты Matplotlib.

Параметры:	d : datetime или последовательность datetime
Возвращает:	число с плавающей точкой или последовательность чисел с плавающей точкой Количество дней (дробная часть представляет часы, минуты, секунды) с 0001-01-01 00:00:00 UTC, плюс один.

Примечания

Добавление единицы здесь — это артефакт истории. Также обратите внимание, что предполагается григорианский календарь; эта практика не является универсальной. Подробнее см. в строке документации модуля.

matplotlib.dates.num2date(x, tz=None)

Параметры:	x : число или последовательность чисел Количество дней (дробная часть представляет часы, минуты, секунды) с момента 0001-01-01 00:00:00 UTC, плюс один. tz : строка, необязательно Временная зона x (по умолчанию используется значение из rcparams TZ).
Возвращает:	datetime или последовательность datetime Даты возвращаются во временной зоне tz Если x является последовательностью, последовательность объектов datetime будет возвращена.

Примечания

Добавление единицы здесь — исторический артефакт. Кроме того, следует учитывать, что предполагается григорианский календарь; это не является универсальной практикой. Подробности см. в строке документации модуля.

matplotlib.dates.num2timedelta(x)

Преобразует количество дней в объект timdelta. Если x является последовательностью, последовательность объектов timedelta будет возвращена.

Параметры:	x : число, последовательность чисел Количество дней (дробная часть представляет часы, минуты, секунды)
Возвращает:	timedelta или список[timedelta]

matplotlib.dates.drange(dstart, dend, delta)

Возвращает диапазон дат в виде порядковых чисел григорианского календаря. dstart и dend — объекты datetime. delta — объект datetime.timedelta.

matplotlib.dates.epoch2num(e)

Преобразует эпоху или последовательность эпох в новый формат даты, то есть число дней с 0001.

matplotlib.dates.num2epoch(d)

Преобразует число дней с 0001 в эпоху. d может быть числом или последовательностью.

matplotlib.dates.mx2num(mxdates)

Преобразует объект mx datetime (или последовательность объектов mx) в новый формат даты.

class matplotlib.dates.DateFormatter(fmt, tz=None)

Базовый класс: matplotlib.ticker.Formatter

Позиция метки — секунды с начала эпохи. Используйте строку формата strftime().

Python поддерживает форматирование datetime strftime() только для годов, больших чем 1900. Благодаря Андрею Далке, Dalke Scientific Software, который внес вклад в код strftime() для включения дат, предшествующих этому году.

fmt is a strftime() format string; tz is the

tzinfo экземпляр.

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

set_tzinfo(tz)

strftime(dt, fmt=None)

См. документацию для datetime.strftime.

fmt — строка формата strftime().

Предупреждение: для лет до 1900 в зависимости от текущего языка возможно, что год, отображаемый с помощью %x, будет неверным. Для лет до 100 %y и %Y будут давать заполненные нулями строки.

strftime_pre_1900(dt, fmt=None)

Вызывает time.strftime для лет до 1900, сдвигая вперед на кратное 28 лет.

fmt — строка формата strftime().

Далке: Надеюсь, я правильно выполнил эти вычисления. Календарь повторяется каждые 28 лет, за исключением високосных лет столетия, за исключением високосных лет, длящегося 400 лет. Но только если вы используете григорианский календарь.

class matplotlib.dates.IndexDateFormatter(t, fmt, tz=None)

Базовый класс: matplotlib.ticker.Formatter

Используйте с IndexLocator для циклического форматирования строк по индексу.

t — последовательность дат (числа с плавающей точкой — дни). fmt — строка формата strftime().

class matplotlib.dates.AutoDateFormatter(locator, tz=None, defaultfmt='%Y-%m-%d')

Базовый класс: matplotlib.ticker.Formatter

Этот класс пытается определить лучший формат для использования. Это наиболее полезно при использовании с AutoDateLocator.

У AutoDateFormatter есть словарь масштаба, который сопоставляет масштаб метки (расстояние в днях между одной основной меткой) и строку формата. По умолчанию он выглядит следующим образом:

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'],
    }

Алгоритм выбирает ключ в словаре, который больше или равен текущему масштабу, и использует эту строку формата. Вы можете настроить этот словарь следующим образом:

>>> locator = AutoDateLocator()
>>> formatter = AutoDateFormatter(locator)
>>> formatter.scaled[1/(24.*60.)] = '%M:%S' # only show min and sec

Также можно использовать настраиваемый FuncFormatter. Следующий пример показывает, как использовать пользовательскую функцию форматирования для удаления хвостовых нулей из десятичных секунд и добавления даты к первой метке:

>>> 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)

Автоматически форматируйте метки дат. Формат по умолчанию — тот, который нужно использовать, если ни одно из значений в self.scaled не больше единицы, возвращаемой locator._get_unit().

class matplotlib.dates.DateLocator(tz=None)

Базовый класс: matplotlib.ticker.Locator

Определяет расположение меток при построении графиков дат.

tz — объект tzinfo.

datalim_to_dt()

Преобразует интервал данных осей в объекты datetime.

hms0d = {'byhour': 0, 'byminute': 0, 'bysecond': 0}

nonsingular(vmin, vmax)

В случае, если предложенный верхний и нижний пределы слишком близки к сингулярным (т. е. к диапазону ~0), отрегулируйте диапазон.

set_tzinfo(tz)

Установить информацию о временной зоне.

viewlim_to_dt()

Преобразует интервал просмотра в объекты datetime.

class matplotlib.dates.RRuleLocator(o, tz=None)

Базовый класс: matplotlib.dates.DateLocator

autoscale()

Установить пределы просмотра, включая диапазон данных.

static get_unit_generic(freq)

tick_values(vmin, vmax)

class matplotlib.dates.AutoDateLocator(tz=None, minticks=5, maxticks=None, interval_multiples=False)

Базы: matplotlib.dates.DateLocator

При автоматическом масштабировании этот класс выбирает лучший DateLocator для установки пределов отображения и расположения делений.

minticks — минимальное количество делений, используемое для выбора типа делений (годовые, ежемесячные и т. д.).

maxticks — максимальное количество делений, контролирующее интервал между делениями (каждое второе, каждое третье и т. д.). Для более точного управления это может быть словарь, сопоставляющий отдельные константы частоты rrule (YEARLY, MONTHLY и т. д.) с их собственным максимальным количеством делений. Это может использоваться для поддержания количества делений, соответствующего формату, выбранному в AutoDateFormatter. Любая частота, не указанная в этом словаре, получает значение по умолчанию.

tz — экземпляр tzinfo.

interval_multiples — логическое значение, указывающее, должны ли деления выбираться кратными интервала. Это зафиксирует деления в «более удобных» местах. Например, это принудительно установит деления на часы 0, 6, 12, 18 при часовом тике с интервалом в 6 часов.

У AutoDateLocator есть словарь интервалов, который сопоставляет частоту делений (константу из dateutil.rrule) и допускаемые кратные значения для этих делений. Значение по умолчанию выглядит так:

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],
  }

Интервал используется для указания кратных значений, которые подходят для частоты делений. Например, каждые 7 дней уместно для ежедневных делений, но для минут/секунд разумными являются 15 или 30. Вы можете настроить этот словарь следующим образом:

locator = AutoDateLocator()
locator.intervald[HOURLY] = [3] # only show every 3 hours

autoscale()

Попытаться разумно выбрать пределы отображения.

get_locator(dmin, dmax)

Выбор лучшего локатора на основе расстояния.

nonsingular(vmin, vmax)

refresh()

Обновить внутреннюю информацию на основе текущих пределов.

set_axis(axis)

tick_values(vmin, vmax)

class matplotlib.dates.YearLocator(base=1, month=1, day=1, tz=None)

Базы: matplotlib.dates.DateLocator

Создаёт деления в заданный день каждого года, кратного base.

Примеры:

# Tick every year on Jan 1st
locator = YearLocator()

# Tick every 5 years on July 4th
locator = YearLocator(5, month=7, day=4)

Помечает годы, кратные base, в заданный месяц и день (по умолчанию 1 января).

autoscale()

Установка пределов отображения для включения диапазона данных.

tick_values(vmin, vmax)

class matplotlib.dates.MonthLocator(bymonth=None, bymonthday=1, interval=1, tz=None)

Базы: matplotlib.dates.RRuleLocator

Создаёт деления в каждое число месяца, например, 1, 3, 12.

Помечает каждый месяц в bymonth; bymonth может быть целым числом или последовательностью. По умолчанию range(1,13), то есть каждый месяц.

interval — интервал между каждой итерацией. Например, если interval=2, отмечать каждую вторую итерацию.

class matplotlib.dates.WeekdayLocator(byweekday=1, interval=1, tz=None)

Базы: matplotlib.dates.RRuleLocator

Создаёт деления в каждый день недели.

Помечает каждый день недели в byweekday; byweekday может быть числом или последовательностью.

Элементы byweekday должны быть одним из MO, TU, WE, TH, FR, SA, SU, константы из dateutil.rrule, импортированные в пространство имён matplotlib.dates.

interval задаёт количество недель для пропуска. Например, interval=2 отображает каждую вторую неделю.

class matplotlib.dates.DayLocator(bymonthday=None, interval=1, tz=None)

Базы: matplotlib.dates.RRuleLocator

Создаёт деления на каждое число месяца. Например, 1, 15, 30.

Помечает каждый день в bymonthday; bymonthday может быть целым числом или последовательностью.

По умолчанию отмечаются все дни месяца: bymonthday=range(1,32)

class matplotlib.dates.HourLocator(byhour=None, interval=1, tz=None)

Базы: matplotlib.dates.RRuleLocator

Создаёт деления в каждый час.

Помечает каждый час в byhour; byhour может быть целым числом или последовательностью. По умолчанию отмечается каждый час: byhour=range(24)

interval — интервал между каждой итерацией. Например, если interval=2, отмечать каждую вторую итерацию.

class matplotlib.dates.MinuteLocator(byminute=None, interval=1, tz=None)

Базы: matplotlib.dates.RRuleLocator

Создаёт деления в каждую минуту.

Помечает каждую минуту в byminute; byminute может быть целым числом или последовательностью. По умолчанию отмечается каждая минута: byminute=range(60)

interval — интервал между каждой итерацией. Например, если interval=2, отмечать каждую вторую итерацию.

class matplotlib.dates.SecondLocator(bysecond=None, interval=1, tz=None)

Базы: matplotlib.dates.RRuleLocator

Создаёт деления в каждую секунду.

Помечает каждую секунду в bysecond; bysecond может быть целым числом или последовательностью. По умолчанию отмечается каждая секунда: bysecond = range(60)

interval — интервал между каждой итерацией. Например, если interval=2, отмечать каждую вторую итерацию.

class matplotlib.dates.MicrosecondLocator(interval=1, tz=None)

Базы: matplotlib.dates.DateLocator

Создаёт деления в каждую микросекунду.

interval — интервал между каждой итерацией. Например, если interval=2, отмечать каждую вторую микросекунду.

set_axis(axis)

set_data_interval(vmin, vmax)

set_view_interval(vmin, vmax)

tick_values(vmin, vmax)

class matplotlib.dates.rrule(freq, dtstart=None, interval=1, wkst=None, count=None, until=None, bysetpos=None, bymonth=None, bymonthday=None, byyearday=None, byeaster=None, byweekno=None, byweekday=None, byhour=None, byminute=None, bysecond=None, cache=False)

Базы: dateutil.rrule.rrulebase

Это основа операции rrule. Она принимает все ключевые слова, определённые в RFC, в качестве параметров конструктора (кроме byday, которое было переименовано в byweekday) и ещё больше. Прототип конструктора:

rrule(freq)

Где freq должно быть одним из YEARLY, MONTHLY, WEEKLY, DAILY, HOURLY, MINUTELY или SECONDLY.

Примечание

Согласно RFC, раздел 3.3.10, экземпляры повторения, попадающие на недействительные даты и времена, игнорируются, а не принудительно изменяются:

Правила повторения могут генерировать экземпляры повторения с недействительной датой (например, 30 февраля) или несуществующим локальным временем (например, 1:30 утра в день, когда локальное время переведено вперёд на час в 1:00 утра). Такие экземпляры повторения ДОЛЖНЫ игнорироваться и НЕ ДОЛЖНЫ учитываться в качестве части набора повторений.

Это может привести к потенциально неожиданному поведению, например, когда начальная дата приходится на конец месяца:

>>> from dateutil.rrule import rrule, MONTHLY
>>> from datetime import datetime
>>> start_date = datetime(2014, 12, 31)
>>> list(rrule(freq=MONTHLY, count=4, dtstart=start_date))
... 
[datetime.datetime(2014, 12, 31, 0, 0),
 datetime.datetime(2015, 1, 31, 0, 0),
 datetime.datetime(2015, 3, 31, 0, 0),
 datetime.datetime(2015, 5, 31, 0, 0)]

Кроме того, она поддерживает следующие ключевые аргументы:

Параметры:

cache – Если задано, оно должно быть булевым значением, определяющим включение или отключение кеширования результатов. Если вы будете использовать тот же экземпляр rrule несколько раз, включение кеширования значительно улучшит производительность. dtstart – Начало повторения. Помимо того, что он является основой для повторения, отсутствующие параметры в окончательных экземплярах повторения также будут извлечены из этой даты. Если не указано, будет использоваться datetime.now(). interval – Интервал между каждой итерацией freq. Например, при использовании YEARLY, интервал 2 означает один раз каждые два года, но с HOURLY, это означает один раз каждые два часа. По умолчанию интервал равен 1. wkst – День начала недели. Должен быть одним из констант MO, TU, WE или целым числом, определяющим первый день недели. Это повлияет на повторения, основанные на еженедельных периодах. По умолчанию день начала недели взят из calendar.firstweekday() и может быть изменён с помощью calendar.setfirstweekday(). count – Количество генерируемых случаев. Примечание С версии 2.5.0 использование ключевого слова until вместе с ключевым словом count устарело, согласно RFC-2445 Раздел 4.3.10. until – Если задано, это должен быть экземпляр datetime, который определит предел повторения. Последнее повторение в правиле — это наибольшая дата и время, которая меньше или равна значению, указанному в параметре until. Примечание С версии 2.5.0 использование ключевого слова until вместе с ключевым словом count устарело, согласно RFC-2445 Раздел 4.3.10. bysetpos – Если задано, это должно быть целое число или последовательность целых чисел, положительных или отрицательных. Каждое заданное целое число будет указывать номер появления, соответствующий n-му появлению правила в периоде частоты. Например, bysetpos -1 в сочетании с частотой MONTHLY и byweekday (MO, TU, WE, TH, FR) даст последний рабочий день каждого месяца. bymonth – Если задано, это должно быть целое число или последовательность целых чисел, означающих месяцы для применения повторения. bymonthday – Если задано, это должно быть целое число или последовательность целых чисел, означающих числа месяца для применения повторения. byyearday – Если задано, это должно быть целое число или последовательность целых чисел, означающих день года для применения повторения. byweekno – Если задано, это должно быть целое число или последовательность целых чисел, означающих номера недель для применения повторения. Номера недель имеют значение, описанное в ISO8601, то есть первая неделя года — это та, которая содержит как минимум четыре дня нового года. byweekday – Если задано, это может быть целое число (0 == MO), последовательность целых чисел, одна из констант дня недели (MO, TU и т. д.) или последовательность этих констант. При указании этих переменных будут определены дни недели, где будет применено повторение. Также можно использовать аргумент n для экземпляров дней недели, который будет означать n-е появление этого дня недели в периоде. Например, при MONTHLY или YEARLY с BYMONTH, использование FR(+1) в byweekday укажет на первый четверг месяца, когда происходит повторение. Обратите внимание, что в документации RFC это указано как BYDAY, но было переименовано для избежания неоднозначности этого ключевого слова. byhour – Если задано, это должно быть целое число или последовательность целых чисел, означающих часы для применения повторения. byminute – Если задано, это должно быть целое число или последовательность целых чисел, означающих минуты для применения повторения. bysecond – Если задано, это должно быть целое число или последовательность целых чисел, означающих секунды для применения повторения. byeaster – Если задано, это должно быть целое число или последовательность целых чисел, положительных или отрицательных. Каждое целое число определит смещение от Пасхи. Передача смещения 0 в byeaster даст саму Пасху. Это расширение спецификации RFC.

replace(**kwargs)

Возвращает новое rrule с теми же атрибутами, кроме тех, для которых указаны новые значения в ключевых аргументах.

class matplotlib.dates.relativedelta(dt1=None, dt2=None, years=0, months=0, days=0, leapdays=0, weeks=0, hours=0, minutes=0, seconds=0, microseconds=0, year=None, month=None, day=None, weekday=None, yearday=None, nlyearday=None, hour=None, minute=None, second=None, microsecond=None)

Базы: object

Тип relativedelta основан на спецификации отличной работы M.-A. Lemburg в его расширении mx.DateTime. Однако обратите внимание, что этот тип НЕ реализует тот же алгоритм, что и его работа. Не ожидайте, что он будет вести себя как аналог mx.DateTime.

Существует два способа создания экземпляра relativedelta. Первый — передать ему два класса date/datetime:

relativedelta(datetime1, datetime2)

Второй — передать любое количество следующих ключевых аргументов:

relativedelta(arg1=x,arg2=y,arg3=z...)

year, month, day, hour, minute, second, microsecond:
    Absolute information (argument is singular); adding or subtracting a
    relativedelta with absolute information does not perform an aritmetic
    operation, but rather REPLACES the corresponding value in the
    original datetime with the value(s) in relativedelta.

years, months, weeks, days, hours, minutes, seconds, microseconds:
    Relative information, may be negative (argument is plural); adding
    or subtracting a relativedelta with relative information performs
    the corresponding aritmetic operation on the original datetime value
    with the information in the relativedelta.

weekday:
    One of the weekday instances (MO, TU, etc). These instances may
    receive a parameter N, specifying the Nth weekday, which could
    be positive or negative (like MO(+1) or MO(-2). Not specifying
    it is the same as specifying +1. You can also use an integer,
    where 0=MO.

leapdays:
    Will add given days to the date found, if year is a leap
    year, and the date found is post 28 of february.

yearday, nlyearday:
    Set the yearday or the non-leap year day (jump leap days).
    These are converted to day/month/leapdays information.

Вот поведение операций с relativedelta:

1. Вычислить абсолютный год, используя аргумент ‘year’, или исходный год datetime, если аргумент отсутствует.
2. Добавить относительный аргумент ‘years’ к абсолютному году.
3. Выполнить шаги 1 и 2 для месяца/месяцев.
4. Вычислить абсолютный день, используя аргумент ‘day’, или исходный день datetime, если аргумент отсутствует. Затем вычитаем из дня до тех пор, пока он не впишется в год и месяц, найденные после их операций.
5. Добавить относительный аргумент ‘days’ к абсолютному дню. Обратите внимание, что аргумент ‘weeks’ умножается на 7 и добавляется к ‘days’.
6. Выполнить шаги 1 и 2 для часа/часов, минуты/минут, секунды/секунд, микросекунды/микросекунд.
7. Если присутствует аргумент ‘weekday’, рассчитать день недели с заданной кортежем (wday, nth). wday — это индекс дня недели (0-6, 0=Пн), а nth — количество недель для добавления вперёд или назад, в зависимости от его знака. Обратите внимание, что если рассчитанная дата уже понедельник, например, использование (0, 1) или (0, -1) не изменит день.

normalized()

Возвращает версию этого объекта, представленного исключительно с использованием целочисленных значений для относительных атрибутов.

>>> relativedelta(days=1.5, hours=2).normalized()
relativedelta(days=1, hours=14)

Возвращает:	Возвращает объект dateutil.relativedelta.relativedelta .

weeks

matplotlib.dates.seconds(s)

Возвращает секунды как дни.

matplotlib.dates.minutes(m)

Возвращает минуты как дни.

matplotlib.dates.hours(h)

Возвращает часы как дни.

matplotlib.dates.weeks(w)

Возвращает недели как дни.