View source for $Web D2Date, $Web N2Date, $Web ND2Date, $Web NM2Date, $Web NS2Date

{{DISPLAYTITLE:$Web_D2Date, $Web_N2Date, $Web_ND2Date, $Web_NM2Date, $Web_NS2Date}}
<span class="pageSubtitle">$Web_N2Date, $Web_ND2Date, $Web_NM2Date, $Web_NS2Date: Convert number to date</span>


The $Web_xx2Date functions convert a numeric date/time value into date/time strings. The returned string is in the format "Wkd, DD Mon YYYY HH:MI:SS GMT". The $Web_xx2Date functions take one argument and return a string or null in the event of a conversion error.

==Syntax==
<p class="syntax"><span class="term">%datestring</span> = <span class="literal">$Web_D2Date</span>(<span class="term">datetime</span>)

<span class="term">%datestring</span> = <span class="literal">$Web_N2Date</span>(<span class="term">datetime</span>)

<span class="term">%datestring</span> = <span class="literal">$Web_ND2Date</span>(<span class="term">datetime</span>)

<span class="term">%datestring</span> = <span class="literal">$Web_NM2Date</span>(<span class="term">datetime</span>)

<span class="term">%datestring</span> = <span class="literal">$Web_NS2Date</span>(<span class="term">datetime</span>)
</p>

===Syntax terms===
<table class="syntaxTable">
<tr><th>datetime</th>
<td>This is the number of time units since 12 AM, January 1, 1900. The time is assumed to be in ''Greenwich Mean Time'' (GMT). This is a required parameter.
</td></tr></table>

==Usage notes==
<ul>
<li>The input time units for the various flavors of $Web_xx2Date are ;
<table class="syntaxTable">
<tr><th>$Web_D2Date</th>
<td>Number of seconds since midnight, January 1, 1900.</td></tr>
<tr><th>$Web_N2Date</th>
<td>Number of seconds since midnight, January 1, 1900.</td></tr>
<tr><th>$Web_ND2Date</th>
<td>Number of days since midnight, January 1, 1900.</td></tr>
<tr><th>$Web_NM2Date</th>
<td>Number of milliseconds since midnight, January 1, 1900.</td></tr>
<tr><th>$Web_NS2Date</th>
<td>Number of seconds since midnight, January 1, 1900.
</td></tr></table>

<li><var>$Web_D2Date</var> produces identical results to <var>$Web_NS2Date</var> so, for clarity and consistency, it is recommended that <var>$Web_NS2Date</var> be used instead of <var>$Web_D2Date</var>, since <var>$Web_NS2Date</var> indicates the time units for the input (number of seconds) and the format of the input data (numeric). 
</ul>

==Examples==
The most likely uses of these functions is for displaying debugging information (perhaps to the audit rail) or setting an HTTP response header parameter that requires a web time value, though most of the useful response headers are better accessed through special purpose $functions such as <var>$Web_Expire</var> and <var>$Web_Last_Modified</var>.
<p>
In the following example, the HTTP 1.1 response header called "Retry-After" is set as two minutes later.</p>
<p class="code">%CURR_TIME = $Web_DateNS
%RETRY_TIME = $Web_NS2Date(%CURR_TIME + 2 * 60)
%RC = $Web_Response('Retry-After', -
%RETRY_TIME)
</p>
Even this example is a bit of a stretch, since the value for "Retry-After" can be expressed as a number of seconds later instead of a date/time string. 

==See also==
<ul>
<li><var>[[$Web_Date, $Web_DateND, $Web_DateNM, and $Web_DateNS]]</var> 
<li><var>[[$Web_Date2D, $Web_Date2N, $Web_Date2ND, $Web_Date2NM, $Web_Date2NS]]</var>
</ul>


[[Category:Janus Web Server $functions|$Web_D2Date, $Web_N2Date, $Web_ND2Date, $Web_NM2Date, $Web_NS2Date]]