macro/command/getdate.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
  "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  <title>getdate</title>
  <meta http-equiv="Content-Style-Type" content="text/css">
  <link rel="stylesheet" href="../../style.css" type="text/css">
</head>

<body>


<h1>getdate</h1>

<p>
Gets current date.
</p>

<pre class="macro-syntax">
getdate &lt;strvar&gt; [&lt;format&gt; [&lt;timezone&gt;]]
</pre>

<h2>Remarks</h2>

<p>
Returns the current date in the string variable &lt;strvar&gt;, with the default format "YYYY-MM-DD".
The user can specify the format same as <a href="http://msdn2.microsoft.com/en-us/library/fe06s4ak(VS.80).aspx" target="_blank">strftime</a>. And also, the default format equals "%Y-%m-%d" at the &lt;format&gt; argument.
</p>

<p>
The behavior of the getdate command specified with the format equals the gettime command specified with the same format.<br>
When the &lt;timezone&gt; argument is specified as a timezone string, the timestamp is generated by using the timezone.
When the &lt;timezone&gt; argument is not specified, the timestamp is treated as the localtime.
</p>

<p>
This command returns one of the following values in the system variable "result":
</p>

<table>
  <thead>
    <tr>
      <th>Value</th>
      <th>Meaning</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>0</td>
      <td>
         Normal success. &lt;strvar&gt; is stored.
      </td>
    </tr>

    <tr>
      <td>1</td>
      <td>
        Error. &lt;strvar&gt; is not stored because a length of the generated string exceeds the upper limit -511 characters-.
      </td>
    </tr>

    <tr>
      <td>2</td>
      <td>
        Error. &lt;format&gt; is invalid.
      </td>
    </tr>
  </tbody>
</table>

<h2>Example</h2>

<pre class="macro-example">
;Stores the current date to "datestr" variable with YYYY-MM-DD format.
getdate datestr

;Stores the current date with the user format to "logfile" variable. 
;The format is log-YYYYMMDD-HHMMSS.txt.
getdate logfile "log-%Y%m%d-%H%M%S.txt"

;To generate a GMT/UTC time stamp
tz="GMT"
gettime s "%Y/%m/%d %H:%M:%S" tz
messagebox s tz

;To retrieve Today's date.
gettime s "|%d|%#d|"    ; |07|7| (Today is 7th).
gettime s "|%d|%#d|"    ; |25|25| (Today is 25th).
</pre>

<h2>See also</h2>
<ul>
  <li><a href="gettime.html">gettime</a></li>
  <li><a href="http://msdn2.microsoft.com/en-us/library/fe06s4ak(VS.80).aspx" target="_blank">strftime (MSDN Library)</a></li>
</ul>

</body>
</html>