STIMEFMT System Option: UNIX

Specifies the format that is used to display the time on FULLSTIMER and STIMER output.
Valid in: configuration file, SAS invocation, OPTIONS statement, SASV9_OPTIONS environment variable
Category: Log and procedure output control: SAS log
PROC OPTIONS GROUP= LOGCONTROL
Default: 512M
UNIX specifics: all
Syntax
Details
STIMEFMT Basics
Formats for Displaying the Datetime Stamp
Using Multiple Values for the STIMEFMT Option
Displaying the Settings for the STIMEFMT Option
Resetting STIMEFMT to the Default Values
See Also

Syntax

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

Required Arguments

value
specifies the options to use with STIMEFMT. The following options are available:
Datetime Stamp options
The datetime stamp options are described below:
TS specifies to always display the datetime stamp as part of STIMER and FULLSTIMER.
TSFULL specifies to display the datetime stamp as part of FULLSTIMER. TSFULL is the default.
TSOFF turns off the datetime stamp for STIMER and FULLSTIMER.
Memory
is normally displayed as part of FULLSTIMER. The default memory output is displayed in kilobytes. 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.
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 leaving out 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 datetime stamp 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 datetime stamp 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 datetime stamp:
    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 Datetime Stamp

The format of the datetime stamp 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. For example: 
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 settings for STIMEFMT to its default values by executing the following OPTIONS statement: 
options stimefmt = normal;

See Also

System Options:
STIMER System Option: UNIX
FULLSTIMER System Option: UNIX
Copyright © SAS Institute Inc. All rights reserved.