From Code to Community: Sponsoring The Perl and Raku Conference 2025 Learn more

#!./perl
use strict;
use Config;
use Test::More 0.96;
use Time::Local qw(
timegm
timelocal
timegm_modern
timelocal_modern
timegm_nocheck
timelocal_nocheck
timegm_posix
timelocal_posix
);
my @local_subs = qw(
timelocal
timelocal_modern
timelocal_posix
timelocal_nocheck
);
my @gm_subs = qw(
timegm
timegm_modern
timegm_posix
timegm_nocheck
);
# Use 3 days before the start of the epoch because with Borland on
# Win32 it will work for -3600 _if_ your time zone is +01:00 (or
# greater).
my $neg_epoch_ok
= $^O eq 'VMS' ? 0 : defined( ( localtime(-259200) )[0] ) ? 1 : 0;
# On some old 32-bit Perls the call to gmtime here may return an undef.
my $large_epoch_ok = eval { ( ( gmtime 2**40 )[5] || 0 ) == 34912 };
subtest( 'valid times', \&_test_valid_times );
subtest( 'diff between two calls', \&_test_diff_between_two_calls );
subtest(
\&_test_dst_transition_bug,
);
subtest( 'Time::Local::_is_leap_year', \&_test_is_leap_year );
subtest( 'negative epochs', \&_test_negative_epochs );
subtest( 'large epoch values', \&_test_large_epoch_values );
subtest( '2-digit years', \&_test_2_digit_years );
subtest( 'invalid values', \&_test_invalid_values );
subtest( 'non-integer seconds', \&_test_non_integer_seconds );
sub _test_valid_times {
my %tests = (
'simple times' => [
[ 1970, 1, 2, 0, 0, 0 ],
[ 1980, 2, 28, 12, 0, 0 ],
[ 1980, 2, 29, 12, 0, 0 ],
[ 1999, 12, 31, 23, 59, 59 ],
[ 2000, 1, 1, 0, 0, 0 ],
[ 2010, 10, 12, 14, 13, 12 ],
],
'leap days' => [
[ 2020, 2, 29, 12, 59, 59 ],
[ 2030, 7, 4, 17, 7, 6 ],
],
'non-integer seconds' => [
[ 2010, 10, 12, 14, 13, 12.1 ],
[ 2010, 10, 12, 14, 13, 59.1 ],
],
);
# The following test fails on a surprising number of systems
# so it is commented out. The end of the Epoch for a 32-bit signed
# implementation of time_t should be Jan 19, 2038 03:14:07 UTC.
# [2038, 1, 17, 23, 59, 59], # last full day in any tz
# more than 2**31 time_t - requires a 64bit safe localtime/gmtime
$tests{'greater than 2**31 seconds'} = [ [ 2258, 8, 11, 1, 49, 17 ] ]
if $] >= 5.012000;
# use vmsish 'time' makes for oddness around the Unix epoch
$tests{'simple times'}[0][2]++
if $^O eq 'VMS';
$tests{'negative epoch'} = [
[ 1969, 12, 31, 16, 59, 59 ],
[ 1950, 4, 12, 9, 30, 31 ],
] if $neg_epoch_ok;
for my $group ( sort keys %tests ) {
subtest(
$group,
sub { _test_group( $tests{$group} ) },
);
}
}
sub _test_group {
my $group = shift;
for my $vals ( @{$group} ) {
my ( $year, $mon, $mday, $hour, $min, $sec ) = @{$vals};
$mon--;
# 1970 test on VOS fails
next if $^O eq 'vos' && $year == 1970;
for my $sub (@local_subs) {
my $y = $year;
$y -= 1900 if $sub =~ /posix/;
my $time = __PACKAGE__->can($sub)
->( $sec, $min, $hour, $mday, $mon, $y );
my @lt = localtime($time);
is_deeply(
{
second => $lt[0],
minute => $lt[1],
hour => $lt[2],
day => $lt[3],
month => $lt[4],
year => $lt[5],
},
{
second => int($sec),
minute => $min,
hour => $hour,
day => $mday,
month => $mon,
year => $year - 1900,
},
"$sub( $sec, $min, $hour, $mday, $mon, $y )"
);
}
for my $sub (@gm_subs) {
my $y = $year;
$y -= 1900 if $sub =~ /posix/;
my $time = __PACKAGE__->can($sub)
->( $sec, $min, $hour, $mday, $mon, $y );
my @gt = gmtime($time);
is_deeply(
{
second => $gt[0],
minute => $gt[1],
hour => $gt[2],
day => $gt[3],
month => $gt[4],
year => $gt[5],
},
{
second => int($sec),
minute => $min,
hour => $hour,
day => $mday,
month => $mon,
year => $year - 1900,
},
"$sub( $sec, $min, $hour, $mday, $mon, $y )"
);
}
}
}
sub _test_diff_between_two_calls {
for my $sub (@local_subs) {
subtest(
$sub,
sub {
my $year = 1990;
$year -= 1900 if $sub =~ /posix/;
my $sub_ref = __PACKAGE__->can($sub);
for my $sec ( 0, 0.1 ) {
is(
$sub_ref->( $sec, 0, 1, 1, 0, $year )
- $sub_ref->( $sec, 0, 0, 1, 0, $year ),
3600,
'one hour difference between two calls'
);
is(
$sub_ref->( $sec, 2, 3, 1, 0, $year + 1 )
- $sub_ref->( $sec, 2, 3, 31, 11, $year ),
24 * 3600,
'one day difference between two calls across year boundary',
);
}
},
);
}
for my $sub (@gm_subs) {
subtest(
$sub,
sub {
my $year = 1980;
$year -= 1900 if $sub =~ /posix/;
my $sub_ref = __PACKAGE__->can($sub);
for my $sec ( 0, 0.1 ) {
# Diff beween Jan 1, 1980 and Mar 1, 1980 = (31 + 29 = 60 days)
is(
$sub_ref->( $sec, 0, 0, 1, 2, $year )
- $sub_ref->( $sec, 0, 0, 1, 0, $year ),
60 * 24 * 3600,
'60 day difference between two calls',
);
}
},
);
}
}
sub _test_dst_transition_bug {
for my $sub (@local_subs) {
subtest(
$sub,
sub {
my $year = 2002;
$year -= 2002 if $sub =~ /posix/;
my $sub_ref = __PACKAGE__->can($sub);
# At a DST transition, the clock skips forward, eg from
# 01:59:59 to 03:00:00. In this case, 02:00:00 is an
# invalid time, and should be treated like 03:00:00 rather
# than 01:00:00 - negative zone offsets used to do the
# latter.
my $hour
= ( localtime( $sub_ref->( 0, 0, 2, 7, 3, 102 ) ) )[2];
# testers in US/Pacific should get 3,
# other testers should get 2
ok( $hour == 2 || $hour == 3, 'hour should be 2 or 3' )
or diag "hour = $hour";
},
);
}
}
sub _test_is_leap_year {
my @years = (
[ 1900 => 0 ],
[ 1947 => 0 ],
[ 1996 => 1 ],
[ 2000 => 1 ],
[ 2100 => 0 ],
);
for my $p (@years) {
my ( $year, $is_leap_year ) = @$p;
my $string = $is_leap_year ? 'is' : 'is not';
## no critic (Subroutines::ProtectPrivateSubs)
is(
Time::Local::_is_leap_year($year), $is_leap_year,
"$year $string a leap year"
);
}
}
sub _test_negative_epochs {
plan skip_all => 'this platform does not support negative epochs.'
unless $neg_epoch_ok;
for my $sub (@gm_subs) {
subtest(
$sub,
sub {
my $year_mod = $sub =~ /posix/ ? -1900 : 0;
my $sub_ref = __PACKAGE__->can($sub);
unless ( $sub =~ /nocheck/ ) {
local $@ = undef;
eval { $sub_ref->( 0, 0, 0, 29, 1, 1900 + $year_mod ); };
like(
$@, qr/Day '29' out of range 1\.\.28/,
'does not accept leap day in 1900'
);
local $@ = undef;
eval { $sub_ref->( 0, 0, 0, 29, 1, 200 + $year_mod ) };
like(
$@, qr/Day '29' out of range 1\.\.28/,
'does not accept leap day in 2100 (year passed as 200)'
);
}
local $@ = undef;
eval { $sub_ref->( 0, 0, 0, 29, 1, 0 + $year_mod ) };
is(
$@, q{},
'no error with leap day of 2000 (year passed as 0)'
);
local $@ = undef;
eval { $sub_ref->( 0, 0, 0, 29, 1, 1904 + $year_mod ) };
is( $@, q{}, 'no error with leap day of 1904' );
local $@ = undef;
eval { $sub_ref->( 0, 0, 0, 29, 1, 4 + $year_mod ) };
is(
$@, q{},
'no error with leap day of 2004 (year passed as 4)'
);
local $@ = undef;
eval { $sub_ref->( 0, 0, 0, 29, 1, 96 + $year_mod ) };
is(
$@, q{},
'no error with leap day of 1996 (year passed as 96)'
);
},
);
}
}
sub _test_large_epoch_values {
plan skip_all => 'These tests require support for large epoch values'
unless $large_epoch_ok;
for my $sub (@gm_subs) {
subtest(
$sub,
sub {
my $year_mod = $sub =~ /posix/ ? -1900 : 0;
my $sub_ref = __PACKAGE__->can($sub);
is(
$sub_ref->( 8, 14, 3, 19, 0, 2038 + $year_mod ),
2**31,
'can call with 2**31 epoch seconds',
);
is(
$sub_ref->( 16, 28, 6, 7, 1, 2106 + $year_mod ),
2**32,
'can call with 2**32 epoch seconds (on a 64-bit system)',
);
is(
$sub_ref->( 16, 36, 0, 20, 1, 36812 + $year_mod ),
2**40,
'can call with 2**40 epoch seconds (on a 64-bit system)',
);
},
);
}
}
sub _test_2_digit_years {
my $current_year = ( localtime() )[5];
my $pre_break = ( $current_year + 49 ) - 100;
my $break = ( $current_year + 50 ) - 100;
my $post_break = ( $current_year + 51 ) - 100;
subtest(
'legacy year munging',
sub {
plan skip_all => 'Requires support for an large epoch values'
unless $large_epoch_ok;
is(
(
( localtime( timelocal( 0, 0, 0, 1, 1, $pre_break ) ) )[5]
),
$pre_break + 100,
"year $pre_break is treated as next century",
);
is(
( ( localtime( timelocal( 0, 0, 0, 1, 1, $break ) ) )[5] ),
$break + 100,
"year $break is treated as next century",
);
is(
(
( localtime( timelocal( 0, 0, 0, 1, 1, $post_break ) ) )
[5]
),
$post_break,
"year $post_break is treated as current century",
);
}
);
subtest(
'modern',
sub {
plan skip_all =>
'Requires negative epoch support and large epoch support'
unless $neg_epoch_ok && $large_epoch_ok;
is(
(
(
localtime(
timelocal_modern( 0, 0, 0, 1, 1, $pre_break )
)
)[5]
)
+ 1900,
$pre_break,
"year $pre_break is treated as year $pre_break",
);
is(
(
(
localtime(
timelocal_modern( 0, 0, 0, 1, 1, $break )
)
)[5]
)
+ 1900,
$break,
"year $break is treated as year $break",
);
is(
(
(
localtime(
timelocal_modern( 0, 0, 0, 1, 1, $post_break )
)
)[5]
)
+ 1900,
$post_break,
"year $post_break is treated as year $post_break",
);
},
);
}
sub _test_invalid_values {
my %bad = (
'month > bounds' => [ 1995, 13, 1, 1, 1, 1 ],
'day > bounds' => [ 1995, 2, 30, 1, 1, 1 ],
'hour > bounds' => [ 1995, 2, 10, 25, 1, 1 ],
'minute > bounds' => [ 1995, 2, 10, 1, 60, 1 ],
'second > bounds' => [ 1995, 2, 10, 1, 1, 60 ],
'month < bounds' => [ 1995, -1, 1, 1, 1, 1 ],
'day < bounds' => [ 1995, 2, -1, 1, 1, 1 ],
'hour < bounds' => [ 1995, 2, 10, -1, 1, 1 ],
'minute < bounds' => [ 1995, 2, 10, 1, -1, 1 ],
'second < bounds' => [ 1995, 2, 10, 1, 1, -1 ],
);
for my $sub ( grep { !/nocheck/ } @local_subs, @gm_subs ) {
subtest(
$sub,
sub {
for my $key ( sort keys %bad ) {
my ( $year, $mon, $mday, $hour, $min, $sec )
= @{ $bad{$key} };
$mon--;
local $@ = undef;
eval {
__PACKAGE__->can($sub)
->( $sec, $min, $hour, $mday, $mon, $year );
};
like(
$@, qr/.*out of range.*/,
"$key - @{ $bad{$key} }"
);
}
},
);
}
for my $sub ( grep {/nocheck/} @local_subs, @gm_subs ) {
subtest(
$sub,
sub {
for my $key ( sort keys %bad ) {
local $@ = q{};
eval { __PACKAGE__->can($sub)->( @{ $bad{$key} } ); };
is(
$@, q{},
"$key - @{ $bad{$key} } - no exception with checks disabled"
);
}
},
);
}
}
sub _test_non_integer_seconds {
my @epochs = ( 0, 1636484894 );
push @epochs, -1636484894 if $neg_epoch_ok;
# We want to get a lot of different values to smoke out floating point
# issues.
for my $i ( 1 .. 30 ) {
push @epochs, $i * 11;
push @epochs, $i * 11 * -1 if $neg_epoch_ok;
}
for my $epoch (@epochs) {
subtest(
"epoch = $epoch",
sub {
subtest(
'localtime',
sub {
my @lt = localtime($epoch);
my $orig_sec = $lt[0];
for my $i ( 1 .. 99 ) {
my $subsec = $i / 100;
$lt[0] = $orig_sec + $subsec;
my $time = timelocal_posix( @lt[ 0 .. 5 ] );
is(
$time, $epoch + $subsec,
"non-integer second of $subsec"
);
}
}
);
subtest(
'gmtime',
sub {
my @gt = ( gmtime($epoch) )[ 0 .. 5 ];
my $orig_sec = $gt[0];
for my $i ( 1 .. 99 ) {
my $subsec = $i / 100;
$gt[0] = $orig_sec + $subsec;
my $time = timegm_posix(@gt);
is(
$time, $epoch + $subsec,
"non-integer second of $subsec"
);
}
}
);
}
);
}
}
done_testing();