Фильтр community.general.to_years — преобразует строку длительности в годы

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

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

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

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

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

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

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

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

Параметр	Комментарии
Входные данные 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_years(key1=value1, key2=value2, ...)

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

Примеры

- name: Convert a duration into years
  ansible.builtin.debug:
    msg: "{{ '1053d 30h' | community.general.to_years }}"

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

Ключ	Описание
Возвращаемое значение 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_years_filter.html