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

Примечание

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

Вы, возможно, уже установили эту коллекцию, если используете пакет 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`.

Параметр

Комментарии

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

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

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

Можно использовать единицы 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, ...)

Параметр	Комментарии
единица строка	Единица времени для преобразования продолжительности. Доступные значения: `"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"`

Параметр

Комментарии

единица

строка

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

Доступные значения:

"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, ...)

Параметр	Комментарии
месяц число с плавающей точкой	Количество дней в месяце. По умолчанию: `30.0`
год число с плавающей точкой	Количество дней в году. По умолчанию: `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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/to_time_unit_filter.html