Richard Clamp

NAME

Data::ICal::TimeZone - timezones for Data::ICal

SYNOPSIS

  use Data::ICal;
  use Data::ICal::TimeZone;

  my $cal = Data::ICal->new;
  my $zone = Data::ICal::TimeZone->new( timezone => 'Europe/London' );
  $cal->add_event( $zone->definition );
  my $event = Data::ICal::Entry::Event->new;
  $event->add_properties(
      summary => 'Go to the pub',
      dtstart => [ '20070316T180000' , { TZID => $zone->timezone } ],
      dtend   => [ '20070316T230000' , { TZID => $zone->timezone } ],
  );
  $cal->add_event( $event );

DESCRIPTION

Data::ICal::TimeZone provides a mechanism for adding the Olsen standard timezones to your ical documents, plus a copy of the Olsen timezone database.

METHODS

new( timezone => 'zone_name' )

Returns a timezone object, this will be a Data::ICal::TimeZone::Object

Returns a false value upon failure to locate the specified timezone or load it's data class; this false value is a Class::ReturnValue object and can be queried as to its error_message.

zones

Returns the a list of the supported timezones

DIAGNOSTICS

No timezone specified

You failed to specify a timezone argument to ->new

No such timezone '%s'

The timezone you specifed to ->new wasn't one this module knows of.

Couldn't require Data::ICal::TimeZone::Object::%s: %s

The underlying class didn't compile cleanly.

AUTHOR

Richard Clamp <richardc@unixbeard.net>

LICENCE AND COPYRIGHT

Copyright 2007, Richard Clamp. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.

BUGS

None currently known, please report any you find to the author.

VERSION

The current zone data was generated from tzdata2007g using Vzic 1.3.

SEE ALSO

Data::ICal::TimeZone::Object, Data::ICal

http://dialspace.dial.pipex.com/prod/dialspace/town/pipexdsl/s/asbm26/vzic/