# parse_time()

## Purpose

parse_time(timestamp)

Converts an RFC 3164 or RFC 3339 formatted date/time string to a UNIX timestamp (an integer value representing the number of seconds since the UNIX epoch: 1970-01-01T00:00:0Z).

If the input to the function is not a properly formatted RFC 3164 or RFC 3339 date/time string, or cannot be parsed, `0` is returned and `script_error()` will be set to error state.

Note

This function does not support unusual RFC 3164 dates/times that contain year or time zone information.

Note

Fractional seconds (if present) in RFC 3339 date/time strings will be discarded.

## Example

In the following example a timestamp is parsed into an integer.

    parse_time("Oct 5 01:10:11") # Assumes the current year (2017, in this example)

produces

    1507165811

Support: rsyslog Assistant | GitHub Discussions | GitHub Issues: rsyslog source project

Contributing: Source & docs: rsyslog source project

© 2008–2025 Rainer Gerhards and others. Licensed under the Apache License 2.0.