Devil Killer Is Here MiNi Shell
MiNi SheLL

Current Path : /proc/thread-self/root/usr/local/man/man3/
Linux boscustweb5003.eigbox.net 5.4.91 #1 SMP Wed Jan 20 18:10:28 EST 2021 x86_64
Current File : //proc/thread-self/root/usr/local/man/man3/Date::Range.3
.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "Date::Range 3"
.TH Date::Range 3 "2006-01-16" "perl v5.8.8" "User Contributed Perl Documentation"
.SH "NAME"
Date::Range \- work with a range of dates
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&  use Date::Range;
.Ve
.PP
.Vb 1
\&  my $range = Date::Range->new($date1, $date2);
.Ve
.PP
.Vb 3
\&  my $earliest = $range->start;
\&  my $latest   = $range->end;
\&  my $days     = $range->length;
.Ve
.PP
.Vb 2
\&  if ($range->includes($date3)) { ... }
\&  if ($range->includes($range2)) { ... }
.Ve
.PP
.Vb 3
\&  if ($range->overlaps($range2)) {
\&    my $range3 = $range->overlap($range2);
\&  }
.Ve
.PP
.Vb 1
\&  foreach my $date ($range->dates) { ... }
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Quite often, when dealing with dates, we don't just want to know
information about one particular date, but about a range of dates. For
example, we may wish to know whether a given date is in a particular
range, or what the overlap is between one range and another.  This module
lets you ask such questions.
.SH "METHODS"
.IX Header "METHODS"
.Sh "\fInew()\fP"
.IX Subsection "new()"
.Vb 1
\&  my $range = Date::Range->new($date1, $date2);
.Ve
.PP
A range object is instantiated with two dates, which do not need
to be in chronological order (we'll sort all that out internally).
.PP
These dates must be instances of the correct object. See \fIwant_class()\fR
below.
.Sh "want_class"
.IX Subsection "want_class"
The class of which we expect the date objects to be objects. By default
this is Date::Simple, but this could be any other date class. See
Time::Piece::Range for an example of a subclass that uses a different
date class.
.Sh "start / end / length"
.IX Subsection "start / end / length"
.Vb 3
\&  my $earliest = $range->start;
\&  my $latest   = $range->end;
\&  my $days     = $range->length;
.Ve
.PP
These methods allow you retrieve the start and end dates of the range,
and the number of days in the range. 
.Sh "equals"
.IX Subsection "equals"
.Vb 1
\&  if ($range1->equals($range2)) { }
.Ve
.PP
This tells you if two ranges are the same \- i.e. start and end at
the same dates. 
.Sh "includes"
.IX Subsection "includes"
.Vb 2
\&  if ($range->includes($date3)) { ... }
\&  if ($range->includes($range2)) { ... }
.Ve
.PP
These methods tell you if a given range includes a given date, 
or a given range.
.Sh "overlaps / overlap"
.IX Subsection "overlaps / overlap"
.Vb 3
\&  if ($range->overlaps($range2)) {
\&    my $range3 = $range->overlap($range2);
\&  }
.Ve
.PP
These methods let you know whether one range overlaps another or not,
and access this overlap range.
.Sh "gap"
.IX Subsection "gap"
.Vb 1
\&        my $range3 = $range->gap($range2);
.Ve
.PP
This returns a new range representing the gap between two other ranges.
.Sh "abuts"
.IX Subsection "abuts"
.Vb 1
\&        if ($range->abuts($range2)) { ... }
.Ve
.PP
This tells you whether or not two ranges are contiguous \- i.e. there is
no gap between them, but they do not overlap.
.Sh "dates"
.IX Subsection "dates"
.Vb 1
\&  foreach my $date ($range->dates) { ... }
.Ve
.PP
This returns a list of each date in the range as a Date::Simple object.
.SH "AUTHOR"
.IX Header "AUTHOR"
Tony Bowden, based heavily on Martin Fowler's \*(L"Analysis Patterns 2\*(R"
discussion and code at http://www.martinfowler.com/ap2/range.html
.SH "BUGS and QUERIES"
.IX Header "BUGS and QUERIES"
Please direct all correspondence regarding this module to:
  bug\-Date\-Range@rt.cpan.org
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
.Vb 1
\&  Copyright (C) 2001-2006 Tony Bowden.
.Ve
.PP
.Vb 3
\&  This program is free software; you can redistribute it and/or modify
\&  it under the terms of the GNU General Public License; either version
\&  2 of the License, or (at your option) any later version.
.Ve
.PP
.Vb 3
\&  This program is distributed in the hope that it will be useful,
\&  but WITHOUT ANY WARRANTY; without even the implied warranty of
\&  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.Ve
Creat By MiNi SheLL
Email: devilkiller@gmail.com