Spec-Zone.ru › Ansible

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

Примечание

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

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

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

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

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

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

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

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

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

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

Параметр

Комментарии

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

строка / обязательный

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

Для обозначения года можно использовать единицы 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.

Позиционные параметры

Здесь описаны позиционные параметры фильтра. В следующем примере это значения positional1, positional2 и так далее: input | community.general.to_time_unit(positional1, positional2, ...)

Параметр

Комментарии

unit

строка

Единица времени, в которую нужно преобразовать длительность.

Варианты:

  • "millisecond"
  • "milliseconds"
  • "ms" ← (по умолчанию)
  • "msec"
  • "msecs"
  • "msecond"
  • "mseconds"
  • "s"
  • "sec"
  • "secs"
  • "second"
  • "seconds"
  • "h"
  • "hour"
  • "hours"
  • "hs"
  • "m"
  • "min"
  • "mins"
  • "minute"
  • "minutes"
  • "d"
  • "ds"
  • "day"
  • "days"
  • "w"
  • "ws"
  • "week"
  • "weeks"
  • "mo"
  • "mos"
  • "month"
  • "months"
  • "y"
  • "ys"
  • "year"
  • "years"

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

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

Параметр

Комментарии

month

число с плавающей запятой

Количество дней в месяце.

По умолчанию: 30.0

year

число с плавающей запятой

Количество дней в году.

По умолчанию: 365.0

Примечания

Примечание

  • При совместном использовании именованных и позиционных параметров позиционные параметры должны указываться перед именованными: input | community.general.to_time_unit(positional1, positional2, key1=value1, key2=value2)

Примеры

- name: Convert a duration into seconds
  ansible.builtin.debug:
    msg: "{{ '1053d 17h 53m -10s 391ms' | community.general.to_time_unit('s') }}"

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

Ключ

Описание

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

число с плавающей запятой

Количество единиц времени.

Возвращается: при успешном выполнении

Авторы

  • 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_time_unit_filter.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API