|
|||||||||
Related Syntax | |||||||||
operator | date |
Return type: String The formatted date string.
Returns:
Syntax
date string-expression
date
returns the current date and time.
The date
operator must be followed by a string expression that can contain ordinary characters, format items, and date format items. Ordinary characters are passed through unchanged, and the format items are replaced with the appropriate values.
For example, the following process rule will output the current date in a "YY/MM/DD" format, and it will output the time the program was compiled in an "HH:MM:SS" format:
process local stream today local stream comptime set today to date "=Y/=M/=D%n" output today || "%n" set comptime to compiled-date "=h:=m:=s%n" output comptime || "%n"
The equals sign (=) is the first character in a date format item, akin to the percent sign (%) that is the first character in a regular format item. The slash and colon characters that appear in this example are regular characters, which pass through unchanged to the appropriate variable.
Format items for date and compiled-date
Date and compiled-date format items begin with an "=" character and have the following meanings:
date "=t+"
will produce the string "-0500" in the Eastern Standard Time zone)
Specifying the "x" modifier, as shown in the above list, causes the OmniMark program to return as few or as many digits as necessary to provide accurate and complete information. If you leave the "x" qualifier out, everything will be presented with two digits. For example, the date February 29, 1996 would be represented as follows:
Without the "x", single-digit values are zero padded, two-digit values appear as is, and a four-digit year appears in a two-digit field, so its leading two digits are truncated. (In the case of Year-2000-related digression, when you use "=xY" you'll always get the correct year, as long as your underlying system is Year-2000 compliant. If you use "=Y", your code may suffer problems after December 31, 1999; this largely depends on whether you're producing data intended for another program.)
Related Syntax compiled-date |
---- |