---
name: "HTML::Microformats::Datatype::Interval"
section: "3pm"
platform: "linux"
package: "libhtml-microformats-perl"
version: "0.105-6"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/HTML::Microformats::Datatype::Interval"
---

# HTML::Microformats::Datatype::Interval(3pm)

concrete periods of time

## NAME

HTML::Microformats::Datatype::Interval - concrete periods of time

## SYNOPSIS

```
 my $interval = HTML::Microformats::Datatype::Interval->new($span);
 print "$interval\n";
```

## DESCRIPTION

### Constructors

- "$i = HTML::Microformats::Datatype::Interval-\>new($span)"

  Creates a new HTML::Microformats::Datatype::Interval object.

  `$span` is a DateTime::Span object.

- "$i = HTML::Microformats::Datatype::Interval-\>parse($string, $elem, $context)"

  Creates a new HTML::Microformats::Datatype::Interval object.

  `$string` is an interval represented in ISO 8601 format, for example: '2010-01-01/P1Y' or '2010-01-01/2011-01-01'. `$elem` is the XML::LibXML::Element being parsed. `$context` is the document context.

  This constructor supports a number of experimental microformat interval patterns. e.g.

  ```
   <div class="interval">
    <span class="d">4</span> days starting from
    <abbr class="start" title="2010-01-01">2010</abbr>
   </div>
  ```

### Public Methods

- "$span = $i-\>span"

  Returns a DateTime::Span object.

- "$span = $i-\>to\_string"

  Returns an ISO 8601 formatted string representing the interval.

- "$d-\>datatype"

  Returns an the RDF datatype URI representing the data type of this literal.

### Function

- "compare($a, $b)"

  Compares intervals `$a` and `$b`. Return values are as per 'cmp' (see perlfunc).

  This function is not exported by default.

  Can also be used as a method:

  ```
   $a->compare($b);
  ```

## BUGS

Please report any bugs to \<http://rt.cpan.org/\>.

## SEE ALSO

HTML::Microformats, HTML::Microformats::Datatype, DateTime::Span.

## AUTHOR

Toby Inkster \<tobyink@cpan.org\>.

## COPYRIGHT AND LICENCE

Copyright 2008-2012 Toby Inkster

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

## DISCLAIMER OF WARRANTIES

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.