1 02/08/85  date_time
 2 
 3 Syntax as a command:  date_time {time_string} {-control_args}
 4 
 5 
 6 Syntax as an active function:
 7    [date_time {time_string} {DT} {-control_args}]
 8 
 9 
10 Function: returns a date and time value for a specified date-time or
11 the current date-time consisting of a date, a time from 0000.0 to
12 2359.9, a time zone, and a day of the week.  The date and time value is
13 returned as a single quoted string of the form
14 "mm/dd/yy  hhmm.m zzz www" (e.g., "06/01/84  0840.9 mst Fri").  The
15 format string to produce this is
16 "^my/^dm/^yc  ^Hd^99v.9MH ^xxxxza^xxxda".
17 
18 
19 Arguments:
20 time_string
21    indicates the date_time about which information is desired.  If you
22    supply no time_string, the current date and time are used.  The time
23    string is concatenated to form a single argument even if it contains
24    spaces; you need not quote it.  (See time_strings.gi for a
25    description of valid time_string values.)
26 
27 
28 Control arguments:
29 -language STR, -lang STR
30    STR specifies the language in which month name, day names, and zone
31    names are to be expressed.  (Default: the process default)
32 -zone STR
33    STR specifies the zone that is to be used to express the result.
34    (Default: the process default)
35 
36 
37 Notes: Use the print_time_defaults command to display the default
38 language and zone.  Use the display_time_info command to display a list
39 of all acceptable language and zone values.
40 
41 Due to exec_coms, etc., that have been built around the expected
42 date_time format, this command does not honor the process date_time
43 format (set by set_time_default).  You are encouraged to use "clock
44 date_time" in place of date_time to get the proper default handling.