/usr/share/doc/libqof-doc/html/datelocales.html is in libqof-doc 0.8.7-1ubuntu1.
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 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.6"/>
<title>QOF: QofDate and locales.</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">QOF
 <span id="projectnumber">0.8.7</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.6 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">QofDate and locales. </div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><h1><a class="anchor" id="daterange"></a>
QofDate range.</h1>
<p>A <a class="el" href="group__Date.html#ga79f9132a3e128aa772e0ef9d4bf8f411" title="Full range replacement for struct tm. ">QofDate</a> is theoretically able to go forward to the year 292,471,206,707 AD and back to the year 292,471,206,708 BC (excluding leap years). Whether such dates actually exist is outside the scope of this documentation.</p>
<p>Year Zero does not exist in the Christian Era, the Gregorian calendar or the Julian calendar. A year zero does exist in ISO 8601:2004 and in the astronomical year numbering with a defined year zero equal to 1 BC, as well as in some Buddhist and Hindu lunar calendars.</p>
<p>In QofDate, 1BC is immediately followed by 1AD and months are numbered from 1 to 12, not from zero.</p>
<h1><a class="anchor" id="locales"></a>
Support for locales.</h1>
<p>QofDate supports a wider range of dates than either strftime or GDate and supports all non-locale-specific strftime format specifiers - including GNU extensions like 'N' for nanoseconds - over the full range of QofDate.</p>
<p>However, locale-specific formats cannot be extended to the full range of QofDate dates because the locale data for these formats is only available to the underlying strftime implementation. The formats affected are those involving the E and O modifiers and other format specifiers that use the current locale. e.g. Japanese Emperor reigns, local numeric specifiers, translated days of the week / month etc. If these are used, only dates within the range of the locale-sensitive strftime on that platform can be supported (either inside or outside QofDate). This is not a restriction enforced by QOF, it is a gap in the libc API.</p>
<p>The full list of affected format specifiers is:</p>
<pre class="fragment"> '%a', '%A', '%b', '%h', '%B', '%c', '%C', '%x', '%p', '%P', '%r', '%X', '%E' '%O'.</pre><p>(Capital letter O, not zero: 0)</p>
<p>QofDate will attempt to fallback to a usable format if the date is out of range of the underlying strftime. e.g. <a class="el" href="group__Date.html#gac628a30fa3846c52d060f0d223275fa0" title="QOF UTC format, xsd:date compatible. QOF_UTC_DATE_FORMAT "%Y-%m-%dT%H:%M:%SZ". ">QOF_DATE_FORMAT_UTC</a>, <a class="el" href="group__Date.html#ga7f4b3def589ba28ac034a32f17336eb8" title="United Kingdom default. "%d/%m/%Y". ">QOF_DATE_FORMAT_UK</a>, <a class="el" href="group__Date.html#ga984d4bd5c74337baee673cd4122019a7" title="Continental US default. "%m/%d/%Y". ">QOF_DATE_FORMAT_US</a>, <a class="el" href="group__Date.html#gab0546839e58cc6b7075dd317e3e41e33" title="Contintental European default. "%d.%m.%Y". ">QOF_DATE_FORMAT_CE</a> or <a class="el" href="group__Date.html#ga0af1281642543495c477d167fbb1f351" title="Short ISO form. "%F". ">QOF_DATE_FORMAT_ISO</a>.</p>
<p><a class="el" href="group__Date.html#ga2cfaebd91ce400da6ea3e1c93eff9a02" title="GNU locale default. "%x". ">QOF_DATE_FORMAT_LOCALE</a> and <a class="el" href="group__Date.html#gab244c0aa8825af4bf948cefefcb6ac90" title="Date and time for the current locale "%c". ">QOF_DATE_FORMAT_CUSTOM</a> include locale-specific format specifiers.</p>
<dl class="section note"><dt>Note</dt><dd>It is not particularly sensible to write locale-sensitive date strings to any kind of permanent storage. Locale-specific format specifiers should only be used for displaying dates to the user.</dd></dl>
<h1><a class="anchor" id="otherhandlers"></a>
Using QofDate with other date handlers.</h1>
<p>Whilst you can use QofDateFormat strings with strftime / strptime and GDate, you must check that the QofDate falls within the range supported by the tool you choose to use and that the format itself is supported:</p>
<ul>
<li>To validate a GDate, call g_date_valid.</li>
<li>To use strftime / strptime, check that qd_year < G_MAXINT</li>
<li>g_date_strftime does not support time formats.</li>
<li>strftime does not support nanoseconds.</li>
</ul>
<p>For comparison:</p>
<ul>
<li>To validate a QofDate call <a class="el" href="group__Date.html#gac693cf4a4d672b893c4eeaa93b1a5a33" title="Validate a QofDate. ">qof_date_valid</a>.</li>
<li>To use strftime / strptime, just avoid using locale-sensitive format specifiers.</li>
<li>QofDate supports all time formats, including the 'N' nanoseconds GNU extension.</li>
<li>Locale-specific formats are restricted to the range supported by the user platform. </li>
</ul>
</div></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Wed Feb 5 2014 01:35:06 for QOF by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.6
</small></address>
</body>
</html>
|