The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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 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)

Will you support XYZ format?

Everyone has their favorite date/time format, and we'd like to support as many as possible. We have tried to support as much of ISO 8601 as possible, but we cannot support everything. Every new format we support runs the risk of slowing down things for existing formats. You can submit a feature request on Github for new formats but we may reject them if adding support would slow down others.

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/