Help pages:
-----------
+<<<<<<< HEAD
* overhauled / rewritten: `bitget`, `edit`, `factorial`, `fft`, `vectorfind`, `datafit`
* fixed / improved: `bench_run` `M_SWITCH`, `comet`, `comet3d`, `plot2d`
* Rewritten: `weekday`
+=======
+* overhauled / rewritten: `bitget`, `edit`, `factorial`, `vectorfind`, `datafit`
+* fixed / improved: `bench_run` `M_SWITCH`, `comet`, `comet3d`
+* Rewritten: `getdate`, `weekday`
+>>>>>>> f051a8e8452... * Bugs 15163 16496 fixed [doc]: getdate() page rewritten
* Translations added:
- (ru): `weekday`
* [#14488](https://bugzilla.scilab.org/14488): The `frameflag=9` and `strf=".9."` values of these `plot2d` options were no longer accepted. Their documentation was ambiguous.
* [#14718](https://bugzilla.scilab.org/14718): `user` is removed for a while but was still documented.
* [#14873](https://bugzilla.scilab.org/14873): `setfield` page: The output and the 6.0 history were documented only on the en_US version. The input was wrongly restricted to matrices, while any Scilab object is acceptable. The specific role of `setfield` for mlists was not really described nor illustrated. The example did not include any call to setfield.
+* [#15163](https://bugzilla.scilab.org/15163): `getdate` page: The time referential was obscure: a) UTC for Unix Time Convention vs Coordinated Universal Time. b) unclear influence of the time zone.
* [#15280](https://bugzilla.scilab.org/15280): `gsort` was unable to sort any hypermatrix along dimensions > "r"|"c".
* [#15839](https://bugzilla.scilab.org/15839): `gsort`: the only sparse possible input were real or complex vectors, and only with the `g` method.
* [#15842](https://bugzilla.scilab.org/15842): `unique` could not process 2D sparse matrices.
* [#16465](https://bugzilla.scilab.org/16465): Scinotes OpenRecent menu was not updated when it should.
* [#16473](https://bugzilla.scilab.org/16473): Deleting rows in a sparse squared the matrix with padding zeros (Scilab 6 regression).
* [#16474](https://bugzilla.scilab.org/16474): `imult(%z)` crashed Scilab.
+* [#16496](https://bugzilla.scilab.org/16496): The `getdate` page should be rewritten: a) `getdate("s")` does NOT take leap seconds into account. b) `D=getdate(X)` is vectorized, accepts fractional seconds and returns them in [0,1) in D(10) instead of milliseconds. Moreover, the time referential of the result was unclear (time zone, daylight saving offset).
* [#16517](https://bugzilla.scilab.org/16517): `getdate("s")` truncated the actual time to integer seconds. `getdate(u)(10)` returned fractional seconds instead of milliseconds as `getdate()`.
* [#16522](https://bugzilla.scilab.org/16522): `bitget(x,pos)` and `bitset(x,pos)` results could be wrong when `pos` is an encoded integer.
* [#16525](https://bugzilla.scilab.org/16525): `soundsec(t,freq)` has the trivial equivalence `0 : 1/freq : t*(1-%eps)` and should be removed.
-
### Bugs fixed in 6.1.0:
* [#2694](https://bugzilla.scilab.org/2694): `bitget` did not accept positive integers of types int8, int16 or int32.
* [#5824](https://bugzilla.scilab.org/5824): The `datafit` algorithm was not documented.
<?xml version="1.0" encoding="UTF-8"?>
<!--
* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
- * Copyright (C) INRIA -
- *
- * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2020 - Samuel GOUGEON
*
* This file is hereby licensed under the terms of the GNU GPL v2.0,
* pursuant to article 5.3.4 of the CeCILL v.2.1.
* along with this program.
*
-->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="en" xml:id="getdate">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:svg="http://www.w3.org/2000/svg" xmlns:db="http://docbook.org/ns/docbook"
+ xmlns:scilab="http://www.scilab.org" xml:lang="en" xml:id="getdate">
<refnamediv>
<refname>getdate</refname>
- <refpurpose>get date and time information</refpurpose>
+ <refpurpose>
+ Current datetime or POSIX timestamp from computer's clock. Datetimes from given timestamps
+ </refpurpose>
</refnamediv>
<refsynopsisdiv>
<title>Syntax</title>
- <synopsis>dt=getdate()
- x=getdate("s")
- dt=getdate(x)
+ <synopsis>
+ curDatetime = getdate()
+ timeStamp = getdate("s")
+ dateTimes = getdate(timeStamps)
</synopsis>
</refsynopsisdiv>
<refsection>
<title>Arguments</title>
<variablelist>
<varlistentry>
- <term>dt</term>
+ <term>curDatetime</term>
<listitem>
- <para>an integer vector with 10 entries (see below)</para>
+ vector of integers with
+ <table>
+ <tr><td>Index</td>
+ <th>1</th><th>2</th><th>3</th><th>4</th><th>5</th>
+ <th>6</th><th>7</th><th>8</th><th>9</th><th>10</th>
+ </tr>
+ <tr><td>Content</td>
+ <th>year</th><th>month</th><th>week</th><th>yearday</th><th>weekday</th>
+ <th>monthday</th><th>hour</th><th>minute</th><th>second</th><th>millisecond</th>
+ </tr>
+ <tr><td>Range</td>
+ <td>≥ 1970</td><td>[1,12]</td><td>[1,53]</td><td>[1,366]</td><td>[1,7] 1=sunday</td>
+ <td>[1,31]</td><td>[0,23]</td><td>[0,59]</td><td>[0,59]</td><td>[0,999]</td>
+ </tr>
+ </table>
+ <para/>
</listitem>
</varlistentry>
<varlistentry>
- <term>x</term>
- <listitem>
- <para>an integer containing a date coded in second from 1 Jan 1970</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsection>
- <refsection>
- <title>Description</title>
- <variablelist>
- <varlistentry>
- <term>dt=getdate()</term>
+ <term>timeStamp</term>
<listitem>
- <para> returns the current date in format given below:</para>
- <variablelist>
- <varlistentry>
- <term>dt(1)</term>
- <listitem>
- <para>The year as a number (with the century) between 0000 and 9999.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(2)</term>
- <listitem>
- <para>The month of the year as a number between 01 and 12.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(3)</term>
- <listitem>
- <para>The ISO 8601 week number as a number between 01 and 53.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(4)</term>
- <listitem>
- <para>The Julian day of the year as a number between 001 and 366.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(5)</term>
- <listitem>
- <para>Specifies the weekday as a decimal number [1,7], with 1 representing Sunday.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(6)</term>
- <listitem>
- <para>The day of the month as a number between 01 and 31.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(7)</term>
- <listitem>
- <para>The hour of the day is output as a number between 00 and 23.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(8)</term>
- <listitem>
- <para>The minute is output as a number between 00 and 59.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(9)</term>
- <listitem>
- <para>The second is output as a number between 00 and 59.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(10)</term>
- <listitem>
- <para>The millisecond is output as a number between 000 and 999.</para>
- </listitem>
- </varlistentry>
- </variablelist>
+ integer number of seconds elapsed since 1970-01-01 00:00:00 UTC,
+ excluding leap seconds, as defined by the POSIX standard (see description).
+ <para/>
</listitem>
</varlistentry>
<varlistentry>
- <term>x=getdate("s")</term>
+ <term>timeStamps</term>
<listitem>
- <para> returns a scalar with the number of seconds since Jan 1, 1970, 00:00 UTC (Unix Time Convention)</para>
- <para>
- Please note that the return value contains the <ulink url="http://en.wikipedia.org/wiki/Leap_second">leap seconds</ulink>.
- </para>
+ Array of positive decimal numbers representing POSIX timestamps.
+ Negative timestamps are not accepted.
+ <para/>
</listitem>
</varlistentry>
<varlistentry>
- <term>dt=getdate(x)</term>
+ <term>dateTimes</term>
<listitem>
- <para> 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.
- </para>
- <para>
- <literal>getdate(0)</literal> will return Jan 1, 1970, 00:00 if the time zone concerned is UTC, but if the time zone is UTC+1, hour
- returned will be 01:00.
- </para>
+ length(timeStamps)-by-10 Matrix: The row #i elements are datetime data
+ corresponding to timeStamps(i), as documented for <varname>curDatetime</varname>,
+ except that <literal>dateTimes(:,10)</literal> are fractions of second in [0,1)
+ instead of milliseconds. dateTimes are expressed in the current computer's time
+ zone.
+ <para/>
</listitem>
</varlistentry>
</variablelist>
</refsection>
<refsection>
+ <title>Description</title>
+ <para>
+ <emphasis role="bold">getdate()</emphasis> returns the current datetime of the
+ computer's clock, expressed in the Gregorian calendar, and for the computer's
+ time zone + possible daylight saving offset.
+ </para>
+ <para>
+ Nowadays, most of computers are automatically synchronized with the legal time
+ for the considered time zone, through time servers. Legal datetimes are
+ synchronized on the Coordinated Universal Time (UTC), by a known time zone
+ (and daylight saving) offset.
+ </para>
+ <para>
+ <emphasis role="bold">getdate("s")</emphasis> reads the computer's clock
+ and returns the corresponding POSIX timestamp. This corresponds to the number
+ of seconds elapsed since 1970-01-01 00:00:00 UTC, except that leap seconds
+ are not counted. Hence, if <literal>n = getdate("s")</literal> is run at an
+ exact round hour, <literal>modulo(n, 3600)</literal> will return 0 instead
+ of <ulink url="http://en.wikipedia.org/wiki/Leap_second">cumulated leap seconds</ulink>
+ added since 1972 (27s, up to 2020).
+ </para>
+ <para>
+ <emphasis role="bold">getdate(timeStamps)</emphasis> returns the status of the
+ local computer's clock for the given POSIX time stamps, that may include fractional
+ seconds. If any, the computer's current Daylight Saving offset is never considered.
+ <literal>getdate(0)</literal> will return 1970-01-01 00:00:00
+ only if the clock is set for the time zone = 0. Otherwise, for instance for
+ Scilab users living in Bélem, Brazil, UTC-3, <literal>getdate(0)</literal> returns
+ 1969-12-31 21:00:00, actually corresponding to 1970-01-01 00:00:00 POSIX.
+ </para>
+ </refsection>
+ <refsection>
<title>Examples</title>
<programlisting role="example"><![CDATA[
-w=getdate()
-mprintf("Year:%d,Month:%d,Day:%d",w(1),w(2),w(6));
+D = getdate()
+mprintf("%d-%02d-%02d %02d:%02d:%06.3f\n", D(1), D(2), D(6:8), D(9)+D(10)/1000);
+
+x = getdate("s");
+mprintf("%.2f\n", x)
-x=getdate("s")
-getdate(x)
+D = getdate(0)
+mprintf("%d-%02d-%02d %02d:%02d:%06.3f\n", D(1), D(2), D(6:8), D(9)+D(10)/1000);
+ ]]></programlisting>
+ <screen><![CDATA[
+--> D = getdate()
+ D =
+ 2020. 7. 30. 208. 1. 26. 23. 8. 28. 474.
+
+--> mprintf("%d-%02d-%02d %02d:%02d:%06.3f\n", D(1), D(2), D(6:8), D(9)+D(10)/1000);
+2020-07-26 23:08:28.474
+
+--> x = getdate("s");
+--> mprintf("%.2f\n", x)
+1595797708.00
+
+--> D = getdate(0)
+ D =
+ 1970. 1. 1. 1. 5. 1. 1. 0. 0. 0.
+
+--> mprintf("%d-%02d-%02d %02d:%02d:%06.3f\n", D(1), D(2), D(6:8), D(9)+D(10)/1000);
+1970-01-01 01:00:00.000
+]]></screen>
+ <para>
+ <literal>getdate("s") ignores leap seconds:</literal>
+ </para>
+ <programlisting role="example"><![CDATA[
+s = 1;
+// Expecting the next round minute @ your clock. Please be patient..
+while s <> 0
+ D = getdate();
+ x = getdate("s");
+ s = D(9);
+ sleep(300) // ms. To not use 100% of your processor
+end
+// If leap seconds are taken into account, they would appear here (27, in 2020):
+modulo(x, 60)
+ ]]></programlisting>
+ <screen><![CDATA[
+--> modulo(x, 60)
+ ans =
+ 0.
+]]></screen>
+ <para/>
+ <programlisting role="example"><![CDATA[
+getdate([1e9, 2e9, 3e9] + 0.21) // Note the fractional seconds
]]></programlisting>
+ <screen><![CDATA[
+--> getdate([1e9, 2e9, 3e9] + 0.21)
+ ans =
+ 2001. 9. 36. 252. 1. 9. 3. 46. 40. 0.21
+ 2033. 5. 20. 138. 4. 18. 5. 33. 20. 0.21
+ 2065. 1. 4. 24. 7. 24. 6. 20. 0. 0.21
+]]></screen>
</refsection>
<refsection role="see also">
<title>See also</title>
<simplelist type="inline">
<member>
+ <link linkend="calendar">calendar</link>
+ </member>
+ <member>
<link linkend="date">date</link>
</member>
<member>
+ <link linkend="clock">clock</link>
+ </member>
+ <member>
<link linkend="timer">timer</link>
</member>
+ <member>
+ <link linkend="datenum">datenum</link>
+ </member>
</simplelist>
</refsection>
</refentry>
+++ /dev/null
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
- * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
- * Copyright (C) INRIA -
- *
- * Copyright (C) 2012 - 2016 - Scilab Enterprises
- *
- * This file is hereby licensed under the terms of the GNU GPL v2.0,
- * pursuant to article 5.3.4 of the CeCILL v.2.1.
- * This file was originally licensed under the terms of the CeCILL v2.1,
- * and continues to be available under such terms.
- * For more information, see the COPYING file which you should have received
- * along with this program.
- *
- -->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="fr" xml:id="getdate">
- <refnamediv>
- <refname>getdate</refname>
- <refpurpose>renvoie la date et l'heure</refpurpose>
- </refnamediv>
- <refsynopsisdiv>
- <title>Séquence d'appel</title>
- <synopsis>dt=getdate()
- x=getdate("s")
- dt=getdate(x)
- </synopsis>
- </refsynopsisdiv>
- <refsection>
- <title>Paramètres</title>
- <variablelist>
- <varlistentry>
- <term>dt</term>
- <listitem>
- <para>un vecteur entier à 10 composantes (voir plus bas)</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>x</term>
- <listitem>
- <para>un entier contenant la date en secondes écoulées depuis le 1er Janvier 1970</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsection>
- <refsection>
- <title>Description</title>
- <variablelist>
- <varlistentry>
- <term>dt=getdate()</term>
- <listitem>
- <para> renvoie la date courante au format expliqué ci-dessous :</para>
- <variablelist>
- <varlistentry>
- <term>dt(1)</term>
- <listitem>
- <para>l'année (entier compris entre 0000 et 9999).</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(2)</term>
- <listitem>
- <para>le mois (entier compris entre 01 et 12).</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(3)</term>
- <listitem>
- <para>le numéro de semaine à la norme ISO 8601 (entier compris entre 01 et 53).</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(4)</term>
- <listitem>
- <para>le jour du calendrier Julien (entier compris entre 000 et 366).</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(5)</term>
- <listitem>
- <para>le jour de la semaine (entier compris entre 1 (dimanche) et 7).</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(6)</term>
- <listitem>
- <para>le jour dans le mois (entier compris entre 01 et 31).</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(7)</term>
- <listitem>
- <para>l'heure du jour (entier compris entre 00 et 23).</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(8)</term>
- <listitem>
- <para>les minutes (entier compris entre 00 et 59).</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(9)</term>
- <listitem>
- <para>les secondes (entier compris entre 00 et 59).</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(10)</term>
- <listitem>
- <para>les millisecondes (entier compris entre 000 et 999).</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>x = getdate("s")</term>
- <listitem>
- <para> renvoie un entier contenant le nombre de secondes écoulées depuis le 1er Janvier 1970, 00:00 UTC (Unix Time Convention).</para>
- <para>
- L'entier retourné prend en compte <ulink url="http://fr.wikipedia.org/wiki/Seconde_intercalaire">seconde intercalaire</ulink>.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt = getdate(x)</term>
- <listitem>
- <para> renvoie dt au format ci-dessus, à partir de x (nombre de secondes depuis le 1er Janvier 1970).
- Dans ce cas, dt(10) est toujours égal à 0.
- </para>
- <para>
- <literal>getdate(0)</literal> va donc retourner le 1er Janvier 1970, avec l'heure UTC correspondante. Ainsi, le 1er Janvier 1970, 01:00
- sera renvoyé si l'heure UTC est définie et égale à UTC+1.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsection>
- <refsection>
- <title>Exemples</title>
- <programlisting role="example"><![CDATA[
-w=getdate()
-mprintf("Annee:%d,mois:%d,jour:%d",w(1),w(2),w(6));
-
-x=getdate("s")
-getdate(x)
- ]]></programlisting>
- </refsection>
- <refsection role="see also">
- <title>Voir aussi</title>
- <simplelist type="inline">
- <member>
- <link linkend="date">date</link>
- </member>
- <member>
- <link linkend="timer">timer</link>
- </member>
- </simplelist>
- </refsection>
-</refentry>
+++ /dev/null
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
- * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
- * Copyright (C) INRIA -
- *
- * Copyright (C) 2012 - 2016 - Scilab Enterprises
- *
- * This file is hereby licensed under the terms of the GNU GPL v2.0,
- * pursuant to article 5.3.4 of the CeCILL v.2.1.
- * This file was originally licensed under the terms of the CeCILL v2.1,
- * and continues to be available under such terms.
- * For more information, see the COPYING file which you should have received
- * along with this program.
- *
- -->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="getdate">
- <refnamediv>
- <refname>getdate</refname>
- <refpurpose>日付と時間に関する情報を取得</refpurpose>
- </refnamediv>
- <refsynopsisdiv>
- <title>呼び出し手順</title>
- <synopsis>dt=getdate()
- x=getdate("s")
- dt=getdate(x)
- </synopsis>
- </refsynopsisdiv>
- <refsection>
- <title>パラメータ</title>
- <variablelist>
- <varlistentry>
- <term>dt</term>
- <listitem>
- <para>10個の要素を有する整数ベクトル (下記参照)</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>x</term>
- <listitem>
- <para>1970年1月1日からの経過秒数で表された日付を有する整数</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsection>
- <refsection>
- <title>説明</title>
- <variablelist>
- <varlistentry>
- <term>dt=getdate()</term>
- <listitem>
- <para>現在の日付を以下の形式で返します:</para>
- <variablelist>
- <varlistentry>
- <term>dt(1)</term>
- <listitem>
- <para> 0000 と 9999の間の数で表された(世紀を含む)年.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(2)</term>
- <listitem>
- <para>01 と 12の間の数で表された月.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(3)</term>
- <listitem>
- <para>01 と 53の間の数で表されたISO 8601形式の週番号.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(4)</term>
- <listitem>
- <para>
- 001 と 366の間の数で表されたユリウス日
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(5)</term>
- <listitem>
- <para>
- [1,7]の範囲の10進数で表された曜日, 1は日曜日に対応.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(6)</term>
- <listitem>
- <para>01 と 31の間の数で表された月内の日数.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(7)</term>
- <listitem>
- <para>
- 00 と 23の間の数で表された1日内の時間.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(8)</term>
- <listitem>
- <para>
- 出力は00と59の間の数で表された分.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(9)</term>
- <listitem>
- <para>
- 出力は00と59の間の数で表された秒.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(10)</term>
- <listitem>
- <para>
- 出力は000と999の間の数で表されたミリ秒.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>x=getdate("s")</term>
- <listitem>
- <para>
- 1970年1月1日, 00:00 UTC (Unix Time Convention)からの経過
- 秒数をスカラーとして返します.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt=getdate(x)</term>
- <listitem>
- <para>
- x (1970年1月1日, 00:00 UTC からの経過秒数)により指定した
- 日付を上記の形式で成形します.
- この場合, dt(10) は常に 0となります.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsection>
- <refsection>
- <title>例</title>
- <programlisting role="example"><![CDATA[
-w=getdate()
-mprintf("Year:%d,Month:%d,Day:%d",w(1),w(2),w(6));
-x=getdate("s")
-getdate(x)
- ]]></programlisting>
- </refsection>
- <refsection role="see also">
- <title>参照</title>
- <simplelist type="inline">
- <member>
- <link linkend="date">date</link>
- </member>
- <member>
- <link linkend="timer">timer</link>
- </member>
- </simplelist>
- </refsection>
-</refentry>
+++ /dev/null
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
- * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
- * Copyright (C) INRIA -
- *
- * Copyright (C) 2012 - 2016 - Scilab Enterprises
- *
- * This file is hereby licensed under the terms of the GNU GPL v2.0,
- * pursuant to article 5.3.4 of the CeCILL v.2.1.
- * This file was originally licensed under the terms of the CeCILL v2.1,
- * and continues to be available under such terms.
- * For more information, see the COPYING file which you should have received
- * along with this program.
- *
- -->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="getdate" xml:lang="pt">
- <refnamediv>
- <refname>getdate</refname>
- <refpurpose>retorna informação sobre data e hora</refpurpose>
- </refnamediv>
- <refsynopsisdiv>
- <title>Seqüência de Chamamento</title>
- <synopsis>dt=getdate()
- x=getdate("s")
- dt=getdate(x)
- </synopsis>
- </refsynopsisdiv>
- <refsection>
- <title>Parâmetros</title>
- <variablelist>
- <varlistentry>
- <term>dt</term>
- <listitem>
- <para>um vetor de inteiros com 10 entradas (ver abaixo) </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>x</term>
- <listitem>
- <para>um inteiro contendo uma data codificada em segundos a partir
- de 01/01/1970
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsection>
- <refsection>
- <title>Descrição</title>
- <variablelist>
- <varlistentry>
- <term>dt=getdate()</term>
- <listitem>
- <para>retorna a dada corrente no formato dado abaixo:</para>
- <variablelist>
- <varlistentry>
- <term>dt(1)</term>
- <listitem>
- <para>o ano como um número (com o século) entre 0000 e 9999.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(2)</term>
- <listitem>
- <para>o mês do ano como um número entre 01 e 12. </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(3)</term>
- <listitem>
- <para>o número da semana ISO 8601 como um número entre 01 e
- 53.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(4)</term>
- <listitem>
- <para>o dia Juliano do ano como um número entre 001 e 366.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(5)</term>
- <listitem>
- <para>especifica o dia da semana como um número decimal entre
- 1 e 7 , com 1 representando domingo.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(6)</term>
- <listitem>
- <para>o dia do mês como um número entre 01 e 31. </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(7)</term>
- <listitem>
- <para>a hora do dia como um número entre 00 e 23. </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(8)</term>
- <listitem>
- <para>o minuto da hora como um número entre 00 e 59. </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(9)</term>
- <listitem>
- <para>o segundo do minuto como um número entre 00 e 59.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt(10)</term>
- <listitem>
- <para>o milissegundo do segundo como um número entre 000 e
- 999.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>x=getdate("s")</term>
- <listitem>
- <para>retorna um escalar com o número de segundos desde 01/01/1970,
- 00:00 UTC (Convenção de Tempo Unix)
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>dt=getdate(x)</term>
- <listitem>
- <para>põe a data dada por x (número de segundos desde 01/01/1970,
- 00:00 UTC) no formato acima. Neste caso, dt(10) é sempre igual a
- 0.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsection>
- <refsection>
- <title>Exemplos</title>
- <programlisting role="example"><![CDATA[
-w=getdate()
-mprintf("Ano:%d,Mês:%d,Dia:%d",w(1),w(2),w(6));
-
-x=getdate("s")
-getdate(x)
- ]]></programlisting>
- </refsection>
- <refsection role="see also">
- <title>Ver Também</title>
- <simplelist type="inline">
- <member>
- <link linkend="date">date</link>
- </member>
- <member>
- <link linkend="timer">timer</link>
- </member>
- </simplelist>
- </refsection>
-</refentry>