PPA Tools PPA Tools: Date

Summary

This module contains actions used to get dates & times.

Actions

ppa_tools.date.

add_seconds_to_timestamp

Add a number of seconds to a UNIX Epoch timestamp value

Minimum Plugin Version: 3.2.0

Input

timestamp: The UNIX Epoch timestamp to add the seconds to

seconds: The seconds to add to the timestamp

Output

A updated Date dictionary with the seconds added to it.

Example
1
2
3
4
- ppa_tools.date.add_seconds_to_timestamp:
    timestamp: 1601556657
    seconds: 500
  save: date

ppa_tools.date.

days_between

Get the number of days between two timestamps

Minimum Plugin Version: 3.2.0

Input

start_timestamp: The earliest of the two UNIX Epoch timestamps

end_timestamp: The latest of the two UNIX Epoch timestamps

Output

An integer.

Example
1
2
3
4
- ppa_tools.date.days_between:
    start_timestamp: 1601556657
    end_timestamp: 1601653847
  save: date

ppa_tools.date.

from_timestamp

Convert a UNIX Epoch timestamp into a Date dictionary

Minimum Plugin Version: 3.2.0

Input

timestamp: The UNIX Epoch timestamp to convert

Output

A single Date dictionary.

Example
1
2
3
- ppa_tools.date.from_timestamp:
    timestamp: 1601556657
  save: date

ppa_tools.date.

now

Get the current UTC date & time.

Minimum Plugin Version: 3.0.0

Input

This action takes no inputs.

Output

A single Date dictionary.

Example
1
2
- ppa_tools.date.now:
  save: date

ppa_tools.date.

subtract_seconds_from_timestamp

Subtract a number of seconds from a UNIX Epoch timestamp value

Minimum Plugin Version: 3.2.0

Input

timestamp: The UNIX Epoch timestamp to remove the seconds from

seconds: The seconds to subtract from the timestamp

Output

A updated Date dictionary with the seconds subtracted from it.

Example
1
2
3
4
- ppa_tools.date.subtract_seconds_from_timestamp:
    timestamp: 1601556657
    seconds: 500
  save: date