Datetime string formats - Revision history

JAL: add category

2018-04-20T19:41:02Z

add category

← Older revision		Revision as of 19:41, 20 April 2018
Line 200:		Line 200:
	</p>		</p>
	{{Template:Benefits of $Sir Datexxx datetime processing}}		{{Template:Benefits of $Sir Datexxx datetime processing}}

			[[Category: SOUL]]

JAL: /* $Sir_Datexxx CENTSPAN argument */ minor wordsmithing

2018-02-02T21:22:54Z

$Sir_Datexxx CENTSPAN argument: minor wordsmithing

← Older revision		Revision as of 21:22, 2 February 2018
Line 149:		Line 149:
	==$Sir_Datexxx CENTSPAN argument==		==$Sir_Datexxx CENTSPAN argument==
	Many of the [[List of $functions#datetime\|$Sir_Date<i>xxx</i>]] functions accept an optional argument containing a <var>[[#Using CENTSPAN\|CENTSPAN]]</var> value to be used for the call.		Many of the [[List of $functions#datetime\|$Sir_Date<i>xxx</i>]] functions accept an optional argument containing a <var>[[#Using CENTSPAN\|CENTSPAN]]</var> value to be used for the call.
	The default value of any <var>CENTSPAN</var> argument is -50, excepting		The default value of any <var>CENTSPAN</var> argument is <code>-50</code>, excepting the [[Janus Web Server $functions#Date processing $functions\|$Web_Date2<i>xx</i>]] functions without a format argument, in which case the <var>CENTSPAN</var> argument is ignored and a <var>CENTSPAN</var> of <code>1990</code> is used.
	the [[Janus Web Server $functions#Date processing $functions\|$Web_Date2<i>xx</i>]] functions without a format argument, in which case the <var>CENTSPAN</var> argument is ignored and a <var>CENTSPAN</var> of 1990 is used.

	The default value should be adequate in most cases; if you have		The default value should be adequate in most cases; if you have carefully determined it should be different in some application, code the value on the relevant $function invocations.
	carefully determined it should be different in some application,
	code the value on the relevant $function invocations.

	~~<var class="product">Rocket M204</var> takes~~
	~~a different approach to the default: a 100-year period is used.~~
	~~See the <var class="product">Rocket M204</var> documentation for a~~
	~~description of the <var>[[CENTSPLT parameter\|CENTSPLT]]</var> and <var>[[DEFCENT parameter\|DEFCENT]]</var> parameters and $function arguments~~.

			For a different approach to the default (a 100-year period), see the description of the <var>[[CENTSPLT parameter\|CENTSPLT]]</var> and <var>[[DEFCENT parameter\|DEFCENT]]</var> parameters and $function arguments.

	==Other $functions using date values==		==Other $functions using date values==
	In addition to the $Date<i>xxx</i> and $Sir_Date<i>xxx</i> functions, there are some $functions that deal with dates from <var class="product">Model 204</var> internal structures.		In addition to the $Date<i>xxx</i> and $Sir_Date<i>xxx</i> functions, there are some $functions that deal with dates from <var class="product">Model 204</var> internal structures.

JAL: /* Strict and non-strict format matching */ replace table with template

2018-02-02T20:13:46Z

Strict and non-strict format matching: replace table with template

@@ Line 78: / Line 78: @@
 The types of strict matching are as follows:
-<table class="thJustBold">
+{{Template:Datetime format matching}}
 <p>
 The strict functions are only available in the <var class="product">[[Sir2000 User Language Tools]]</var>. With non-strict date $functions, however, you can use the following technique to check a datetime string using strict rules:

JAL: /* Strict and non-strict format matching */ word changes

2018-02-02T20:01:38Z

Strict and non-strict format matching: word changes

← Older revision		Revision as of 20:01, 2 February 2018
Line 95:		Line 95:
	</table>		</table>
	<p>		<p>
	The strict functions are only available in the <var class="product">[[Sir2000 User Language Tools]]</var>. ~~However~~, you can use the following technique ~~with non-strict date $functions~~ to check a datetime string using strict rules:		The strict functions are only available in the <var class="product">[[Sir2000 User Language Tools]]</var>. With non-strict date $functions, however, you can use the following technique to check a datetime string using strict rules:
	</p>		</p>
	<p class="code">If <i>date</i> Eq '' Or <i>date</i> NE $Sir_NM2Date(-		<p class="code">If <i>date</i> Eq '' Or <i>date</i> NE $Sir_NM2Date(-

JAL: /* Strict and non-strict format matching */ word change

2018-02-02T19:49:55Z

Strict and non-strict format matching: word change

← Older revision		Revision as of 19:49, 2 February 2018
Line 95:		Line 95:
	</table>		</table>
	<p>		<p>
	The strict functions are only available in the <var class="product">[[Sir2000 User Language Tools]]</var>. However, you can use the following technique with ~~the~~ non-strict date $functions to check a datetime string using strict rules:		The strict functions are only available in the <var class="product">[[Sir2000 User Language Tools]]</var>. However, you can use the following technique with non-strict date $functions to check a datetime string using strict rules:
	</p>		</p>
	<p class="code">If <i>date</i> Eq '' Or <i>date</i> NE $Sir_NM2Date(-		<p class="code">If <i>date</i> Eq '' Or <i>date</i> NE $Sir_NM2Date(-

JAL: /* Strict and non-strict format matching */ minor word changes

2018-02-02T19:21:15Z

Strict and non-strict format matching: minor word changes

← Older revision		Revision as of 19:21, 2 February 2018
Line 95:		Line 95:
	</table>		</table>
	<p>		<p>
	~~Since the~~ strict functions are only available in the <var class="product">[[Sir2000 User Language Tools]]</var>~~, if you want to check a datetime string using strict rules~~, you can use the following technique with the non-strict date $functions:		The strict functions are only available in the <var class="product">[[Sir2000 User Language Tools]]</var>. However, you can use the following technique with the non-strict date $functions to check a datetime string using strict rules:
	</p>		</p>
	<p class="code">If <i>date</i> Eq '' Or <i>date</i> NE $Sir_NM2Date(-		<p class="code">If <i>date</i> Eq '' Or <i>date</i> NE $Sir_NM2Date(-

JAL: add comma

2018-02-01T22:27:59Z

add comma

← Older revision		Revision as of 22:27, 1 February 2018
Line 145:		Line 145:
	<li>$Functions (other than <var>$Sir_Date</var>) that only manipulate strings and associated		<li>$Functions (other than <var>$Sir_Date</var>) that only manipulate strings and associated
	datetime formats have error return values of a		datetime formats have error return values of a
	variable number of asterisks (or, in the case of <var>$Sir_DateDif</var>		variable number of asterisks (or, in the case of <var>$Sir_DateDif</var>,
	the value 99,999,999).		the value 99,999,999).
	<var>$Sir_DateDif</var> and the date $functions that return a		<var>$Sir_DateDif</var> and the date $functions that return a

JAL: add link

2018-02-01T20:32:57Z

add link

← Older revision		Revision as of 20:32, 1 February 2018
Line 163:		Line 163:

	==$Sir_Datexxx CENTSPAN argument==		==$Sir_Datexxx CENTSPAN argument==
	Many of the [[List of $functions#datetime\|$~~Sir_Datexxx~~]] functions accept an optional argument		Many of the [[List of $functions#datetime\|$Sir_Date<i>xxx</i>]] functions accept an optional argument containing a <var>[[#Using CENTSPAN\|CENTSPAN]]</var> value to be used for the call.
	containing a <var>[[#Using CENTSPAN\|CENTSPAN]]</var> value to be used for the call.
	The default value of any <var>CENTSPAN</var> argument is -50, excepting		The default value of any <var>CENTSPAN</var> argument is -50, excepting
	the $~~Web_Date2xx~~ functions without a format argument, in which		the [[Janus Web Server $functions#Date processing $functions\|$Web_Date2<i>xx</i>]] functions without a format argument, in which case the <var>CENTSPAN</var> argument is ignored and a <var>CENTSPAN</var> of 1990 is used.
	case the <var>CENTSPAN</var> argument is ignored and a <var>CENTSPAN</var> of 1990 is used.

	The default value should be adequate in most cases; if you have		The default value should be adequate in most cases; if you have

JAL: /* Datetime error handling */ minor formatting

2018-02-01T01:11:20Z

Datetime error handling: minor formatting

← Older revision		Revision as of 01:11, 1 February 2018
Line 128:		Line 128:
	<p class="note"><b>Note:</b> For a comparable Fast/Unload discussion, see [[Fast/Unload datetime processing considerations#Datetime error handling\|Fast/Unload datetime error handling]]. </p>		<p class="note"><b>Note:</b> For a comparable Fast/Unload discussion, see [[Fast/Unload datetime processing considerations#Datetime error handling\|Fast/Unload datetime error handling]]. </p>

	Due to an invalid argument value to a datetime function,		Due to an invalid argument value to a datetime function, any of the following errors can occur:
	any of the following errors can occur:
	<ul>		<ul>
	<li>Invalid datetime format specification		<li>Invalid datetime format specification
Line 138:		Line 137:
	</ul>		</ul>

	One way to detect these errors is to check for the		One way to detect these errors is to check for the appropriate error return value:
	appropriate error return value:
	<ol>		<ol>
	<li>Functions using a numeric value to represent a datetime, and		<li>Functions using a numeric value to represent a datetime, and
Line 150:		Line 148:
	the value 99,999,999).		the value 99,999,999).
	<var>$Sir_DateDif</var> and the date $functions that return a		<var>$Sir_DateDif</var> and the date $functions that return a
	variable number of asterisks as error indication,		variable number of asterisks as error indication are available only with the <var class="product">[[Sir2000 User Language Tools]]</var>.
	are available only with the <var class="product">[[Sir2000 User Language Tools]]</var>.
	</ol>		</ol>

	If you are authorized to use the <var class="product">Sir2000 User Language Tools</var>, you can modify the		If you are authorized to use the <var class="product">Sir2000 User Language Tools</var>, you can modify the error detection algorithm so that warning messages or request cancellation occur when a datetime error occurs.
	error detection algorithm so that warning messages or request
	cancellation occur when a datetime error occurs.
	One significant advantage of this product is that you can add		One significant advantage of this product is that you can add
	a great deal of error detection to applications without modifying		a great deal of error detection to applications without modifying
	any <var class="product">SOUL</var> code.		any <var class="product">SOUL</var> code.
	Also, for case 2, above, thorough error detection of error		Also, for case 2, above, thorough error detection of error return values is somewhat complex.
	return values is somewhat complex.

	With the <var class="product">Sir2000 User Language Tools</var>,		With the <var class="product">Sir2000 User Language Tools</var>,
	you can control the error detection algoritm on a system level, with		you can control the error detection algoritm on a system level, with
	user-level and request-level overrides.		user-level and request-level overrides.
	These error control features apply to both the <var class="product">Rocket M204</var> date and datetime $functions. In addition, all $Sir_Date<i>xxx</i> datetime		These error control features apply to both the <var class="product">Rocket M204</var> date and datetime $functions. In addition, all $Sir_Date<i>xxx</i> datetime $functions (excepting <var>$Sir_DateFmt</var>) have an optional error control argument, which allows you to override the error handling for the operation of a single $function call.
	$functions (excepting <var>$Sir_DateFmt</var>) have an optional error control
	argument, which allows you to override the error handling for the
	operation of a single $function call.

	==$Sir_Datexxx CENTSPAN argument==		==$Sir_Datexxx CENTSPAN argument==

JAL: replace section content with template

2018-02-01T00:27:43Z

replace section content with template

Show changes