* Bugs 15163 16496 fixed [doc]: getdate() page rewritten 52/21552/5
Samuel GOUGEON [Sun, 26 Jul 2020 21:52:53 +0000 (23:52 +0200)]
  http://bugzilla.scilab.org/15163
  http://bugzilla.scilab.org/16496
  Rewritten page (PDF): http://bugzilla.scilab.org/attachment.cgi?id=5163

  * FIXED:
    - vectorization of getdate(x) was not documented
    - getdate(x) accept fractional seconds, not only integers. Then
      getdate(x)(10) are fractional seconds, not milliseconds.
    - getdate("s") does NOT take leap seconds into account. Proof added in examples.
    - D = getdate() time referential was not documented.
    - getdate("s"): "UTC (Unix Time Convention)" was puzzling, instead of POSIX.
    - The influence of the computer's time zone on getdate(..) results was unclear.
    - The influence of the computer's DST offset on getdate(..) results was undocumented.
  * Short description explicited and clarified.
  * dateTime format: presentation improved, more compact.
  * Examples added.
  * See also: + calendar, clock, datenum

Change-Id: I8b63a87d462b285086a1bff258888ae6cc6624d5

scilab/CHANGES.md
scilab/modules/time/help/en_US/getdate.xml
scilab/modules/time/help/fr_FR/getdate.xml [deleted file]
scilab/modules/time/help/ja_JP/getdate.xml [deleted file]
scilab/modules/time/help/pt_BR/getdate.xml [deleted file]

index b85eac1..d3c8c31 100644 (file)
@@ -200,9 +200,15 @@ Feature changes and additions
 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`
 
@@ -288,6 +294,7 @@ Bug Fixes
 * [#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.
@@ -320,12 +327,12 @@ Bug Fixes
 * [#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.
index 8dade9c..4f140a4 100644 (file)
@@ -1,9 +1,7 @@
 <?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>
diff --git a/scilab/modules/time/help/fr_FR/getdate.xml b/scilab/modules/time/help/fr_FR/getdate.xml
deleted file mode 100644 (file)
index 8df09e8..0000000
+++ /dev/null
@@ -1,160 +0,0 @@
-<?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>
diff --git a/scilab/modules/time/help/ja_JP/getdate.xml b/scilab/modules/time/help/ja_JP/getdate.xml
deleted file mode 100644 (file)
index 5a6d8a6..0000000
+++ /dev/null
@@ -1,169 +0,0 @@
-<?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>
diff --git a/scilab/modules/time/help/pt_BR/getdate.xml b/scilab/modules/time/help/pt_BR/getdate.xml
deleted file mode 100644 (file)
index 6279306..0000000
+++ /dev/null
@@ -1,166 +0,0 @@
-<?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>