Index: openacs-4/packages/acs-datetime/www/doc/design.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-datetime/www/doc/design.html,v diff -u -r1.3.2.3 -r1.3.2.4 --- openacs-4/packages/acs-datetime/www/doc/design.html 23 Mar 2023 13:24:44 -0000 1.3.2.3 +++ openacs-4/packages/acs-datetime/www/doc/design.html 23 Mar 2023 16:14:43 -0000 1.3.2.4 @@ -27,16 +27,14 @@ services like Julian date conversions.

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 -procedures accept general date specifications. For example, the -default date for dt_widget_datetime can be specified 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 clock -scan 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. +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 +procedures accept general date specifications. Internally dates are +parsed by the standard Tcl procedure clock scan 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.

III. Historical Considerations

@@ -80,37 +78,6 @@ time range -

Date and Time widgets

- -

See examples. - -

    -
  1. dt_widget_datetime generate HTML select widgets of varying granularity for -collecting date and time information from users. -
  2. dt_widget_month generates an HTML select widget for -months of the year -
  3. dt_widget_numeric_range generates an HTML select -widget for general numeric ranges - -
- -

Calendar widgets

- -

See examples.

- -

Each of the following allow the programmer to supply calendar -details in an ns_set keyed on Julian date and returns an -HTML table.

- -
    -
  1. dt_widget_month generates a basic monthly calendar -
  2. dt_widget_month_small generates a small monthly calendar -
  3. dt_widget_centered generates small monthly calendars -centered in a given month (previous, current, next) -
  4. dt_widget_year generates a yearly calendar (composed of small monthly calendars) -given the starting month as a date -
-

XII. Future Improvements/Areas of Likely Change

Many of the calendar widgets generate extensive HTML from within