<summary>An API for date and time functions</summary>
<release-date>2013-09-08</release-date>
<release-date>2015-10-04</release-date>
<vendorurl="http://openacs.org">OpenACS</vendor>
<descriptionformat="text/html">Note: this version of the package requires acs-event(s) for a helper function. This requirement may go away in the future. </description>
<h3>I. Essentials</h3><p>This document describes the design of the ACS DateTime service
package.</p><h3>II. Introduction</h3><p>The ACS DateTime service is a collection of HTML widget
<h3>I. Essentials</h3>
<p>This document describes the design of the ACS DateTime service
package.</p>
<h3>II. Introduction</h3>
<p>The ACS DateTime service is a collection of HTML widget
generation procedures and date/time processing functions. The
latter are built largely on top of the Tcl <code>clock</code>
routines, although there are a small number of procedures that
connect to the database for services like Julian date
conversions.</p><p>Most the procedures defined within the ACS DateTime service take
conversions.</p>
<p>Most the procedures defined within the ACS DateTime service take
date/time information as input and return date/time strings to the
caller. Rather than standardize on a low-level representation of
time (like seconds since 00:00:00 UTC, January 1 1970) all of these
...
...
@@ -22,8 +25,20 @@ as "2001-01-05", "2000-01-05 09:57 pm", "2000-01-05 21:57", etc.
Internally these are parsed by the standard Tcl procedure
<code>clock scan</code> for processing and then converted back to a
formatted string for output. This makes it easy to pass dates
between the Tcl layer and the database.</p><h3>III. Historical Considerations</h3><p>This package was written largely to consolidate and improve the
date, time, and calendar functionality existing in ACS 3.</p><h3>IV. Competitive Analysis</h3><p>None.</p><h3>VI. Data Model Discussion</h3><p>The ACS DateTime package does not have a data model.</p><h3>VII. Legal Transactions</h3><p>None.</p><h3>VIII. API</h3><h4>Date and Time functions</h4><p>See <a href="examples/datetime-procs">examples</a>.</p><ol>
between the Tcl layer and the database.</p>
<h3>III. Historical Considerations</h3>
<p>This package was written largely to consolidate and improve the
date, time, and calendar functionality existing in ACS 3.</p>
<h3>IV. Competitive Analysis</h3>
<p>None.</p>
<h3>VI. Data Model Discussion</h3>
<p>The ACS DateTime package does not have a data model.</p>
<code>dt_widget_datetime</code> generate HTML select widgets of
varying granularity for collecting date and time information from
...
...
@@ -54,9 +72,13 @@ users.</li><li>
for months of the year</li><li>
<code>dt_widget_numeric_range</code> generates an HTML select
widget for general numeric ranges</li>
</ol><h4>Calendar widgets</h4><p>See <a href="examples/calendar-widgets">examples</a>.</p><p>Each of the following allow the programmer to supply calendar
<p>Each of the following allow the programmer to supply calendar
details in an <code>ns_set</code> keyed on Julian date and returns
an HTML table.</p><ol>
an HTML table.</p>
<ol>
<li>
<code>dt_widget_month</code> generates a basic monthly
calendar</li><li>
...
...
@@ -73,9 +95,14 @@ that calendar year</li><li>
<code>dt_widget_calendar_navigation</code> generates a calendar
navigation widget with viewing options for day, week, month and
year</li>
</ol><h3>XII. Future Improvements/Areas of Likely Change</h3><p>Many of the calendar widgets generate extensive HTML from within
</ol>
<h3>XII. Future Improvements/Areas of Likely Change</h3>
<p>Many of the calendar widgets generate extensive HTML from within
Tcl procedures. This will eventually be converted to a
template-based system so that the display properties are more
easily customized.</p><h3>XIII. Authors</h3><p>Implemented by Ron Henderson (<a href="mailto:ron@arsdigita.com">ron@arsdigita.com</a>), based on the
previous work of <a href="mailto:gregh@arsdigita.com">gregh@arsdigita.com</a> and <a href="mailto:smeeks@arsdigita.com">smeeks@arsdigita.com</a>.</p><hr><a href="mailto:ron@arsdigita.com">ron@arsdigita.com</a>
</body>
easily customized.</p>
<h3>XIII. Authors</h3>
<p>Implemented by Ron Henderson (<a href="mailto:ron\@arsdigita.com">ron\@arsdigita.com</a>), based on the
previous work of <a href="mailto:gregh\@arsdigita.com">gregh\@arsdigita.com</a> and <a href="mailto:smeeks\@arsdigita.com">smeeks\@arsdigita.com</a>.</p>
<h2>ACS DateTime Documentation</h2><a href="mailto:ron@arsdigita.com">ron@arsdigita.com</a><p>This packages provides a set of utilities for dealing with dates
<p>This packages provides a set of utilities for dealing with dates
and times, including:</p>
<ul>
<li>widgets for date and time entry</li><li>widgets for calendar display</li><li>utilities for date and time formatting</li><li>utilities for date and time conversions</li>