community.general.to_hours 过滤器 – 将持续时间字符串转换为小时

注意

此过滤器插件是 community.general 集合 (版本 10.1.0) 的一部分。

如果您正在使用 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。

要在 playbook 中使用它，请指定：community.general.to_hours。

community.general 0.2.0 中新增

概要

  • 解析人类可读的时间持续时间字符串并将其转换为小时。

输入

这描述了过滤器的输入，即 | community.general.to_hours 之前的数值。

参数

注释

输入

字符串 / 必填

要转换的时间字符串。

可以使用单位 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_hours(key1=value1, key2=value2, ...)

参数

注释

month

浮点数

每月的天数。

默认值： 30.0

year

浮点数

每年的天数。

默认值： 365.0

示例

- name: Convert a duration into hours
  ansible.builtin.debug:
    msg: "{{ '7d 30h 20m 10s 123ms' | community.general.to_hours }}"

返回值

键

描述

返回值

浮点数

小时数。

返回：成功

作者

  • René Moser (@resmo)

提示

每个条目类型的配置条目具有从低到高的优先级顺序。例如，列表中较低的变量将覆盖较高的变量。