StringFirstDateTime (Journal property): Difference between revisions

From m204wiki
Jump to navigation Jump to search
 
Line 22: Line 22:
<ul>
<ul>
<li>If you want to use the result of this method as, or in connection with,
<li>If you want to use the result of this method as, or in connection with,
the <tt>StartTime</tt> parameter of the [[AppendJournalData (Stringlist function)|AppendJournalData]] function,
the <var>StartTime</var> parameter of the <var>[[AppendJournalData (Stringlist function)|AppendJournalData]]</var> function,
be sure to remove the leading century indicator,
be sure to remove the leading century indicator, because that parameter must be specified in <code>YYDDDHHMISSXX</code> format.
because that parameter must be specified in YYDDDHHMISSXX format.
<p>
For example, you can use the intrinsic [[Substring (String function)|Substring]] function,
For example, you can use the intrinsic <var>[[Substring (String function)|Substring]]</var> function,
as shown in the "test for time values that are out of range"
as shown in the "test for time values that are out of range"
in [[Journal class#Journal example|Journal example]].
in [[Journal class#Journal example|"Journal example"]].</p>
</ul>
</ul>
==See also==
==See also==
{{Template:Journal:StringFirstDateTime footer}}
{{Template:Journal:StringFirstDateTime footer}}

Revision as of 21:10, 6 November 2012

Datetime stamp from the first entry in the journal stream (Journal class)


Syntax

%string = journal:StringFirstDateTime

Syntax terms

%string An EBCDIC string variable to receive the starting datetime of the contents of the journal object. This 14-character value is in CYYDDDHHMISSXX format:
CYY
year - 1900
DDD
Julian day number
HH
hour
MI
minutes
SS
seconds
XX
hundredths of seconds
journal A reference to an instance of a Journal object.

Usage notes

  • If you want to use the result of this method as, or in connection with, the StartTime parameter of the AppendJournalData function, be sure to remove the leading century indicator, because that parameter must be specified in YYDDDHHMISSXX format.

    For example, you can use the intrinsic Substring function, as shown in the "test for time values that are out of range" in "Journal example".

See also