TimeStringConvert (String function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
Line 35: Line 35:
==See also==
==See also==
<ul>
<ul>
<li>Related intrinsic methods:
<li>Related intrinsic methods (provide conversion from one form of date representation to another):
<ul>
<ul>
<li><var>[[DaysToString (Float_function)|DaysToString]]</var>
<li><var>[[DaysToString (Float_function)|DaysToString]]</var>

Revision as of 17:36, 12 July 2012

Convert date/time string from one format to another (String class)

[Introduced in Sirius Mods 7.9]


Syntax

%outString = string:TimeStringConvert( inputFormat, outputFormat, - [[CentSpan=] number]) Throws InvalidDateString

Syntax terms

%outString This string is the method object, string, converted to the format in outputFormat.
string A datetime string.
inputFormat The datetime format of the method object string.
outputFormat A string that specifies the datetime format to which the method object is to be converted.
CentSpan This name allowed parameter is the CENTSPAN value used, if the format has a two-digit year. The default is specified by the CENTSPAN parameter.

Examples

  1. This statement converts a value in YYYYMMDDHHMISSXXX format to the Month DAY, YYYY HH:MI:SS.XXX format:

    printText {~='20110520173648965':timeStringConvert('YYYYMMDDHHMISSXXX', 'Month DAY, YYYY HH:MI:SS.XXX')}

    The result is:

    '20110520173648965':timeStringConvert('YYYYMMDDHHMISSXXX', 'Month DAY, YYYY HH:MI:SS.XXX')=May 20, 2011 17:36:48.965

  2. This statement converts a value in MM/DD/YY format to the Month DAY, YYYY format:

    printText {~='12/22/11':timeStringConvert('MM/DD/YY', 'Month DAY, YYYY', centspan=1910)}

    The result is:

    '12/22/11':timeStringConvert('MM/DD/YY', 'Month DAY, YYYY', centspan=1910)=December 22, 1911

See also