# NAME

`Date::Parse::Modern` - Provide string to unixtime conversions

# DESCRIPTION

`Date::Parse::Modern` provides a single function `strtotime()` which takes a datetime string
and returns a unixtime.  Care was given to support the most modern style strings that you would
commonly find in log files or on the internet.

# USAGE

    use Date::Parse::Modern;

`Date::Parse::Modern` exports the `strtotime()` function automatically.

# FUNCTIONS

## strtotime($string)

    my $unixtime = strtotime('1979-02-24'); # 288691200

Simply feed `strtotime()` a string with some type of date or time in it, and it will return an
integer unixtime. If the string is unparseable, or a weird error occurs, it will return `undef`.

All the "magic" in `strtotime()` is done using regular expressions that look for common datetime
formats. Common formats like YYYY-MM-DD and HH:II:SS are easily detected and converted to the
appropriate formats. This allows the date or time to be found anywhere in the string, in (almost) any
order. In all cases, the day of the week is ignored in the input string.

**Note:** Strings without a year are assumed to be in the current year. Example: `May 15th, 10:15am`

**Note:** Strings with only a date are assumed to occur at the midnight. Example: `2023-01-15`

**Note:** Strings with only time are assumed to be the current day. Example: `10:15am`

**Note:** In strings with numeric **and** textual time zone offsets, the numeric is used. Example:
`14 Nov 1994 11:34:32 -0500 (EST)`

# Bugs/Features

Please submit bugs and feature requests on Github:

    https://github.com/scottchiefbaker/perl-Date-Parse-Modern

# AUTHORS

Scott Baker - https://www.perturb.org/
