Фильтр community.general.to_months — преобразование строки с длительностью в месяцы

Примечание

Этот плагин фильтра входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать коллекцию в плейбуке, укажите: community.general.to_months.

Добавлено в community.general 0.2.0

Краткое описание
Входные данные
Именованные параметры
Примеры
Возвращаемое значение

Краткое описание

Разбирает строку с длительностью времени в удобочитаемом формате и преобразует её в месяцы.

Входные данные

Здесь описаны входные данные фильтра — значение перед | community.general.to_months.

Параметр	Комментарии
Входные данные string / обязательный	Строка с указанием времени для преобразования. Для обозначения года можно использовать единицы `y` и `year`, месяца — `mo` и `month`, недели — `w` и `week`, дня — `d` и `day`, часа — `h` и `hour`, минуты — `m`, `min` и `minute`, секунды — `s`, `sec` и `second`, миллисекунды — `ms`, `msec`, `msecond` и `millisecond`. К единице также можно добавить суффикс `s`, поэтому `seconds` — это то же самое, что `second`. Допустимые строки представляют собой разделённые пробелами сочетания целого числа с необязательным знаком минус и единицы измерения. Примеры: `1h`, `-5m` и `3h -5m 6s`.

Параметр

Комментарии

Входные данные

string / обязательный

Строка с указанием времени для преобразования.

Для обозначения года можно использовать единицы y и year, месяца — mo и month, недели — w и week, дня — d и day, часа — h и hour, минуты — m, min и minute, секунды — s, sec и second, миллисекунды — ms, msec, msecond и millisecond. К единице также можно добавить суффикс s, поэтому seconds — это то же самое, что second.

Допустимые строки представляют собой разделённые пробелами сочетания целого числа с необязательным знаком минус и единицы измерения.

Примеры: 1h, -5m и 3h -5m 6s.

Именованные параметры

Здесь описаны именованные параметры фильтра. Это значения key1=value1, key2=value2 и так далее в следующем примере: input | community.general.to_months(key1=value1, key2=value2, ...)

Параметр	Комментарии
month float	Количество дней в месяце. По умолчанию: `30.0`
year float	Количество дней в году. По умолчанию: `365.0`

Примеры

- name: Convert a duration into months
  ansible.builtin.debug:
    msg: "{{ '1y 7m 5d 30h' | community.general.to_months }}"

Возвращаемое значение

Ключ	Описание
Возвращаемое значение float	Количество месяцев. Возвращается: в случае успеха

Авторы

René Moser (@resmo)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/to_months_filter.html