NAME

Sort::Key::DateTime - Perl extension for sorting objects by some DateTime key

SYNOPSIS

  use Sort::Key::DateTime qw(dtkeysort);
  my @sorted = dtkeysort { $_->date } @meetings;

DESCRIPTION

Sort::Key::DateTime allows to sort objects by some (calculated) key of type DateTime.

EXPORTS

dtkeysort { CALC_DT_KEY } @array

returns the elements on @array sorted by the DateTime key calculated applying "{ CALC_DT_KEY }" to them.

Inside "{ CALC_DT_KEY }", the object is available as $_.

NOTE: sorting order is undefined when floating and non floating DateTime keys are mixed.

rdtkeysort { CALC_DT_KEY } @array

sorted @array in descending order

dtsort(@array)

rdtsort(@array)

sort an array of DateTime objects in ascending and descending order respectively.

Example:

  my @sorted = dtsort @unsorted;

dtkeysort_inplace { CALC_DT_KEY } @array

rdtkeysort_inplace { CALC_DT_KEY } @array

dtsort @array

rdtsort @array

sort @array in place.

mkkey_datetime($dt)

generates string sorting keys for DateTime objects

AUTHOR

Salvador Fandiño, <sfandino@yahoo.com<gt>

COPYRIGHT AND LICENSE