F$DATE()

Description

F$DATE() is used to return the current date.

Call Signature

string F$DATE ( [int optional_format] )

Return Value

string

The date as a string in one of several formats (see Remarks). If no output format is given, the default format DD-MMM-YY is returned, with the months represented as the first three characters of the month name.

Argument

[ int optional_format ]:

An optional number specifying the output format. Defaults to 1 if not given.

Remarks

The following output formats are supported:

        0 :  "HH:MM:SS"
        1 :  "DD-MMM-YY"
        2 :  "DD-MM-YY"
        3 :  "MM-DD-YY"
        4 :  "HH:MM DD-MMM-YY"
        5 :  "HH:MM:SS:sss"
        6 :  "SSSSSSSSS.sss"
        7 :  "DD-MMM-YYYY"
        8 :  "HH:MM DDMMMYYYY"
        9 :  "DDMMMYYYY"
       10 :  "DD-MM-YYYY"
       11 :  "DD-MM-YYYY GMT"   (GMT date)
       12 :  "HH:MM:SS nnn.n"   (GMT time, nnn.n = Local time - GMT in hours)

Example

The following commands print out the time and date as part of a report title.

  print "Classification Statistics for "+f$date()+" "+f$time()

Output:  "Classification Statistics for 21-Mar-93  9:03:20"

See also

F$TIME()