<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
<MAN>
  <LANGUAGE>eng</LANGUAGE>
  <TITLE>getdate</TITLE>
  <TYPE>Scilab Function</TYPE>
  <DATE>June 2004</DATE>
  <SHORT_DESCRIPTION name="getdate">get date and time information</SHORT_DESCRIPTION>
  <CALLING_SEQUENCE>
    <CALLING_SEQUENCE_ITEM>dt=getdate()</CALLING_SEQUENCE_ITEM>
    <CALLING_SEQUENCE_ITEM>x=getdate(&quot;s&quot;)</CALLING_SEQUENCE_ITEM>
    <CALLING_SEQUENCE_ITEM>dt=getdate(x)</CALLING_SEQUENCE_ITEM>
  </CALLING_SEQUENCE>
  <PARAM>
    <PARAM_INDENT>
      <PARAM_ITEM>
        <PARAM_NAME>dt</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>: an integer vector with 10 entries (see below)</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
      <PARAM_ITEM>
        <PARAM_NAME>x</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>: an integer containing a date coded in second from 1 Jan 1970</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
    </PARAM_INDENT>
  </PARAM>
  <DESCRIPTION>
    <DESCRIPTION_INDENT>
      <DESCRIPTION_ITEM label="dt=getdate()">
        <SP> returns the current date in format given below:</SP>
	<DESCRIPTION_INDENT>
	  <DESCRIPTION_ITEM label="dt(1)">
	    <SP>: The year  as a number (with the century) between 0000 and 9999.</SP>
	  </DESCRIPTION_ITEM>
	  <DESCRIPTION_ITEM label="dt(2)">
	    <SP>: The month of the year as a number between 01 and 12.</SP>
	  </DESCRIPTION_ITEM>
	  <DESCRIPTION_ITEM label="dt(3)">
	    <SP>: The ISO 8601  week  number  as  a   number between 01 and 53.</SP>
	  </DESCRIPTION_ITEM>
	  <DESCRIPTION_ITEM label="dt(4)">
	    <SP>: The Julian day of the year  as a number between 001 and 366.</SP>
	  </DESCRIPTION_ITEM>
	  <DESCRIPTION_ITEM label="dt(5)">
	    <SP>: Specifies the weekday as a decimal number [1,7], with 1 representing Sunday.</SP>
	  </DESCRIPTION_ITEM>
	  <DESCRIPTION_ITEM label="dt(6)">
	    <SP>: The day of the month as a number between 01 and 31.</SP>
	  </DESCRIPTION_ITEM>
	  <DESCRIPTION_ITEM label="dt(7)">
	    <SP>: The hour of the day is output as a number between 00 and 23.</SP>
	  </DESCRIPTION_ITEM>
	  <DESCRIPTION_ITEM label="dt(8)">
	    <SP>: The minute is output as a number between 00 and 59.</SP>
	  </DESCRIPTION_ITEM>
	  <DESCRIPTION_ITEM label="dt(9)">
	    <SP>: The second is output as a number between 00 and 59.</SP>
	  </DESCRIPTION_ITEM>
	  <DESCRIPTION_ITEM label="dt(10)">
	    <SP>: The millisecond is output as a number between 000 and 999.</SP>
	  </DESCRIPTION_ITEM>
	</DESCRIPTION_INDENT>
      </DESCRIPTION_ITEM>
      <DESCRIPTION_ITEM label="x=getdate(&quot;s&quot;)">
        <SP> returns a scalar with the number of seconds since Jan 1, 1970, 00:00 UTC (Unix Time Convention)</SP>
      </DESCRIPTION_ITEM>
      <DESCRIPTION_ITEM label="dt=getdate(x)">
        <SP> formats the date given by x (number of seconds since Jan 1, 1970, 00:00 UTC) in format given above. 
	In this case dt(10) is always equal to 0.</SP>
      </DESCRIPTION_ITEM>
    </DESCRIPTION_INDENT>
  </DESCRIPTION>
  <EXAMPLE>
<![CDATA[
w=getdate()
mprintf("Year:%d,Month:%d,Day:%d",w(1),w(2),w(6));

x=getdate("s")
getdate(x)

 ]]>
  </EXAMPLE>
  <SEE_ALSO>
    <SEE_ALSO_ITEM><LINK>date</LINK></SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM><LINK>timer</LINK></SEE_ALSO_ITEM>
  </SEE_ALSO>
  <AUTHORS>
    <AUTHORS_ITEM>V.C.</AUTHORS_ITEM>
  </AUTHORS>
</MAN>
