1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
package DateTime::TimeZone::OffsetOnly;
use strict;
use vars qw ($VERSION);
$VERSION = 0.02;
use DateTime::TimeZone;
use base 'DateTime::TimeZone';
use DateTime::TimeZone::UTC;
use Params::Validate qw( validate SCALAR );
sub new
{
my $class = shift;
my %p = validate( @_, { offset => { type => SCALAR },
} );
my $offset =
DateTime::TimeZone::offset_as_seconds( $p{offset} );
die "Invalid offset: $p{offset}\n" unless defined $offset;
return DateTime::TimeZone::UTC->new unless $offset;
my $self = { name => DateTime::TimeZone::offset_as_string( $offset ),
offset => $offset,
};
return bless $self, $class;
}
sub is_dst_for_datetime { 0 }
sub offset_for_datetime { $_[0]->{offset} }
sub offset_for_local_datetime { $_[0]->{offset} }
sub is_utc { 0 }
sub short_name_for_datetime { $_[0]->name }
sub category { undef }
sub STORABLE_freeze
{
my $self = shift;
return $self->name;
}
sub STORABLE_thaw
{
my $self = shift;
my $cloning = shift;
my $serialized = shift;
my $class = ref $self || $self;
my $obj;
if ( $class->isa(__PACKAGE__) )
{
$obj = __PACKAGE__->new( offset => $serialized );
}
else
{
$obj = $class->new( offset => $serialized );
}
%$self = %$obj;
return $self;
}
1;
__END__
=head1 NAME
DateTime::TimeZone::OffsetOnly - A DateTime::TimeZone object that just contains an offset
=head1 SYNOPSIS
my $offset_tz = DateTime::TimeZone->new( name => '-0300' );
=head1 DESCRIPTION
This class is used to provide the DateTime::TimeZone API needed by
DateTime.pm, but with a fixed offset. An object in this class always
returns the same offset as was given in its constructor, regardless of
the date.
=head1 USAGE
This class has the same methods as a real time zone object, but the
C<category()> method returns undef.
=head2 DateTime::TimeZone::OffsetOnly->new ( offset => $offset )
The value given to the offset parameter must be a string such as
"+0300". Strings will be converted into numbers by the
C<DateTime::TimeZone::offset_as_seconds()> function.
=head2 $tz->offset_for_datetime( $datetime )
No matter what date is given, the offset provided to the constructor
is always used.
=head2 $tz->name()
=head2 $tz->short_name_for_datetime()
Both of these methods return the offset in string form.
=head1 AUTHOR
Dave Rolsky, <autarch@urth.org>
=head1 COPYRIGHT & LICENSE
Copyright (c) 2003-2008 David Rolsky. All rights reserved. This
program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
The full text of the license can be found in the LICENSE file included
with this module.
=cut
|
