community.general.to_months 过滤器 – 将持续时间字符串转换为月份

注意

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

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

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

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

community.general 0.2.0 中的新增功能

概要

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

输入

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

参数

注释

输入

字符串 / 必需

要转换的时间字符串。

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

参数

注释

month

浮点数

每月的天数。

默认值： 30.0

year

浮点数

每年的天数。

默认值： 365.0

示例

- name: Convert a duration into months
  ansible.builtin.debug:
    msg: "{{ '1y 7m 5d 30h' | community.general.to_months }}"

返回值

键

描述

返回值

浮点数

月份数。

返回：成功

作者

  • René Moser (@resmo)

提示

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