даты

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 учитывают часовой пояс, и значение по умолчанию определяется параметром часового пояса в вашем matplotlibrc файле. Если вы опустите экземпляр tz часового пояса, будет использоваться значение по умолчанию из вашего файла конфигурации. Если вы хотите использовать пользовательский часовой пояс, передайте экземпляр 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)

d — это либо datetime объект, либо последовательность дат.

Возвращаемое значение — число с плавающей запятой (или последовательность чисел с плавающей запятой), которое показывает количество дней (дробная часть представляет часы, минуты, секунды) с 0001-01-01 00:00:00 UTC, плюс единица. Добавление единицы здесь — историческая особенность. Также обратите внимание, что предполагается григорианский календарь; это не является универсальной практикой. Подробности см. в строке документации модуля.

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

x — число с плавающей запятой, которое показывает количество дней (дробная часть представляет часы, минуты, секунды) с 0001-01-01 00:00:00 UTC, плюс единица. Добавление единицы здесь — историческая особенность. Также обратите внимание, что предполагается григорианский календарь; это не является универсальной практикой. Подробности см. в строке документации модуля.

Возвращаемое значение — экземпляр datetime в часовом поясе tz (по умолчанию используется значение TZ из параметров rc).

Если x — последовательность, будет возвращена последовательность datetime объектов.

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 = {
   365.0  : '%Y',
   30.    : '%b %Y',
   1.0    : '%b %d %Y',
   1./24. : '%H:%M:%S',
   1. / (24. * 60.): '%H:%M:%S.%f',
   }

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

>>> 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 — булево значение, указывающее, следует ли выбирать тики, кратные интервалу. Это закрепит тики на «приятных» местах. Например, при часовом тике с интервалом 6 часов, это закрепит тики на 0,6,12,18 часах.

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

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

Примеры:

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

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

Отметить годы, которые являются кратными основанию, в заданном месяце и дне (по умолчанию 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, если он объединён с ежемесячной частотой, и 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)

Bases: object

Тип relativedelta основан на спецификации отличной работы М.-А. Лембурга в его расширении 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)

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