StringFirstDateTime (Journal property): Difference between revisions
Jump to navigation
Jump to search
m (Created page with "<span style="font-size:120%; color:black"><b><section begin=dpl_desc/>Datetime stamp from the first entry in the journal stream<section end=dpl_desc/></b></span> [[Category:Journ...") |
m (Created page with "<span style="font-size:120%; color:black"><b><section begin=dpl_desc/>Datetime stamp from the first entry in the journal stream<section end=dpl_desc/></b></span> [[Category:Journ...") |
||
| Line 1: | Line 1: | ||
{{Template:Journal:StringFirstDateTime subtitle}} | |||
==Syntax== | |||
{{Template:Journal:StringFirstDateTime syntax}} | |||
===Syntax terms=== | |||
<dl> | <dl> | ||
<dt><i>%string</i> | <dt><i>%string</i> | ||
| Line 20: | Line 15: | ||
</dl> | </dl> | ||
==Usage notes== | |||
<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, | ||
| Line 27: | Line 22: | ||
because that parameter must be specified in YYDDDHHMISSXX format. | because that parameter must be specified in YYDDDHHMISSXX format. | ||
For example, you can use the intrinsic [[Substring (String function)|Substring]] function, | For example, you can use the intrinsic [[Substring (String function)|Substring]] function, | ||
as shown in the | 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]]. | ||
</ul> | </ul> | ||
==See also== | |||
{{Template:Journal:StringFirstDateTime footer}} | |||
Revision as of 14:43, 16 February 2011
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
- %jrnl
- 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.