STIMEFMT System Option: Windows

Specifies the format that is used to display the time on FULLSTIMER and STIMER output.

Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Log and Procedure Output Control: SAS Log
PROC OPTIONS GROUP= LOGCONTROL
Default: M
Windows specifics: all

Syntax

-STIMEFMT value(s)
STIMEFMT=value(s)

Required Arguments

value

specifies the options to use with STIMEFMT. The following options are available:

Timestamp options

The timestamp options are described below:

TS specifies to always display the timestamp as part of STIMER and FULLSTIMER.
TSFULL specifies to display the timestamp as part of FULLSTIMER. TSFULL is the default.
TSOFF turns off the timestamp for STIMER and FULLSTIMER.

Memory

is normally displayed as part of FULLSTIMER. The default memory output is displayed in KB. The following options for memory are available:

MEMFULL writes memory statistics as part of FULLSTIMER but not as part of STIMER.
MEM writes memory statistics as part of FULLSTIMER and STIMER.
KB writes memory in kilobytes.
MB writes memory in megabytes.
GB writes memory in gigabytes.
C adds commas to the numbers in the memory display.
NC does not add commas to the numbers in the memory display.

H, HOURS

specifies that SAS software display the STIMER output as hours:minutes:seconds.

Elapsed and CPU time

can be configured to display hours, minutes, seconds, or best fit in STIMER and FULLSTIMER.

Z | H | HOURS writes the time as hours:minutes:seconds.
M | MINUTES writes the time as minutes:seconds.
S | SECONDS writes the time as seconds.
HMS writes the format without leading zeros for hours and minutes.

Counters

specifies that additional counters can be displayed as part of FULLSTIMER.

E | ENABLE enables extra counters.
D | DISABLE disables extra counters.

Help

provides two values that are used to access help for the STIMEFMT option:

FMT lists the available timestamp formats.
OPT lists other option values that are available.

Details

STIMEFMT Basics

The STIMEFMT system enables you to customize the format of output produced by the STIMER and FULLSTIMER system options. You can perform the following tasks using STIMEFMT:
  • list the formats that are available:
    options stimefmt = fmt;
  • list other options that are available:
    options stimefmt = opt;
  • turn the timestamp on or off for STIMER:
    options stimefmt = tson | tsoff | tsfull;
  • combine options as needed:
    options stimefmt = (tson YYNNDDS);
  • separate a memory value with commas:
    options stimefmt = c;
  • do not use commas when specifying values:
    options stimefmt = nc;
  • select a unit for memory:
    options stimefmt = GB | MB | KB;
  • turn on memory reporting for STIMER and FULLSTIMER:
    options stimefmt = mem;
  • set the time display in the timestamp:
    options stimefmt = TOD | TIME | TIMEAMPM; 
    (TOD and TIME specify military time.) 
  • control the display of CPU or real time by using HOURS or MINUTES

Formats for Displaying the Timestamp

The format of timestamp can be set to standard formats that are supported by SAS. These formats include the following:
ABS.           (Absolute seconds since Jan. 1, 1970)           
DATE.          DATE9.
DDMMYY.         DDMMYY10.     DDMMYYB.
DDMMYYB10.      DDMMYYC.      DDMMYYC10.
DDMMYYD.        DDMMYYD10.    DDMMYYN.
DDMMYYN10.      DDMMYYP.      DDMMYYP10.
DDMMYYS.        DDMMYYS10.  
ISO.            (ISO Standard Time)
MMDDYY.          MMDDYY10.     MMDDYY.
MMDDYYB10.       MMDDYYC.      MMDDYYC10.
MMDDYYD.         MMDDYYD10.    MMDDYYN.
MMDDYYN8.        MMDDYYP.      MMDDYYP10.
MMDDYYS.         MMDDYYS10.      
NLDATM.          NLDATMAP.
YYMMDD.           YYMMDD10.     YYMMDDB.
YYMMDDB10.        YYMMDDC.      YYMMDDC10.
YYMMDDD.          YYMMDDD10.    YYMMDDN.
YYMMDDN8.         YYMMDDP.      YYMMDDP10.
YYMMDDS.          YYMMDDS10. 
TOD.               (Writes time as military time.) 
TIME.              (Writes time as military time.)
TIMEAMPM.          (Writes time as AM and PM.)
The syntax for the OPTIONS statement is listed below:
options stimefmt = fmt;
where fmt is a valid SAS format.

Using Multiple Values for the STIMEFMT Option

The STIMEFMT option can specify multiple values at the same time to enable you to set multiple settings. Multiple values must be enclosed in parentheses, as the following example shows:
options stimefmt = (h YYMMDD. gb c);

Displaying the Settings for the STIMEFMT Option

PROC OPTIONS always displays the current state of all settings for STIMEFMT. The following example shows log output when you execute PROC OPTIONS:
proc options option=stimefmt;
run;
Log Output from PROC OPTIONS
SAS (r) Proprietary Software Release 9.3  TS1B0

 STIMEFMT=(NLDATM2. HMS TIMEAMPM KB MEMFULL TSFULL NC)
                   Specified the output format for FULLSTIMER and STIMER. 
                   This controls the timestamp, memory, CPU and elapsed time.

Resetting STIMEFMT to the Default Values

You can reset the setting for STIMEFMT to the default values by executing the following OPTIONS statement:
options stimefmt = normal;

See Also

The SAS Log in SAS Language Reference: Concepts