matplotlib.dates

Модуль Matplotlib предоставляет расширенные возможности для работы с датами при построении графиков, опираясь на возможности модуля Python datetime и дополнительного модуля dateutil.

По умолчанию, Matplotlib использует механизм работы с единицами, описанный в units, для преобразования объектов datetime.datetime и numpy.datetime64 при их отображении на осях x или y. Пользователю не нужно предпринимать никаких действий для форматирования дат, но часто для дат требуются специфические форматы, поэтому этот модуль предоставляет множество локеров и форматировщиков осей. Пример базового использования с numpy.datetime64:

import numpy as np

times = np.arange(np.datetime64('2001-01-02'),
                  np.datetime64('2002-02-03'), np.timedelta64(75, 'm'))
y = np.random.randn(len(times))

fig, ax = plt.subplots()
ax.plot(times, y)

new_ordinal = old_ordinal + mdates.date2num(np.datetime64('0000-12-31'))

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

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

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

classmatplotlib.dates.AutoDateFormatter(locator, tz=None, defaultfmt='%Y-%m-%d', *, usetex=None)[source]

Bases: Formatter

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

AutoDateFormatter имеет словарь .scale, который сопоставляет масштабы меток (интервал в днях между одной основной меткой) с форматными строками; по умолчанию этот словарь равен

self.scaled = {
    DAYS_PER_YEAR: rcParams['date.autoformatter.year'],
    DAYS_PER_MONTH: rcParams['date.autoformatter.month'],
    1: rcParams['date.autoformatter.day'],
    1 / HOURS_PER_DAY: rcParams['date.autoformatter.hour'],
    1 / MINUTES_PER_DAY: rcParams['date.autoformatter.minute'],
    1 / SEC_PER_DAY: rcParams['date.autoformatter.second'],
    1 / MUSECONDS_PER_DAY: rcParams['date.autoformatter.microsecond'],
}

Форматировщик использует форматную строку, соответствующую наименьшему ключу в словаре, который больше или равен текущему масштабу. Элементы словаря можно настроить:

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

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

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

formatter.scaled[1/(24*60)] = my_format_function

Автоматически форматировать метки дат.

Parameters:

locatorticker.Locator

Маркер, используемый этой осью.

tzstr or tzinfo, default: rcParams["timezone"] (default: 'UTC')

Часовой пояс меток. Если строка, tz передаётся в dateutil.tz.

defaultfmtstr

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

usetexbool, default: rcParams["text.usetex"] (default: False)

Включить/выключить использование математического режима TeX для рендеринга результатов форматировщика. Если какие-либо записи в self.scaled установлены как функции, то от кастомной функции зависит, включить или выключить математический режим TeX.

классmatplotlib.dates.AutoDateLocator(tz=None, minticks=5, maxticks=None, interval_multiples=True)[source]

Базы: DateLocator

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

Атрибуты:

intervalddict

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

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

где ключи определены в dateutil.rrule.

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

При настройке следует изменять только значения для существующих ключей. Не следует добавлять или удалять записи.

Пример принудительного использования делений каждые 3 часа:

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

Параметры:

tzstr или tzinfo, по умолчанию: rcParams["timezone"] (по умолчанию: 'UTC')

Часовой пояс делений. Если строка, tz передается в dateutil.tz.

minticksint

Минимальное количество делений; управляет тем, будут ли деления ежегодными, ежемесячными и т. д.

maxticksint

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

interval_multiplesbool, по умолчанию: True

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

get_locator(dmin, dmax)[source]

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

nonsingular(vmin, vmax)[source]

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

tick_values(vmin, vmax)[source]

Возвращает значения расположения делений, заданные vmin и vmax.

Примечание

Для получения расположения делений с автоматически определенными значениями vmin и vmax для соответствующего axis просто вызовите экземпляр локатора:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

классmatplotlib.dates.ConciseDateConverter(formats=None, zero_formats=None, offset_formats=None, show_offset=True, *, interval_multiples=True)[source]

Базы: DateConverter

axisinfo(unit, axis)[source]

Возвращает AxisInfo для unit.

unit — экземпляр tzinfo или None. Аргумент axis обязателен, но не используется.

классmatplotlib.dates.ConciseDateFormatter(locator, tz=None, formats=None, offset_formats=None, zero_formats=None, show_offset=True, *, usetex=None)[source]

Базы: Formatter

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

>>> locator = AutoDateLocator()
>>> formatter = ConciseDateFormatter(locator)

Параметры:

locatorticker.Locator

Locator, используемый данной осью.

tzstr или tzinfo, по умолчанию: rcParams["timezone"] (по умолчанию: 'UTC')

Временная зона тиков, передаваемая в dates.num2date.

formatsсписок из 6 строк, необязательно

Строки форматирования для 6 уровней маркировки тиков: в основном годы, месяцы, дни, часы, минуты и секунды. Строки используют те же коды форматирования, что и strftime. Значение по умолчанию ['%Y', '%b', '%d', '%H:%M', '%H:%M', '%S.%f']

zero_formatsсписок из 6 строк, необязательно

Строки форматирования для меток тиков, которые являются «нулями» для данного уровня тика. Например, если большинство тиков — это месяцы, тики около 1 января 2005 года будут помечены «дек», «2005», «фев». Значение по умолчанию ['', '%Y', '%b', '%b-%d', '%H:%M', '%H:%M']

offset_formatsсписок из 6 строк, необязательно

Строки форматирования для 6 уровней, которые применяются к строке «смещения», найденной справа от оси x или сверху от оси y. В сочетании с метками тиков это должно полностью определять дату. Значение по умолчанию:

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

show_offsetbool, по умолчанию: True

Определяет, отображать ли смещение.

usetexbool, по умолчанию: rcParams["text.usetex"] (по умолчанию: False)

Включить/выключить использование математического режима TeX для рендеринга результатов форматировщика.

Примеры

См. Форматирование меток тиков даты с помощью ConciseDateFormatter

(Source code, png)

Автоматическое форматирование меток дат. Формат по умолчанию используется для формирования начальной строки, а затем удаляются избыточные элементы.

format_data_short(value)[source]

Возвращает короткую строковую версию значения метки.

По умолчанию используется длинное значение, независимое от позиции.

format_ticks(values)[source]

Возвращает метки тиков для всех тиков сразу.

get_offset()[source]

классmatplotlib.dates.DateConverter(*, interval_multiples=True)[source]

Базы: ConversionInterface

Конвертер для данных datetime.date и datetime.datetime, или для данных даты/времени, представленных так, как они были бы преобразованы функцией date2num.

Тег «единица» для таких данных — None или экземпляр tzinfo.

axisinfo(unit, axis)[source]

Возвращает AxisInfo для unit.

unit — экземпляр tzinfo или None. Аргумент axis обязателен, но не используется.

статическийconvert(value, unit, axis)[source]

Если value еще не является числом или последовательностью чисел, преобразуйте его с помощью date2num.

Аргументы unit и axis не используются.

статическийdefault_units(x, axis)[source]

Возвращает экземпляр tzinfo объекта x или его первого элемента, или None

классmatplotlib.dates.DateFormatter(fmt, tz=None, *, usetex=None)[source]

Базы: Formatter

Форматирование отметки (в днях с эпохи) с помощью строки формата strftime.

Параметры:

fmtstr

Строка формата strftime

tzstr или tzinfo, по умолчанию: rcParams["timezone"] (по умолчанию: 'UTC')

Часовой пояс отметки. Если строка, то tz передаётся в dateutil.tz.

usetexbool, по умолчанию: rcParams["text.usetex"] (по умолчанию: False)

Включить/выключить использование математического режима TeX для рендеринга результатов форматировщика.

set_tzinfo(tz)[source]

классmatplotlib.dates.DateLocator(tz=None)[source]

Базы: Locator

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

Этот класс наследуется другими локерами и не предназначен для самостоятельного использования.

Параметры:

tzstr или tzinfo, по умолчанию: rcParams["timezone"] (по умолчанию: 'UTC')

Часовой пояс отметки. Если строка, то tz передаётся в dateutil.tz.

datalim_to_dt()[source]

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

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

nonsingular(vmin, vmax)[source]

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

set_tzinfo(tz)[source]

Установка информации о часовом поясе.

Параметры:

tzstr или tzinfo, по умолчанию: rcParams["timezone"] (по умолчанию: 'UTC')

Часовой пояс отметки. Если строка, то tz передаётся в dateutil.tz.

viewlim_to_dt()[source]

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

классmatplotlib.dates.DayLocator(bymonthday=None, interval=1, tz=None)[source]

Базы: RRuleLocator

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

Параметры:

bymonthdayint или список int, по умолчанию: все дни

Метки будут размещены на каждый день в bymonthday. По умолчанию bymonthday=range(1, 32), т.е. каждый день месяца.

intervalint, по умолчанию: 1

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

tzstr или tzinfo, по умолчанию: rcParams["timezone"] (по умолчанию: 'UTC')

Часовой пояс отметки. Если строка, то tz передаётся в dateutil.tz.

классmatplotlib.dates.HourLocator(byhour=None, interval=1, tz=None)[source]

Базы: RRuleLocator

Создаёт метки на каждом часу.

Параметры:

byhourint или список int, по умолчанию: все часы

Метки будут размещены на каждый час в byhour. По умолчанию byhour=range(24), т.е. каждый час.

intervalint, по умолчанию: 1

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

tzstr или tzinfo, по умолчанию: rcParams["timezone"] (по умолчанию: 'UTC')

Часовой пояс отметки. Если строка, то tz передаётся в dateutil.tz.

classmatplotlib.dates.MicrosecondLocator(interval=1, tz=None)[source]

Bases: DateLocator

Создавать метки на регулярных интервалах в одну или несколько микросекунд.

Примечание

По умолчанию Matplotlib использует представление времени с плавающей точкой в днях с эпохи, поэтому построение данных с микросекундным разрешением времени не работает хорошо для дат, которые находятся далеко (примерно 70 лет) от эпохи (проверьте с помощью get_epoch).

Если вам нужны графики с разрешением меньше микросекунды, настоятельно рекомендуется использовать значения с плавающей точкой для секунд, а не представление времени в формате datetime.

Если вам действительно необходимо использовать datetime.datetime() или аналогичное представление и вам всё ещё нужна точность до микросекунды, измените временную основу с помощью dates.set_epoch на значение, более близкое к датам, которые вы отображаете. См. Точность дат и эпохи.

Параметры:

intervalint, по умолчанию: 1

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

tzстрока или tzinfo, по умолчанию: rcParams["timezone"] (по умолчанию: 'UTC')

Часовой пояс меток. Если строка, tz передаётся в dateutil.tz.

set_axis(axis)[source]

tick_values(vmin, vmax)[source]

Возвращает значения размеченных меток, заданные vmin и vmax.

Примечание

Чтобы получить позиции меток с автоматически определенными значениями vmin и vmax для соответствующего axis просто вызовите экземпляр локера:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

classmatplotlib.dates.MinuteLocator(byminute=None, interval=1, tz=None)[source]

Bases: RRuleLocator

Создавать метки на каждом моменте.

Параметры:

byminuteint или список целых чисел, по умолчанию: все минуты

Метки будут размещаться на каждой минуте в byminute. По умолчанию byminute=range(60), т.е. каждая минута.

intervalint, по умолчанию: 1

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

tzстрока или tzinfo, по умолчанию: rcParams["timezone"] (по умолчанию: 'UTC')

Часовой пояс меток. Если строка, tz передаётся в dateutil.tz.

classmatplotlib.dates.MonthLocator(bymonth=None, bymonthday=1, interval=1, tz=None)[source]

Bases: RRuleLocator

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

Параметры:

bymonthint или список целых чисел, по умолчанию: все месяцы

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

bymonthdayint, по умолчанию: 1

День, на котором следует разместить метки.

intervalint, по умолчанию: 1

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

tzстрока или tzinfo, по умолчанию: rcParams["timezone"] (по умолчанию: 'UTC')

Часовой пояс меток. Если строка, tz передаётся в dateutil.tz.

classmatplotlib.dates.RRuleLocator(o, tz=None)[source]

Bases: DateLocator

Параметры:

tzстрока или tzinfo, по умолчанию: rcParams["timezone"] (по умолчанию: 'UTC')

Часовой пояс меток. Если строка, tz передаётся в dateutil.tz.

staticget_unit_generic(freq)[source]

tick_values(vmin, vmax)[source]

Возвращает значения размеченных меток, заданные vmin и vmax.

Примечание

Чтобы получить позиции меток с автоматически определенными значениями vmin и vmax для соответствующего axis просто вызовите экземпляр локера:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

классmatplotlib.dates.SecondLocator(bysecond=None, interval=1, tz=None)[source]

Основывается на RRuleLocator

Создаёт метки для каждого секунды.

Параметры:

bysecondint или список int, по умолчанию: все секунды

Метки будут размещаться на каждой секунде в bysecond. Значение по умолчанию — bysecond = range(60), т.е. каждая секунда.

intervalint, по умолчанию: 1

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

tzстрока или tzinfo, по умолчанию: rcParams["timezone"] (по умолчанию: 'UTC')

Часовой пояс меток. Если строка, то tz передаётся в dateutil.tz.

классmatplotlib.dates.WeekdayLocator(byweekday=1, interval=1, tz=None)[source]

Основывается на RRuleLocator

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

Параметры:

byweekdayint или список int, по умолчанию: все дни

Метки будут размещаться на каждом дне недели в byweekday. По умолчанию — каждый день.

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

intervalint, по умолчанию: 1

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

tzстрока или tzinfo, по умолчанию: rcParams["timezone"] (по умолчанию: 'UTC')

Часовой пояс меток. Если строка, то tz передаётся в dateutil.tz.

классmatplotlib.dates.YearLocator(base=1, month=1, day=1, tz=None)[source]

Основывается на RRuleLocator

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

Примеры:

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

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

Параметры:

baseint, по умолчанию: 1

Помечать метки каждые base лет.

monthint, по умолчанию: 1

Месяц, в котором должны быть размещены метки, начиная с 1. По умолчанию — январь.

dayint, по умолчанию: 1

День, в который должны быть размещены метки.

tzстрока или tzinfo, по умолчанию: rcParams["timezone"] (по умолчанию: 'UTC')

Часовой пояс меток. Если строка, то tz передаётся в dateutil.tz.

matplotlib.dates.date2num(d)[source]

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

Параметры:

ddatetime.datetime или numpy.datetime64 или последовательности этих

Возвращает:

число с плавающей точкой или последовательность чисел с плавающей точкой

Количество дней с момента эпохи. См. get_epoch для эпохи, которую можно изменить с помощью rcParams["date.epoch"] (по умолчанию: '1970-01-01T00:00:00') или set_epoch. Если эпоха равна "1970-01-01T00:00:00" (по умолчанию), то полдень 1 января 1970 ("1970-01-01T12:00:00") возвращает 0,5.

Примечания

Предполагается григорианский календарь; это не общепринятая практика. Подробности см. в документации модуля.

matplotlib.dates.datestr2num(d, default=None)[source]

Преобразует строку даты в datenum с использованием dateutil.parser.parse.

Параметры:

dстрока или последовательность строк

Даты для преобразования.

defaultdatetime.datetime, необязательно

Значение даты по умолчанию, используемое при отсутствии значений в d.

matplotlib.dates.drange(dstart, dend, delta)[source]

Возвращает последовательность равномерно распределённых дат Matplotlib.

Даты начинаются с dstart и доходят до, но не включая dend. Они разделены интервалом delta.

Параметры:

dstart, denddatetime

Пределы дат.

deltadatetime.timedelta

Интервал между датами.

Возвращает:

numpy.array

Список чисел, представляющих даты Matplotlib.

matplotlib.dates.get_epoch()[source]

Получить эпоху, используемую в dates.

Возвращает:

epochstr

Строка эпохи (обрабатывается функцией numpy.datetime64).

matplotlib.dates.num2date(x, tz=None)[source]

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

Параметры:

xfloat или последовательность чисел

Количество дней (дробная часть - часы, минуты, секунды) с момента эпохи. См. get_epoch для получения эпохи, которая может быть изменена с помощью rcParams["date.epoch"] (по умолчанию: '1970-01-01T00:00:00') или set_epoch.

tzstr или tzinfo, по умолчанию: rcParams["timezone"] (по умолчанию: 'UTC')

Временная зона для x. Если строка, tz передаётся в dateutil.tz.

Возвращает:

datetime или последовательность datetime

Даты возвращаются в временной зоне tz.

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

Примечания

Предполагается григорианский календарь; это не является универсальной практикой. Подробности см. в строке документации модуля.

matplotlib.dates.num2timedelta(x)[source]

Преобразовать количество дней в объект timedelta.

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

Параметры:

xчисло, последовательность чисел

Количество дней. Дробная часть представляет часы, минуты, секунды.

Возвращает:

datetime.timedelta или список[datetime.timedelta]

classmatplotlib.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 предназначен для применения к существующему datetime и может заменить определённые компоненты этого datetime или представлять интервал времени.

Он основан на спецификации отличной работы М.-А. Лембурга в его расширении 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 arithmetic
    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 arithmetic operation on the original datetime value
    with the information in the relativedelta.

weekday: 
    One of the weekday instances (MO, TU, etc) available in the
    relativedelta module. 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. This argument is always
    relative e.g. if the calculated date is already Monday, using MO(1)
    or MO(-1) won't change the day. To effectively make it absolute, use
    it in combination with the day argument (e.g. day=1, MO(1) for first
    Monday of the month).

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 к datetime:

1. Год
2. Месяц
3. День
4. Часы
5. Минуты
6. Секунды
7. Микросекунды

Наконец, применяется weekday, используя правило, описанное выше.

Например

>>> from datetime import datetime
>>> from dateutil.relativedelta import relativedelta, MO
>>> dt = datetime(2018, 4, 9, 13, 37, 0)
>>> delta = relativedelta(hours=25, day=1, weekday=MO(1))
>>> dt + delta
datetime.datetime(2018, 4, 2, 14, 37)

Сначала день устанавливается в 1 (первое число месяца), затем добавляются 25 часов, чтобы получить 2 день и 14 часов, а затем применяется weekday, но так как 2 уже понедельник, никакого эффекта нет.

normalized()

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

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

Возвращает:

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

свойствоweeks

classmatplotlib.dates.rrulewrapper(freq, tzinfo=None, **kwargs)[source]

Основы: object

Простой оболочка вокруг dateutil.rrule, позволяющая гибко указывать метки дат.

Параметры:

freq{YEARLY, MONTHLY, WEEKLY, DAILY, HOURLY, MINUTELY, SECONDLY}

Частота меток. Эти константы определены в dateutil.rrule, но они также доступны из matplotlib.dates.

tzinfodatetime.tzinfo, необязательно

Информация о часовом поясе. По умолчанию None.

**kwargs

Дополнительные ключевые аргументы передаются в dateutil.rrule.

set(**kwargs)[source]

Установка параметров для существующей оболочки.

matplotlib.dates.set_epoch(epoch)[source]

Установка эпохи (начала отсчета дат) для расчётов datetime.

По умолчанию эпоха — rcParams["dates.epoch"] (по умолчанию 1970-01-01T00:00).

Если требуется точность до микросекунд, дата, отображаемая на графике, должна находиться приблизительно в пределах 70 лет от эпохи. Matplotlib внутренне представляет даты как количество дней, прошедших с эпохи, поэтому диапазон значений с плавающей точкой должен находиться в пределах множителя 2^52.

set_epoch необходимо вызвать перед преобразованием каких-либо дат (то есть приблизительно в разделе импорта), иначе будет поднято исключение RuntimeError.

См. также Точность дат и эпохи.

Параметры:

epochstr

действительная UTC-дата, разбираемая numpy.datetime64 (не включайте часовой пояс).