Skip to content
Parser for crontab date and time field
Perl
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib/Time
t
.gitignore
.travis.yml
Build.PL
Changes
LICENSE
META.json
README.md
cpanfile
minil.toml

README.md

NAME

Time::Crontab - parser for crontab date and time field

SYNOPSIS

use Time::Crontab;

my $time_cron = Time::Crontab->new('0 0 1 * *');
if ( $time_cron->match(time()) ) {
    do_cron_job();
}

DESCRIPTION

Time::Crontab is a parser for crontab date and time field. And it provides simple matcher.

METHOD

  • new($crontab:Str)

    Returns Time::Crontab object. If incorrect crontab string was given, Time::Crontab dies.

  • match($unix_timestamp:Num)

    Returns whether or not the given unix timestamp matches the crontab Timestamps are truncated to minute resolution.

SUPPORTED SPECS

Field name   Allowed values  Allowed special characters
Minutes      0-59            * / , -
Hours        0-23            * / , -
Day of month 1-31            * / , -
Month        1-12 or JAN-DEC * / , -
Day of week  0-6 or SUN-SAT  * / , -

Predefined scheduling definitions are not supported. In month and day_of_week fields, Able to use the first three letters of day or month. But does not support range or list of the names.

RELATED MODULES

  • DateTime::Event::Cron

    DateTime::Event::Cron that depends on DateTime. Time::Crontab does not require DateTime or Time::Piece.

  • Algorithm::Cron

    Algorithm::Cron also does not require DateTime. It's provides `next_time` method, Time::Crontab provides `match` method.

LICENSE

Copyright (C) Masahiro Nagano.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR

Masahiro Nagano kazeburo@gmail.com

Something went wrong with that request. Please try again.