$Sir_Date

From m204wiki
Revision as of 21:21, 22 November 2011 by Dme (talk | contribs)
Jump to navigation Jump to search

Get current datetime

Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent of $Sir_Date is CurrentTimeString.

This function accepts an optional datetime format string and an optional error control string, and returns the current date and time as a character string with the specified format.

Syntax

<section begin="syntax" /> %odate = $Sir_Date(fmt, errctl) <section end="syntax" />

$Sir_Date Function

where

fmt optional datetime format string, defaults to 'YY-MM-DD'. Refer to for an explanation of valid datetime formats and valid datetime values.
errctl optional error control string, refer to .
%odate set to contain the current date and time, in the format specified by fmt.

For example, the following fragment prints a value such as .Monday, 1 January 2001 AT 01:11:10 PM.

PRINT $Sir_Date('Wkday, DAY Month YYYY' WITH ' "A"T HH:MI:SS AM')

Error conditions are shown in the following figure (see the discussion in ).

  • fmt is not a valid datetime format.

$Sir_Date returns the null string in the following error cases:

Products authorizing $Sir_Date