This software enables the conversion of various date and time representations to the local sidereal time using Astro-Time and other related modules.
To use Time::LST, you'll need to know the longitude of the location relevant to your time. Once you have that information, you can call various methods to get the LST of a file's last modified time, the current LST, or an accurate representation of a given datetime in seconds since the epoch (adjusted for TimeZone).
With some methods, you can also input a timezone string to parse (solar) clock-and-calendar times accurately. Here's a quick example of how to use Time::LST:
use Time::LST qw(datetime2lst filestat2lst now2lst time2lst ymdhms2lst);
$long = -3.21145; # London, in degrees
$lst_from_string = datetime2lst('1942:8:7T17:00:00', -3.21145, 'BST'); # note approx only for pre-1970
$data_mod_lst = filestat2lst('mod', 'valid_path_to_a_file', $long); # or filestat2lst('create', $path, $long)
$now_as_lst = time2lst(time(), $long);
$lst_from_aref = ymdhms2lst([2006, 11, 21, 12, 15, 0], $long, 'EADT'); # optional timezone.
Overall, Time::LST seems to be a simple and effective tool for converting datetime representations or seconds since the epoch into local sidereal time. However, its usefulness might depend on your specific needs and circumstances.
Version 0.035: N/A