community.general.to_years 过滤器 – 将持续时间字符串转换为年数

注意

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

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

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

要在剧本中使用它，请指定： community.general.to_years。

community.general 0.2.0 中的新增功能

概要

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

输入

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

参数

注释

输入

字符串 / 必需

要转换的时间字符串。

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

参数

注释

month

浮点数

每月的天数。

默认值： 30.0

year

浮点数

每年的天数。

默认值： 365.0

示例

- name: Convert a duration into years
  ansible.builtin.debug:
    msg: "{{ '1053d 30h' | community.general.to_years }}"

返回值

键

描述

返回值

浮点数

年数。

返回：成功

作者

  • René Moser (@resmo)

提示

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