Salvador Fandiño García > Sort-Key-DateTime > Sort::Key::DateTime

Download:
Sort-Key-DateTime-0.07.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.07   Source  

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

SEE ALSO ^

Sort::Key, Sort::Key::Maker, perl sort function docs.

DateTime module documentation and FAQ available from the DateTime project web site at http://datetime.perl.org/

AUTHOR ^

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

COPYRIGHT AND LICENSE ^

Copyright (C) 2005, 2010 by Salvador Fandiño

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.4 or, at your option, any later version of Perl 5 you may have available.

syntax highlighting: