Parameters:

year (required)

month (required)

day (required)

era (optional)

this argument is obsolete and passing it to the proc will generate a warning.

Returns:

the ANSI date as Julian or -1 in the case of an invalid ANSI date argument (year less than 4713 BCE, greater than 9999 CE, or equal to 0)

Testcases:

dt_ansi_to_julian

Splits the ANSI date into year, month and day, and calls dt_ansi_to_julian to transform it to Julian.

Parameters:

ansi (required)

era (optional)

Returns:

the ANSI date as Julian

See Also:

• dt_ansi_to_julian

Testcases:

dt_ansi_to_julian_single_arg

Parses the given ansi_date string into a list of year, month, day, hour, minute, and second. Works for any date than can be parsed by clock scan.

Parameters:

ansi_date (optional)

Testcases:

dt_ansi_to_list

Converts an ANSI date into a localzed one. With no argument, it returns the current date based on server time. Works for both date and date-time strings.

Parameters:

ansi_date (optional)

Date in ANSI format (for example, 1998-09-05)

Returns:

Localized date (for example, on 'en_US', 05/09/98)

Testcases:

dt_localized_procs

Parameters:

year (required)

month (required)

Returns:

the weekday number of the first day for the given month/year

Testcases:

dt_first_day_of_month

This proc should not be used, because it does not take internationalization into account. Use lc_time_fmt instead.

Switches:

-format (optional, defaults to "%Y-%m-%d %H:%M:%S")

-gmt (optional, defaults to "f")

Parameters:

time (required)

See Also:

• lc_time_fmt

Testcases:

No testcase defined.

Checks the values of start and end to see if they form a valid time interval. Returns: > 0 if end > start 0 if end = start < 0 if end < start Input variables can be any strings that can be converted to times using clock scan.

Parameters:

start (required)

end (required)

Testcases:

dt_interval_check

Parameters:

julian_date (required)

Returns:

julian_date formatted as "yyyy-mm-dd"

Testcases:

dt_julian_to_ansi

Returns:

the calendar month names as a Tcl list (Jan, Feb, ...)

See Also:

• lc_get

Testcases:

dt_localized_procs

Returns:

the calendar month names as a Tcl list (January, February, ...)

See Also:

• lc_get

Testcases:

dt_localized_procs

Parameters:

year (required)

month (required)

Returns:

the ANSI date for the next month

Testcases:

dt_prev_next_month

Parameters:

year (required)

month (required)

Returns:

Localized name of the next month

Testcases:

dt_localized_procs

Parameters:

year (required)

month (required)

Returns:

the numbers of days for the given month/year

Testcases:

dt_num_days_in_month

Parameters:

year (required)

month (required)

Returns:

the ANSI date for the previous month

Testcases:

dt_prev_next_month

Parameters:

year (required)

month (required)

Returns:

Localized name of the previous month

Testcases:

dt_localized_procs

Switches:

-format (optional, defaults to "%Y-%m-%d")

Returns:

current server date in the standard format "yyyy-mm-dd"

Testcases:

dt_sysdate_systime

Switches:

-format (optional, defaults to "%Y-%m-%d %H:%M:%S")

-gmt (optional, defaults to "f")

returns the time in GMT.

Returns:

current server time in the standard format "yyyy-mm-dd hh:mi:ss".

Testcases:

dt_sysdate_systime

Parameters:

time (required)

Returns:

1 if "time" is a valid time specification, 0 otherwise.

Testcases:

dt_valid_time_p, dt_sysdate_systime

Switches:

-show_date (optional, defaults to "1")

-date_time_sep (optional, defaults to " ")

-use_am_pm (optional, defaults to "0")

-default (optional, defaults to "none")

Parameters:

name (required)

granularity (optional, defaults to "days")

Returns:

an HTML form fragment for collecting date-time information with names "$name.year", "$name.month", "$name.day", "$name.hours", "$name.minutes", "$name.seconds", and "$name.ampm". These will be numeric ("ampm" is 0 for am, 1 for pm) Default specifies what should be set as the current time in the form. Valid defaults are "none", "now", or any valid date string that can be converted with clock scan. Granularity can be "months" "days" "hours" "halves" "quarters" "fives" "minutes" or "seconds". Use -show_date 0 for a time entry widget (no dates). All HTML widgets will be output *unless* show_date is 0; they will be hidden if not needed to satisfy the current granularity level. Values default to 1 for MM/DD and 0 for HH/MI/SS/AM if not found in the input string or if below the granularity threshold. DEPRECATED: modern HTML5 feature make this widget less relevant. It is also cumbersome to style and localize.

See Also:

• template::widget::h5time
• template::widget::h5date

Testcases:

No testcase defined.

DEPRECATED: this proc was only used inside of now deprecated dt_widget_datetime.

Switches:

-hide (optional, defaults to "t")

-hidden_value (optional, defaults to "00")

-default (optional)

-format (optional, defaults to "%02d")

Parameters:

ask_for_value (required)

name (required)

start (required)

end (required)

default_value (required)

interval (optional, defaults to "1")

with_leading_zeros (optional, defaults to "0")

hidden_value (optional, defaults to "00")

Returns:

form numeric range, or hidden_value if ask_for_value is false.

See Also:

• dt_widget_datetime

Testcases:

No testcase defined.

DEPRECATED: modern HTML5 feature make this widget less relevant. It is also cumbersome to style and localize.

Parameters:

name (required)

selected_month (optional, defaults to "0")

Returns:

a select widget for months of the year.

See Also:

• template::widget::h5time
• template::widget::h5date

Testcases:

No testcase defined.

DEPRECATED: this widget would be difficult to style and is actually simpler to inline such an idiom in one's tcl or adp code. The templating system also provides select widgets that take care of validating the selection.

Parameters:

name (required)

begin (required)

end (required)

default (optional)

interval (optional, defaults to "1")

with_leading_zeros (optional, defaults to "0")

Returns:

an HTML select widget for a numeric range

See Also:

• template::widget::select
• template::widget::multiselect

Testcases:

No testcase defined.