Фильтр 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.
Параметр | Комментарии |
|---|---|
Входные данные строка / обязательный | Строка времени для преобразования. Для обозначения года можно использовать единицы Допустимые строки представляют собой разделённые пробелами сочетания целого числа с необязательным знаком минус и единицы измерения. Примеры: |
Позиционные параметры
Здесь описаны позиционные параметры фильтра. В следующем примере это значения positional1, positional2 и так далее: input | community.general.to_time_unit(positional1, positional2, ...)
Параметр | Комментарии |
|---|---|
unit строка | Единица времени, в которую нужно преобразовать длительность. Варианты:
|
Именованные параметры
Здесь описаны именованные параметры фильтра. В следующем примере это значения key1=value1, key2=value2 и так далее: input | community.general.to_time_unit(key1=value1, key2=value2, ...)
Параметр | Комментарии |
|---|---|
month число с плавающей запятой | Количество дней в месяце. По умолчанию: |
year число с плавающей запятой | Количество дней в году. По умолчанию: |
Примечания
Примечание
- При совместном использовании именованных и позиционных параметров позиционные параметры должны указываться перед именованными:
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') }}"
Возвращаемое значение
Ключ | Описание |
|---|---|
Возвращаемое значение число с плавающей запятой | Количество единиц времени. Возвращается: при успешном выполнении |
Ссылки на коллекцию
© 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