README
NAME
DateTime::TimeZone - A Raku library for working with Time Zones
SYNOPSIS
use DateTime::TimeZone;
say tz-offset("-01:00"); # -3600
say timezone("Europe/Amsterdam").Int; # 3600 or 7200, depending on DST
my $dt = DateTime.now;
say to-timezone("America/Detroit", $dt);
say $dt.&to-timezone("America/Detroit");DESCRIPTION
DateTime::TimeZone is an app-facing set of friendly subroutines for working with timezones.
SUBROUTINES
tz-offset(Str:D $offset-string) --> Int:D
Parses common offset strings (such as "01:00" and "-03:00") and returns an Int value.
timezone(Str:D datetime?) --> DateTime::TimeZone:D
Returns a DateTime::TimeZone object representing the zone passed to it. These objects provide an .Int call, so they may be used directly as the :timezone parameter for a DateTime object.
This will support any timezone listed in the Olson database.
The $datetime is used to calculate the offset depending on Daylight Savings Time rules for the given Time Zone.
If $datetime is not passed, it assumes DateTime.now();
to-timezone(Str:D datetime) --> DateTime:D
A shortcut for: name, $datetime));
to-timezone(DateTime:D name) --> DateTime:D
Same as the Str,DateTime candidate, but allows being used as a method.
AUTHORS
Timothy Totten
Andrew Egeler
Source can be located at: https://github.com/raku-community-modules/DateTime-TimeZone . Comments and Pull Requests are welcome.
COPYRIGHT AND LICENSE
Copyright 2013 - 2019 Timothy Totten
Copyright 2020 - 2022 Raku Community
This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.