/usr/share/doc/libapache2-mod-perl2-doc/docs/2.0/api/APR/Date.html is in libapache2-mod-perl2-doc 2.0.8+httpd24-r1449661-6ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 132 133 134 135 136 137 138 139 140 141 | <?xml version="1.0" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title></title>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:root@localhost" />
</head>
<body style="background-color: white">
<ul id="index">
<li><a href="#NAME">NAME</a></li>
<li><a href="#Synopsis">Synopsis</a></li>
<li><a href="#Description">Description</a></li>
<li><a href="#API">API</a>
<ul>
<li><a href="#parse_http">parse_http</a></li>
<li><a href="#parse_rfc">parse_rfc</a></li>
</ul>
</li>
<li><a href="#See-Also">See Also</a></li>
<li><a href="#Copyright">Copyright</a></li>
<li><a href="#Authors">Authors</a></li>
</ul>
<h1 id="NAME">NAME</h1>
<p>APR::Date - Perl API for APR date manipulating functions</p>
<h1 id="Synopsis">Synopsis</h1>
<pre><code> use APR::Date ();
# parse HTTP-complient date string
$date_string = 'Sun, 06 Nov 1994 08:49:37 GMT';
$date_parsed = APR::Date::parse_http($date_string);
# parse RFC822-complient date string
$date_string = 'Sun, 6 Nov 94 8:49:37 GMT';
$date_parsed = APR::Date::parse_rfc($date_string);</code></pre>
<h1 id="Description">Description</h1>
<p><code>APR::Socket</code> provides the Perl interface to APR date manipulating functions.</p>
<h1 id="API">API</h1>
<p><code>APR::Date</code> provides the following functions and/or methods:</p>
<h2 id="parse_http"><code>parse_http</code></h2>
<p>Parse HTTP date strings</p>
<pre><code> $date_parsed = parse_http($date_string);</code></pre>
<dl>
<dt id="arg1:-date_string-string">arg1: <code>$date_string</code> ( string )</dt>
<dd>
<p>The date string can be in one of the following formats:</p>
<pre><code> Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123
Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036
Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format</code></pre>
<p>refer to RFC2616 for the details (GMT is assumed, regardless of the used timezone).</p>
</dd>
<dt id="ret:-date_parsed-number">ret: <code>$date_parsed</code> ( number )</dt>
<dd>
<p>the number of microseconds since 1 Jan 1970 GMT, or 0 if out of range or if the date is invalid.</p>
</dd>
<dt id="since:-2.0.00">since: 2.0.00</dt>
<dd>
</dd>
</dl>
<p>Remember to divide the return value by 1_000_000 if you need it in seconds.</p>
<h2 id="parse_rfc"><code>parse_rfc</code></h2>
<p>Parse a string resembling an RFC 822 date. It's meant to be lenient in its parsing of dates. Hence, this will parse a wider range of dates than <code><a href="#C_parse_http_">parse_http()</a></code>.</p>
<pre><code> $date_parsed = parse_rfc($date_string);</code></pre>
<dl>
<dt id="arg1:-date_string-string1">arg1: <code>$date_string</code> ( string )</dt>
<dd>
<p>The date string can be in one of the following formats:</p>
<pre><code> Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123
Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036
Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format
Sun, 6 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123
Sun, 06 Nov 94 08:49:37 GMT ; RFC 822
Sun, 6 Nov 94 08:49:37 GMT ; RFC 822
Sun, 06 Nov 94 08:49 GMT ; Unknown [drtr\@ast.cam.ac.uk]
Sun, 6 Nov 94 08:49 GMT ; Unknown [drtr\@ast.cam.ac.uk]
Sun, 06 Nov 94 8:49:37 GMT ; Unknown [Elm 70.85]
Sun, 6 Nov 94 8:49:37 GMT ; Unknown [Elm 70.85]</code></pre>
</dd>
<dt id="ret:-date_parsed-number1">ret: <code>$date_parsed</code> ( number )</dt>
<dd>
<p>the number of microseconds since 1 Jan 1970 GMT, or 0 if out of range or if the date is invalid.</p>
</dd>
<dt id="since:-2.0.001">since: 2.0.00</dt>
<dd>
</dd>
</dl>
<p>Remember to divide the return value by 1_000_000 if you need it in seconds.</p>
<h1 id="See-Also">See Also</h1>
<p><a>mod_perl 2.0 documentation</a>.</p>
<h1 id="Copyright">Copyright</h1>
<p>mod_perl 2.0 and its core modules are copyrighted under The Apache Software License, Version 2.0.</p>
<h1 id="Authors">Authors</h1>
<p><a>The mod_perl development team and numerous contributors</a>.</p>
</body>
</html>
|