$Sir NS2Date: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 1: Line 1:
{{DISPLAYTITLE:$Sir_NS2Date}}
{{DISPLAYTITLE:$Sir_NS2Date}}
<span class="pageSubtitle"><section begin="desc" />Convert datetime number of seconds to string<section end="desc" /></span>
<span class="pageSubtitle">Convert datetime number of seconds to string</span>


<p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $Sir_NS2Date function.</p>
<p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $Sir_NS2Date function.</p>

Revision as of 21:21, 22 November 2011

Convert datetime number of seconds to string

Most Sirius $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $Sir_NS2Date function.

The $Sir_NS2Date function expects a numeric datetime argument containing a number of seconds since January 1, 1900, and a datetime format string. It returns the date represented by the first argument, in the format corresponding to the second argument. $Sir_NS2Date accepts an optional error control string and returns the null string if an error is detected.

Syntax

<section begin="syntax" /> %dat = $Sir_NS2Date(datn, fmt, errctl) <section end="syntax" />

$Sir_NS2Date Function

where

datn datetime number containing a signed number of seconds since January 1, 1900.
fmt datetime format string. Refer to for an explanation of valid datetime formats and valid datetime values.
errctl optional error control string, refer to .
%dat set to the datetime value string, using format specified by fmt, corresponding to datn, unless an error is detected.

For example, the following fragment prints the string 07/31/84:

%X = $Sir_Date2NS('8407301230', 'YYMMDDHHMI') * Add 15 hours: %X = %X + 60 * 60 * 15 PRINT $Sir_NS2Date(%X, 'MM/DD/YY')

Error conditions are shown in the following figure.

  • fmt is not a valid datetime format.
  • datn out of range.

$Sir_NS2Date returns a null string in the following cases:

Notes: The inverse of this $function is $Sir_Date2NS.

Products authorizing $Sir_NS2Date