$FIniTim: Difference between revisions

Latest revision as of 22:51, 20 September 2018

File initialization YYDDDMMHHSSTH

Note: Many $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $FIniTim function.

This function returns the date and time a file was initialized, in YYDDDMMHHSSTH format.

The $FIniTim function accepts one arguments and returns either a null string or a string in YYDDDHHMMSSTH format.

Syntax

%time = $FIniTim(fname)

Syntax terms

%time	A null string if the file is not open, or it is it is the date and time that the file was initialized in YYDDDHHMMSSTH format.
fname	The name of the file for which initialization date and time is to be returned. The file must be currently opened by the user.

Examples

This code fragment sets %TIME to the date and time that file MYFILE was initialized:

OPEN FILE MYFILE %TIME = $FIniTim('MYFILE')

Products authorizing $FIniTim

Sirius Functions

@@ Line 1: / Line 1: @@
 {{DISPLAYTITLE:$FIniTim}}
-<span class="pageSubtitle"><section begin="desc" />File initialization YYDDDMMHHSSTH<section end="desc" /></span>
+<span class="pageSubtitle">File initialization YYDDDMMHHSSTH</span>
-<p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $FIniTim function is [[to be entered]].</p>
+<p class="warn"><b>Note: </b>Many $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $FIniTim function.</p>
 This function returns the date and time a file was initialized, in YYDDDMMHHSSTH format.
-The $FIniTim function accepts one arguments and returns either a null string or a string in YYDDDHHMMSSTH format.
+The <var>$FIniTim</var> function accepts one arguments and returns either a null string or a string in YYDDDHHMMSSTH format.
-The first argument is the name of the file for which initialization date and time is to be returned. The file must be currently opened by the user.
 ==Syntax==
-<p class="syntax"><section begin="syntax" /> %TIME = $FIniTim(fname)
+<p class="syntax"><span class="term">%time</span> = <span class="literal">$FIniTim</span>(<span class="term">fname</span>)
-<section end="syntax" /></p>
-<p class="caption">$FIniTim Function
 </p>
-<p class="caption">%TIME is a null string if the file is not open, or it is it is the date and time that the file was initialized in YYDDDHHMMSSTH format.</p>
+===Syntax terms===
+<table class="syntaxTable">
+<tr><th>%time</th>
+<td>A null string if the file is not open, or it is it is the date and time that the file was initialized in YYDDDHHMMSSTH format.</td></tr>
-The code fragment
+<tr><th>fname</th>
-<p class="code"> OPEN FILE MYFILE
+<td>The name of the file for which initialization date and time is to be returned. The file must be currently opened by the user.</td></tr>
- %TIME = $FIniTim('MYFILE')
+</table>
+==Examples==
+This code fragment sets %TIME to the date and time that file MYFILE was initialized:
+<p class="code">OPEN FILE MYFILE
+%TIME = $FIniTim('MYFILE')
 </p>
-sets %TIME to the date and time that file MYFILE was initialized.<p>
+==Products authorizing {{PAGENAMEE}}==
 <ul>
+<li><var class="product">Sirius Functions</var>
-<li>&SFUNC
 </ul>
+  <p></p>
-</p>
-<p class="caption">Products authorizing $FIniTim
-</p>
 [[Category:$Functions|$FIniTim]]