X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=SL%2FHelper%2FDateTime.pm;h=15ab95a7b7473519989cd0f92aca72e4029a6830;hb=53593baa211863fbf66540cf1bcc36c8fb37257f;hp=b72207f8a4ba5edf22fe2744ddfead7673c4c09d;hpb=ee04154abdc7b72e773636d09ac3fbad5bf0a014;p=kivitendo-erp.git diff --git a/SL/Helper/DateTime.pm b/SL/Helper/DateTime.pm index b72207f8a..15ab95a7b 100644 --- a/SL/Helper/DateTime.pm +++ b/SL/Helper/DateTime.pm @@ -2,6 +2,17 @@ package DateTime; use strict; +use DateTime::Format::Strptime; + +use SL::Util qw(_hashify); + +my ($ymd_parser, $ymdhms_parser); + +sub new_local { + my ($class, %params) = @_; + return $class->new(hour => 0, minute => 0, second => 0, time_zone => $::locale->get_local_time_zone, %params); +} + sub now_local { return shift->now(time_zone => $::locale->get_local_time_zone); } @@ -10,9 +21,13 @@ sub today_local { return shift->now(time_zone => $::locale->get_local_time_zone)->truncate(to => 'day'); } +sub to_kivitendo_time { + my ($self, %params) = _hashify(1, @_); + return $::locale->format_date_object_to_time($self, %params); +} + sub to_kivitendo { - my $self = shift; - my %params = (scalar(@_) == 1) && (ref($_[0]) eq 'HASH') ? %{ $_[0] } : @_; + my ($self, %params) = _hashify(1, @_); return $::locale->format_date_object($self, %params); } @@ -22,7 +37,7 @@ sub to_lxoffice { } sub from_kivitendo { - return $::locale->parse_date_to_object(\%::myconfig, $_[1]); + return $::locale->parse_date_to_object($_[1]); } sub from_lxoffice { @@ -30,6 +45,90 @@ sub from_lxoffice { goto &from_kivitendo; } +sub add_business_duration { + my ($self, %params) = @_; + + my $abs_days = abs $params{days}; + my $neg = $params{days} < 0; + my $bweek = $params{businessweek} || 5; + my $weeks = int ($abs_days / $bweek); + my $days = $abs_days % $bweek; + + if ($neg) { + $self->subtract(weeks => $weeks); + $self->add(days => 8 - $self->day_of_week) if $self->day_of_week > $bweek; + $self->subtract(days => $self->day_of_week > $days ? $days : $days + (7 - $bweek)); + } else { + $self->add(weeks => $weeks); + $self->subtract(days => $self->day_of_week - $bweek) if $self->day_of_week > $bweek; + $self->add(days => $self->day_of_week + $days <= $bweek ? $days : $days + (7 - $bweek)); + } + + $self; +} + +sub add_businessdays { + my ($self, %params) = @_; + + $self->add_business_duration(%params); +} + +sub subtract_businessdays { + my ($self, %params) = @_; + + $params{days} *= -1; + + $self->add_business_duration(%params); +} + +sub end_of_month { + my ($self) = @_; + return $self->truncate(to => 'month')->add(months => 1)->subtract(days => 1); +} + +sub next_workday { + my ($self, %params) = @_; + + my $extra_days = $params{extra_days} // 1; + $self->add(days => $extra_days); + + my $day_of_week = $self->day_of_week; + $self->add(days => (8 - $day_of_week)) if $day_of_week >= 6; + + return $self; +} + +sub from_ymd { + my ($class, $ymd_string) = @_; + + if (!$ymd_parser) { + $ymd_parser = DateTime::Format::Strptime->new( + pattern => '%Y-%m-%d', + locale => 'de_DE', + time_zone => 'local' + ); + } + + return $ymd_parser->parse_datetime($ymd_string // ''); +} + +sub from_ymdhms { + my ($class, $ymdhms_string) = @_; + + if (!$ymdhms_parser) { + $ymdhms_parser = DateTime::Format::Strptime->new( + pattern => '%Y-%m-%dT%H:%M:%S', + locale => 'de_DE', + time_zone => 'local' + ); + } + + $ymdhms_string //= ''; + $ymdhms_string =~ s{ }{T}; + + return $ymdhms_parser->parse_datetime($ymdhms_string); +} + 1; __END__ @@ -44,6 +143,11 @@ SL::Helpers::DateTime - helper functions for L =over 4 +=item C + +Returns the time given in C<%params> with the time zone set to the +local time zone. + =item C Returns the current time with the time zone set to the local time zone. @@ -69,6 +173,37 @@ component (as opposed to L). The legacy name C is still supported. +=item C + +Parses a date string in the ISO 8601 format C and returns +an instance of L. The time is set to midnight (00:00:00). + +=item C + +Parses a date/time string in the ISO 8601 format +C (a space instead of C is also supported) and +returns an instance of L. + +=item C + +Sets the object to the last day of object's month at midnight. Returns +the object itself. + +=item C + +Sets the object to the next workday. The recognized parameter is: + +=over 2 + +=item * C - optional: If C is given, then +that amount of days is added to the objects date and if the resulting +date is not a workday, the object is set to the next workday. +Defaults to 1. + +=back + +Returns the object itself. + =back =head1 AUTHOR