Help language development. Donate to The Perl Foundation

LocalTime zef:tbrowder last updated on 2022-10-14

NAME

LocalTime - A wrapper of class DateTime with varied formatters depending on time zone entry

SYNOPSIS

use LocalTime;

DESCRIPTION

LocalTime is a wrapper class holding an instance of the Raku DateTime class. It was created to either add a local timezone (TZ) abbreviation to a time string or show either none or other TZ information depending on the use (or non-use) of the named variable :tz-abbrev. Following are the formatting effects of the various input conditions:

class DateTime

• The default format for DateTime:

  $ say DateTime.new: :2022year;
  2022-01-01T00:00:00Z
  

class LocalTime

• The default format for LocalTime with no time zone entry:

  $ say LocalTime.new: :2022year;
  2022-01-01T00:00:00 # <== note no trailing 'Z'
  

• The default format for LocalTime with 'CST' entered:

  $ say LocalTime.new: :2022year, :tz-abbrev('CST');
  2022-01-01T00:00:00 CST
  

• The format for LocalTime with a non-US TZ abbreviation entered:

  $ say LocalTime.new: :2022year, :tz-abbrev('XYT');
  2022-01-01T00:00:00 XYT
  

• The format for LocalTime with an empty :tz-abbrev named argument entered:

  $ say LocalTime.new: :2022year, :tz-abbrev;
  2022-01-01T00:00:00 Local Time (UTC -4 hrs)
  

Note for US TZ entries the user can enter either 'st' or 'dt' (case insensitive) and the correct form will be used for the time of year.

Currently only US abbreviations are in the 'use'd Timezones::US database, but a future modification will add others (perhaps in other languages also). PRs are welcome!

AUTHOR

Tom Browder [email protected]

COPYRIGHT AND LICENSE

© 2022 Tom Browder

This library is free software; you may redistribute or modify it under the Artistic License 2.0.