Timeformat
The timeformat option specifies the format in which you want to display and enter system time.
Use this option if you want to change the default time format for the language of the message repository you are using.
By default, format information is obtained from the locale definition in effect at the time the client is called. Consult the documentation on your local system for details about setting up your locale definition.
You can only use the timeformat option with the expire command.
When you include the timeformat option with a command, it must precede the fromtime, pittime, and totime options.
Options File
Place this option in the client options file (dsm.opt). You can set this option on the Regional Settings tab, Time Format field of the Preferences editor.
Syntax
Parameters
- format_number
- Displays time in one of the formats listed here. Select the format
number that corresponds to the format you want to use. When you include
the timeformat option in a command, it must precede
the pittime option.
- 1
- 23:00:00
- 2
- 23,00,00
- 3
- 23.00.00
- 4
- 12:00:00 A/P
- 5
- A/P 12:00:00
Examples
- Options file:
timeformat 4
- Command line:
-time=3
This option is valid on the initial command line and in interactive mode. If you use this option in interactive mode, it affects only the command with which it is specified. When that command completes, the value reverts to the value at the beginning of the interactive session. This is the value from the dsm.opt file unless overridden by the initial command line or by an option forced by the server.
Additional considerations for specifying time and date formats
The date or time format you specify with this option must be used when using options that take date and time as input. Examples are: totime, fromtime, todate, fromdate, and pittime.
For example, if you specify the timeformat option as TIMEFORMAT 4, the value that you provide on the fromtime or totime option must be specified as a time such as 12:24:00pm. Specifying 13:24:00 would not be valid because TIMEFORMAT 4 requires an hour integer that is 12 or less. If you want to specify up to 24 hour values on an option, and if you want to use commas as separators, you must specify TIMEFORMAT 2.