moved 'strftime' filter into 'Other Useful Filters' section (#45801)
(cherry picked from commit 065b7ac300
)
This commit is contained in:
parent
e3a2bf97a7
commit
58cd460952
1 changed files with 21 additions and 21 deletions
|
@ -1012,7 +1012,7 @@ To search a string with a regex, use the "regex_search" filter::
|
||||||
|
|
||||||
# will return empty if it cannot find a match
|
# will return empty if it cannot find a match
|
||||||
{{ 'ansible' | regex_search('(foobar)') }}
|
{{ 'ansible' | regex_search('(foobar)') }}
|
||||||
|
|
||||||
# case insensitive search in multiline mode
|
# case insensitive search in multiline mode
|
||||||
{{ 'foo\nBAR' | regex_search("^bar", multiline=True, ignorecase=True) }}
|
{{ 'foo\nBAR' | regex_search("^bar", multiline=True, ignorecase=True) }}
|
||||||
|
|
||||||
|
@ -1036,7 +1036,7 @@ To replace text in a string with regex, use the "regex_replace" filter::
|
||||||
|
|
||||||
# convert "localhost:80" to "localhost"
|
# convert "localhost:80" to "localhost"
|
||||||
{{ 'localhost:80' | regex_replace(':80') }}
|
{{ 'localhost:80' | regex_replace(':80') }}
|
||||||
|
|
||||||
# add "https://" prefix to each item in a list
|
# add "https://" prefix to each item in a list
|
||||||
{{ hosts | map('regex_replace', '^(.*)$', 'https://\\1') | list }}
|
{{ hosts | map('regex_replace', '^(.*)$', 'https://\\1') | list }}
|
||||||
|
|
||||||
|
@ -1161,6 +1161,25 @@ To get date object from string use the `to_datetime` filter, (new in version in
|
||||||
# get amount of days between two dates. This returns only number of days and discards remaining hours, minutes, and seconds
|
# get amount of days between two dates. This returns only number of days and discards remaining hours, minutes, and seconds
|
||||||
{{ (("2016-08-14 20:00:12" | to_datetime) - ("2015-12-25" | to_datetime('%Y-%m-%d'))).days }}
|
{{ (("2016-08-14 20:00:12" | to_datetime) - ("2015-12-25" | to_datetime('%Y-%m-%d'))).days }}
|
||||||
|
|
||||||
|
.. versionadded:: 2.4
|
||||||
|
|
||||||
|
To format a date using a string (like with the shell date command), use the "strftime" filter::
|
||||||
|
|
||||||
|
# Display year-month-day
|
||||||
|
{{ '%Y-%m-%d' | strftime }}
|
||||||
|
|
||||||
|
# Display hour:min:sec
|
||||||
|
{{ '%H:%M:%S' | strftime }}
|
||||||
|
|
||||||
|
# Use ansible_date_time.epoch fact
|
||||||
|
{{ '%Y-%m-%d %H:%M:%S' | strftime(ansible_date_time.epoch) }}
|
||||||
|
|
||||||
|
# Use arbitrary epoch value
|
||||||
|
{{ '%Y-%m-%d' | strftime(0) }} # => 1970-01-01
|
||||||
|
{{ '%Y-%m-%d' | strftime(1441357287) }} # => 2015-09-04
|
||||||
|
|
||||||
|
.. note:: To get all string possibilities, check https://docs.python.org/2/library/time.html#time.strftime
|
||||||
|
|
||||||
Combination Filters
|
Combination Filters
|
||||||
````````````````````
|
````````````````````
|
||||||
|
|
||||||
|
@ -1186,25 +1205,6 @@ Combinations always require a set size::
|
||||||
|
|
||||||
Also see the :ref:`zip_filter`
|
Also see the :ref:`zip_filter`
|
||||||
|
|
||||||
.. versionadded:: 2.4
|
|
||||||
|
|
||||||
To format a date using a string (like with the shell date command), use the "strftime" filter::
|
|
||||||
|
|
||||||
# Display year-month-day
|
|
||||||
{{ '%Y-%m-%d' | strftime }}
|
|
||||||
|
|
||||||
# Display hour:min:sec
|
|
||||||
{{ '%H:%M:%S' | strftime }}
|
|
||||||
|
|
||||||
# Use ansible_date_time.epoch fact
|
|
||||||
{{ '%Y-%m-%d %H:%M:%S' | strftime(ansible_date_time.epoch) }}
|
|
||||||
|
|
||||||
# Use arbitrary epoch value
|
|
||||||
{{ '%Y-%m-%d' | strftime(0) }} # => 1970-01-01
|
|
||||||
{{ '%Y-%m-%d' | strftime(1441357287) }} # => 2015-09-04
|
|
||||||
|
|
||||||
.. note:: To get all string possibilities, check https://docs.python.org/2/library/time.html#time.strftime
|
|
||||||
|
|
||||||
Debugging Filters
|
Debugging Filters
|
||||||
`````````````````
|
`````````````````
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue