diff options
Diffstat (limited to 'modules/time/help')
53 files changed, 3702 insertions, 0 deletions
diff --git a/modules/time/help/en_US/addchapter.sce b/modules/time/help/en_US/addchapter.sce new file mode 100755 index 000000000..acd4f7b0e --- /dev/null +++ b/modules/time/help/en_US/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Time and Date",SCI+"/modules/time/help/en_US",%T); + diff --git a/modules/time/help/en_US/calendar.xml b/modules/time/help/en_US/calendar.xml new file mode 100755 index 000000000..bfff38020 --- /dev/null +++ b/modules/time/help/en_US/calendar.xml @@ -0,0 +1,47 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="calendar"> + <refnamediv> + <refname>calendar</refname> + <refpurpose>Calendar</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>c=calendar() + c = calendar(y,m) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para>c = calendar returns a list containing a calendar for the current month. The calendar runs Sunday to Saturday.</para> + <para>c = calendar(y,m), where y and m are integers, returns a calendar for the specified month of the specified year.</para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +calendar() +calendar(1973,8) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="datevec">datevec</link> + </member> + <member> + <link linkend="datenum">datenum</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/en_US/clock.xml b/modules/time/help/en_US/clock.xml new file mode 100755 index 000000000..21f606d4e --- /dev/null +++ b/modules/time/help/en_US/clock.xml @@ -0,0 +1,57 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="clock"> + <refnamediv> + <refname>clock</refname> + <refpurpose>Return current time as date vector</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>c = clock</synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para>c = clock returns a 6-element date vector containing the current date and time in decimal form:</para> + <para>c = [year month day hour minute seconds]</para> + <para>the first five elements are integers. The seconds element is accurate to several digits beyond the decimal point.</para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +clock + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="datevec">datevec</link> + </member> + <member> + <link linkend="timer">timer</link> + </member> + <member> + <link linkend="etime">etime</link> + </member> + <member> + <link linkend="tic">tic</link> + </member> + <member> + <link linkend="toc">toc</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/en_US/date.xml b/modules/time/help/en_US/date.xml new file mode 100755 index 000000000..ca350dc68 --- /dev/null +++ b/modules/time/help/en_US/date.xml @@ -0,0 +1,63 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="date"> + <refnamediv> + <refname>date</refname> + <refpurpose>Current date as date string</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>dt=date()</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>dt</term> + <listitem> + <para>a string</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para>dt=date() returns a string containing the date in dd-mmm-yyyy format.</para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +date() + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="getdate">getdate</link> + </member> + <member> + <link linkend="toc">toc</link> + </member> + <member> + <link linkend="tic">tic</link> + </member> + <member> + <link linkend="timer">timer</link> + </member> + <member> + <link linkend="etime">etime</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/en_US/datenum.xml b/modules/time/help/en_US/datenum.xml new file mode 100755 index 000000000..c8b7d9586 --- /dev/null +++ b/modules/time/help/en_US/datenum.xml @@ -0,0 +1,97 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="datenum"> + <refnamediv> + <refname>datenum</refname> + <refpurpose>Convert to serial date number</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>N = datenum() + N = datenum(DT) + N = datenum(Y, M, D) + N = datenum(Y, M, D, H, MI, S) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para> + The datenum function converts date vectors (defined by datevec) into + serial date numbers. Date numbers are serial days elapsed from some + reference date. By default, the serial day 1 corresponds to 1-Jan-0000. + </para> + <para> + N = datenum() returns the serial date numbers corresponding to current date. + </para> + <para> + N = datenum(DT) converts one or more date vectors to serial date number N. + DT can be an m-by-6 or m-by-3 matrix containing m full or partial date vector + respectively. + </para> + <para> + N = datenum(Y, M, D) returns the serial date numbers for corresponding elements + of the Y, M, and D (year, month, day) arrays. Y, M and D must be arrays of the same + size (or any can be a scalar). + </para> + <para> + N = datenum(Y, M, D, H, MI, S) returns the serial date numbers for + corresponding elements of the Y, M, D, H, MI, and S (year, month, day, + hour, minute, and second) array values.Y, M, D, H, MI, and S must be arrays of + the same size (or any can be a scalar). + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +// N = datenum() +datenum() + +// N = datenum(DT) +A = [ 0 1 1 0 0 0 ; 2005 2 8 21 37 30 ] +datenum(A) + +// N = datenum(Y, M, D) + +Years = [0; 1973; 2006] +Months = [1; 8; 2] +Days = [1; 4; 8] +datenum(Years,Months,Days) + +Years = [0 0 0 ; 0 0 0] +Months = [1 1 1 ; 1 1 1] +Days = [1 2 3 ; 4 5 6] +datenum(Years,Months,Days) + +// N = datenum(Y, M, D, H, MI, S) + +Years = grand(5,10,'uin',0,2006) +Months = grand(5,10,'uin',1,12) +Days = grand(5,10,'uin',1,28) +Hours = grand(5,10,'uin',0,23) +Minutes = grand(5,10,'uin',0,59) +Seconds = grand(5,10,'uin',0,59) +datenum(Years,Months,Days,Hours,Minutes,Seconds) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="datevec">datevec</link> + </member> + <member> + <link linkend="calendar">calendar</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/en_US/datevec.xml b/modules/time/help/en_US/datevec.xml new file mode 100755 index 000000000..1d7ee4c0d --- /dev/null +++ b/modules/time/help/en_US/datevec.xml @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="datevec"> + <refnamediv> + <refname>datevec</refname> + <refpurpose>Date components</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>V=datevec(DT) + [Y,M,D,H,MI,S]=datevec(DT) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para> + V = datevec(DT) converts a serial date number (defined by datenum) to a + date vector V having elements [year, month, day, hour, minute, second]. + The first five vector elements are integers. DT can be an array. + </para> + <para> + [Y, M, D, H, MI, S] = datevec(DT) returns the components of the date + vector as individual variables. DT can be an array. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +// First example +datevec(720840) + +// Second example +datevec(datenum()) + +// Third example (With integers values) +A = grand(10,12,'uin',1,1000000) +datevec(A) + +// Fourth example (With real values) +A = grand(10,12,'unf',1,1000000) +datevec(A) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="calendar">calendar</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/en_US/eomday.xml b/modules/time/help/en_US/eomday.xml new file mode 100755 index 000000000..2d9bd42bf --- /dev/null +++ b/modules/time/help/en_US/eomday.xml @@ -0,0 +1,79 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="eomday"> + <refnamediv> + <refname>eomday</refname> + <refpurpose>Return last day of month</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>E = eomday(Y, M)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>Y</term> + <listitem> + <para>a vector/matrix containing integers values.</para> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term>M</term> + <listitem> + <para>a vector/matrix containing integers values.</para> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term>E</term> + <listitem> + <para>a vector/matrix containing integers values.</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <literal>E= eomday(Y, M)</literal> returns the last day of the year and month + given by corresponding elements of matrices <varname>Y</varname> and <varname>M</varname>. + </para> + <para> + <varname>Y</varname> and <varname>M</varname> must have the same sizes. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +eomday(2006,3); + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="datevec">datevec</link> + </member> + <member> + <link linkend="weekday">weekday</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/en_US/etime.xml b/modules/time/help/en_US/etime.xml new file mode 100755 index 000000000..f95e6c886 --- /dev/null +++ b/modules/time/help/en_US/etime.xml @@ -0,0 +1,107 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="etime"> + <refnamediv> + <refname>etime</refname> + <refpurpose>Elapsed time</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>e = etime(t2,t1)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>t2</term> + <listitem> + <para>a vector with 6 or 10 values.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>t1</term> + <listitem> + <para>a vector with 6 or 10 values.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>e</term> + <listitem> + <para> + number of seconds between <literal>t2</literal> and <literal>t1</literal>. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <variablelist> + <varlistentry> + <term>t1 and t2 with 10 values</term> + <listitem> + <para> + <literal>t2</literal> and <literal>t1</literal> must have format returned by <literal>getdate</literal>. + In this case, their third, fourth and fifth values are ignored. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>t1 and t2 with 6 values</term> + <listitem> + <para> + <literal>t2</literal> and <literal>t1</literal> must have format: T = [Year Month Day Hour Minute Second] + with Second a number of seconds with milliseconds (e.g: 12.345). + </para> + </listitem> + </varlistentry> + </variablelist> + <para> + <literal>t2</literal> and <literal>t1</literal> must have the same size. + </para> + <para> + <literal>t2</literal> et <literal>t1</literal> can be matrices with each line containing a format described above (all lines having same format). + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +t1=[2004 06 10 17 00 12.345] +t2=[2004 06 10 17 01 13.965] +E1=etime(t2,t1) +t1=[2004 06 24 162 5 10 17 00 12 345] +t2=[2004 06 24 162 5 10 17 01 13 965] +E2=etime(t2,t1) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="tic">tic</link> + </member> + <member> + <link linkend="toc">toc</link> + </member> + <member> + <link linkend="getdate">getdate</link> + </member> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="datevec">datevec</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/en_US/getdate.xml b/modules/time/help/en_US/getdate.xml new file mode 100755 index 000000000..c29e19192 --- /dev/null +++ b/modules/time/help/en_US/getdate.xml @@ -0,0 +1,157 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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"> + <refnamediv> + <refname>getdate</refname> + <refpurpose>get date and time information</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>dt=getdate() + x=getdate("s") + dt=getdate(x) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>dt</term> + <listitem> + <para>an integer vector with 10 entries (see below)</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> + <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> + </listitem> + </varlistentry> + <varlistentry> + <term>x=getdate("s")</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> + </listitem> + </varlistentry> + <varlistentry> + <term>dt=getdate(x)</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> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Examples</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>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="date">date</link> + </member> + <member> + <link linkend="timer">timer</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/en_US/now.xml b/modules/time/help/en_US/now.xml new file mode 100755 index 000000000..c243b5544 --- /dev/null +++ b/modules/time/help/en_US/now.xml @@ -0,0 +1,54 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="now"> + <refnamediv> + <refname>now</refname> + <refpurpose>Return current date under the form of a Unix hour (timestamp)</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>t = now()</synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para> + t = now() returns date and time as a serial date number. (See <link linkend="datenum">datenum</link>) + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +realtimeinit(1); +realtime(0); +t1 = now() +datevec(t1) +realtime(10); +t1 = now() +datevec(t1) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="clock">clock</link> + </member> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="datevec">datevec</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/en_US/realtime.xml b/modules/time/help/en_US/realtime.xml new file mode 100755 index 000000000..6191aac04 --- /dev/null +++ b/modules/time/help/en_US/realtime.xml @@ -0,0 +1,104 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="realtime"> + <refnamediv xml:id="realtimeinit"> + <refname>realtimeinit</refname> + <refpurpose>set time unit</refpurpose> + </refnamediv> + <refnamediv> + <refname>realtime</refname> + <refpurpose>set dates origin or waits until date</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>realtimeinit(time_unit) + realtime(t) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>time_unit</term> + <listitem> + <para> + a real number. The number of seconds associated to the <literal>realtime</literal> argument + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>t</term> + <listitem> + <para>a real number. A date</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> These two functions can be used to handle real time into Scilab.</para> + <para> + <literal>realtimeinit(time_unit)</literal> defines the time unit + associated to the <literal>realtime</literal> argument <literal>t</literal> + </para> + <para> + first call to <literal>realtime(t0)</literal> sets current date to + (<literal>t0</literal>). + subsequent calls to <literal>realtime(t)</literal> wait till date <literal>t</literal> is + reached. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +realtimeinit(1/2);//sets time unit to half a second +realtime(0);//sets current date to 0 +for k=1:10 + realtime(k); + mprintf('current time is '+string(k/2)+'sec .\r\n'); +end + +//next instruction outputs a dot each 2 seconds +realtimeinit(2); +realtime(0); +for k=1:10 + realtime(k); + mprintf('.\r\n'); +end + +realtimeinit(1); +realtime(0); +dt=getdate('s'); +realtime(10); +getdate('s')-dt + ]]></programlisting> + </refsection> + <programlisting role="example"><![CDATA[ +realtimeinit(1); +realtime(0); +t1 = now() +datevec(t1) +realtime(10); +t1 = now() +datevec(t1) + ]]></programlisting> + + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="getdate">getdate</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/en_US/sleep.xml b/modules/time/help/en_US/sleep.xml new file mode 100755 index 000000000..bd8bf9a7d --- /dev/null +++ b/modules/time/help/en_US/sleep.xml @@ -0,0 +1,48 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="sleep"> + <refnamediv> + <refname>sleep</refname> + <refpurpose>suspend Scilab</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>sleep(milliseconds)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para> + <literal>sleep</literal> : Sleep process for specified number of miliseconds + specified by the argument. The actual suspension time may be longer + because of other activities in the system, or because of the time spent in + processing the call. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +tic;sleep(6000);toc + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="xpause">xpause</link> + </member> + <member> + <link linkend="pause">pause</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/en_US/tic.xml b/modules/time/help/en_US/tic.xml new file mode 100755 index 000000000..5d6e7e1df --- /dev/null +++ b/modules/time/help/en_US/tic.xml @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="tic"> + <refnamediv> + <refname>tic</refname> + <refpurpose>start a stopwatch timer</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>tic()</synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para> + The sequence of commands <literal>tic(); operation; toc();</literal> prints the number of seconds required for the operation. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +tic(); +realtimeinit(1); +realtime(0); +realtime(10); +toc(); + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="toc">toc</link> + </member> + <member> + <link linkend="timer">timer</link> + </member> + <member> + <link linkend="etime">etime</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/en_US/timer.xml b/modules/time/help/en_US/timer.xml new file mode 100755 index 000000000..073965e97 --- /dev/null +++ b/modules/time/help/en_US/timer.xml @@ -0,0 +1,62 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="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="timer" xml:lang="en"> + <refnamediv> + <refname>timer</refname> + <refpurpose>cpu time</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>timer()</synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para>Returns the CPU time since the preceding call to + <literal>timer()</literal>. + </para> + <para>timer has a time precision of 100 nanoseconds.</para> + <para> + <note> + NOTE: CPU time is the number of processor cycles used for a + computation. This is not at all equivalent to real-world time. + </note> + </para> + <para>CPU time can be used to compare CPU usage between different programs + or functions , irrespective of background processes that might slow down + the computer. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +timer();A=rand(100,100);timer() + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="getdate">getdate</link> + </member> + <member> + <link linkend="toc">toc</link> + </member> + <member> + <link linkend="tic">tic</link> + </member> + <member> + <link linkend="etime">etime</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/en_US/toc.xml b/modules/time/help/en_US/toc.xml new file mode 100755 index 000000000..7ff2c478e --- /dev/null +++ b/modules/time/help/en_US/toc.xml @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="toc"> + <refnamediv> + <refname>toc</refname> + <refpurpose>Read the stopwatch timer</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>toc() + t = toc() + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Arguments</title> + <variablelist> + <varlistentry> + <term>t</term> + <listitem> + <para> + number of seconds since last call to <literal>tic()</literal> (Precision in order of millisecond). + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + The sequence of commands <literal>tic(); operation; toc();</literal> prints the number of seconds required for the operation. + </para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +tic(); +realtimeinit(1); +realtime(0); +realtime(10); +toc(); + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="tic">tic</link> + </member> + <member> + <link linkend="timer">timer</link> + </member> + <member> + <link linkend="etime">etime</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/en_US/weekday.xml b/modules/time/help/en_US/weekday.xml new file mode 100755 index 000000000..3a1e1b102 --- /dev/null +++ b/modules/time/help/en_US/weekday.xml @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="weekday"> + <refnamediv> + <refname>weekday</refname> + <refpurpose>Return day of week</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Calling Sequence</title> + <synopsis>[N,S] = weekday(D) + [N,S] = weekday(D, form) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para>[N,S] = weekday(D) returns the day of the week in numeric(N) and string(S) form for a given serial date number or date string D. Input argument D can represent more than one date in an array of serial date number.</para> + <para>[N,S] = weekday(D, form) returns the week in numeric(N) and string(S) form, where the content of S depends on the form argument. If form is 'long', then S countains the full name of the weekday (e.g, Thuesday). If form is 'short', then S contains an abbreviated name (e.g., Tue) from this table.</para> + </refsection> + <refsection> + <title>Examples</title> + <programlisting role="example"><![CDATA[ +today = datenum(); +[N,S] = weekday(today) +[N,S] = weekday(today,'short') +[N,S] = weekday(today,'long') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>See Also</title> + <simplelist type="inline"> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="datevec">datevec</link> + </member> + <member> + <link linkend="weekday">weekday</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/fr_FR/addchapter.sce b/modules/time/help/fr_FR/addchapter.sce new file mode 100755 index 000000000..3ffeead1f --- /dev/null +++ b/modules/time/help/fr_FR/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Heure et date",SCI+"/modules/time/help/fr_FR",%T); + diff --git a/modules/time/help/fr_FR/calendar.xml b/modules/time/help/fr_FR/calendar.xml new file mode 100755 index 000000000..312edde01 --- /dev/null +++ b/modules/time/help/fr_FR/calendar.xml @@ -0,0 +1,47 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="calendar"> + <refnamediv> + <refname>calendar</refname> + <refpurpose>Calendrier</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Séquence d'appel</title> + <synopsis>c = calendar() + c = calendar(y,m) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para>c = calendar retourne une liste contenant le calendrier pour le mois en cours. Les semaines debutant le Dimanche(Sunday) et se terminant le Samedi(Saturday).</para> + <para>c = calendar(y,m), ou y et sont des entiers, retourne le calendrier pour le mois et l'annee specifie.</para> + </refsection> + <refsection> + <title>Exemples</title> + <programlisting role="example"><![CDATA[ +calendar() +calendar(1973,8) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Voir aussi</title> + <simplelist type="inline"> + <member> + <link linkend="datevec">datevec</link> + </member> + <member> + <link linkend="datenum">datenum</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/fr_FR/date.xml b/modules/time/help/fr_FR/date.xml new file mode 100755 index 000000000..be1174f38 --- /dev/null +++ b/modules/time/help/fr_FR/date.xml @@ -0,0 +1,63 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="date"> + <refnamediv> + <refname>date</refname> + <refpurpose>date courante sous forme d'une chaîne de caractères</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Séquence d'appel</title> + <synopsis>dt=date()</synopsis> + </refsynopsisdiv> + <refsection> + <title>Paramètres</title> + <variablelist> + <varlistentry> + <term>dt</term> + <listitem> + <para>chaîne de caractères</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para>dt=date() renvoie une chaîne de caractères contenant la date au format jj-mmm-aaaaa.</para> + </refsection> + <refsection> + <title>Exemples</title> + <programlisting role="example"><![CDATA[ +date() + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Voir aussi</title> + <simplelist type="inline"> + <member> + <link linkend="getdate">getdate</link> + </member> + <member> + <link linkend="toc">toc</link> + </member> + <member> + <link linkend="tic">tic</link> + </member> + <member> + <link linkend="timer">timer</link> + </member> + <member> + <link linkend="etime">etime</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/fr_FR/datenum.xml b/modules/time/help/fr_FR/datenum.xml new file mode 100755 index 000000000..c4ff7e51a --- /dev/null +++ b/modules/time/help/fr_FR/datenum.xml @@ -0,0 +1,97 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="datenum"> + <refnamediv> + <refname>datenum</refname> + <refpurpose>Convertie une date en un nombre</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Séquence d'appel</title> + <synopsis>N = datenum() + N = datenum(DT) + N = datenum(Y, M, D) + N = datenum(Y, M, D, H, MI, S) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para> + La fonction datenum convertie une date en un nombre lui correspondant. + Ce nombre correspond au nombre de jours passe depuis une date reference. + Par defaut, cette date est le 1-Jan-0000. + </para> + <para> + N = datenum() retourne le nombre correspondant a la date courante. + </para> + <para> + N = datenum(DT) retourne le nombre correspondant a la date représentée par + la matrice DT. DT est soit une matrice m * 3 ou une matrice m * 6 contenant + respectivement une date entiere (annee,mois,jour,heure,minute,seconde) ou une + date partielle (annee,mois,jour). + </para> + <para> + N = datenum(Y, M, D) retourne le nombre correspondant aux elements Y, + M, D (annee, mois, jour). Y, M et D peuvent être des matrices de même + dimensions ou de simples scalaires. + </para> + <para> + N = datenum(Y, M, D, H, MI, S) retourne le nombre correspondant aux + elements Y, M, D, H, MI, et S (annee, mois, jour, heure, minute, et + seconde).Y, M, D, H, MI, et S peuvent être des matrices de même + dimensions ou de simples scalaires. + </para> + </refsection> + <refsection> + <title>Exemples</title> + <programlisting role="example"><![CDATA[ +// N = datenum() +datenum() + +// N = datenum(DT) +A = [ 0 1 1 0 0 0 ; 2005 2 8 21 37 30 ] +datenum(A) + +// N = datenum(Y, M, D) +Annees = [0; 1973; 2006] +Mois = [1; 8; 2] +Jours = [1; 4; 8] +datenum(Annees,Mois,Jours) + +Annees = [0 0 0 ; 0 0 0] +Mois = [1 1 1 ; 1 1 1] +Jours = [1 2 3 ; 4 5 6] +datenum(Annees,Mois,Jours) + +// N = datenum(Y, M, D, H, MI, S) + +Annees = grand(5,10,'uin',0,2006) +Mois = grand(5,10,'uin',1,12) +Jours = grand(5,10,'uin',1,28) +Heures = grand(5,10,'uin',0,23) +Minutes = grand(5,10,'uin',0,59) +Secondes = grand(5,10,'uin',0,59) +datenum(Annees,Mois,Jours,Heures,Minutes,Secondes) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Voir aussi</title> + <simplelist type="inline"> + <member> + <link linkend="datevec">datevec</link> + </member> + <member> + <link linkend="calendar">calendar</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/fr_FR/datevec.xml b/modules/time/help/fr_FR/datevec.xml new file mode 100755 index 000000000..f518dafde --- /dev/null +++ b/modules/time/help/fr_FR/datevec.xml @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="datevec"> + <refnamediv> + <refname>datevec</refname> + <refpurpose>Reconstruction d'un vecteur contenant une Date</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Séquence d'appel</title> + <synopsis>V=datevec(DT) + [Y,M,D,H,MI,S]=datevec(DT) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para> + V = datevec(DT) convertie un nombre (défini par datenum) en un vecteur + contenant une date dont les éléments sont [year, month, day, hour, minute, + second]. DT peut être une matrice. + </para> + <para> + [Y, M, D, H, MI, S] = datevec(DT) retourne les composants de la date dans 6 variables. + DT peut être une matrice. + </para> + </refsection> + <refsection> + <title>Exemples</title> + <programlisting role="example"><![CDATA[ +// Premier exemple +datevec(720840) + +// Second exemple +datevec(datenum()) + +// Troisième exemple (Avec des valeurs entières) +A = grand(10,12,'uin',1,1000000) +datevec(A) + +// Quatrième exemple (Avec des valeurs réelles) +A = grand(10,12,'unf',1,1000000) +datevec(A) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Voir aussi</title> + <simplelist type="inline"> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="calendar">calendar</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/fr_FR/eomday.xml b/modules/time/help/fr_FR/eomday.xml new file mode 100755 index 000000000..8f6a0ce2b --- /dev/null +++ b/modules/time/help/fr_FR/eomday.xml @@ -0,0 +1,80 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="eomday"> + <refnamediv> + <refname>eomday</refname> + <refpurpose>Retourne le dernier jour d'un mois</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Séquence d'appel</title> + <synopsis>E = eomday(Y, M)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Paramètres</title> + <variablelist> + <varlistentry> + <term>Y</term> + <listitem> + <para> + Vecteur ou matrice contenant des valeurs entières. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>M</term> + <listitem> + <para> + Vecteur ou matrice contenant des valeurs entières. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>E</term> + <listitem> + <para> + Vecteur ou matrice contenant des valeurs entières. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + <literal>E= eomday(Y, M)</literal> retourne le dernier jour du mois et de l'année passée en paramètre. + </para> + <para> + <varname>Y</varname> et <varname>M</varname> doivent avoir les mêmes dimensions. + </para> + </refsection> + <refsection> + <title>Exemples</title> + <programlisting role="example"><![CDATA[ +eomday(2006,3); + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Voir aussi</title> + <simplelist type="inline"> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="datevec">datevec</link> + </member> + <member> + <link linkend="weekday">weekday</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/fr_FR/etime.xml b/modules/time/help/fr_FR/etime.xml new file mode 100755 index 000000000..fc60838ac --- /dev/null +++ b/modules/time/help/fr_FR/etime.xml @@ -0,0 +1,107 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="etime"> + <refnamediv> + <refname>etime</refname> + <refpurpose>Temps écoulé</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Séquence d'appel</title> + <synopsis>e = etime(t2,t1)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Paramètres</title> + <variablelist> + <varlistentry> + <term>t2</term> + <listitem> + <para>un vecteur de 6 ou 10 valeurs.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>t1</term> + <listitem> + <para>un vecteur de 6 ou 10 valeurs.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>e</term> + <listitem> + <para> + nombre de secondes entre <literal>t2</literal> et <literal>t1</literal>. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <variablelist> + <varlistentry> + <term>t1 et t2 contenant 10 valeurs</term> + <listitem> + <para> + : <literal>t2</literal> et <literal>t1</literal> doivent avoir le format retourné par <literal>getdate</literal>. + Dans ce cas, leurs troisièmes, quatrièmes et cinquièmes valeurs sont ignorées. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>t1 et t2 contenant 6 valeurs</term> + <listitem> + <para> + : <literal>t2</literal> et <literal>t1</literal> doivent avoir le format : T = [Year Month Day Hour Minute Second] + avec Second un nombre de secondes et de millisecondes (e.g: 12.345). + </para> + </listitem> + </varlistentry> + </variablelist> + <para> + <literal>t2</literal> et <literal>t1</literal> doivent être de même taille. + </para> + <para> + <literal>t2</literal> et <literal>t1</literal> peuvent être des matrices dont chaque ligne contient un format précisé ci-dessus (toutes les lignes du même format). + </para> + </refsection> + <refsection> + <title>Exemples</title> + <programlisting role="example"><![CDATA[ +t1=[2004 06 10 17 00 12.345] +t2=[2004 06 10 17 01 13.965] +E1=etime(t2,t1) +t1=[2004 06 24 162 5 10 17 00 12 345] +t2=[2004 06 24 162 5 10 17 01 13 965] +E2=etime(t2,t1) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Voir aussi</title> + <simplelist type="inline"> + <member> + <link linkend="tic">tic</link> + </member> + <member> + <link linkend="toc">toc</link> + </member> + <member> + <link linkend="getdate">getdate</link> + </member> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="datevec">datevec</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/fr_FR/getdate.xml b/modules/time/help/fr_FR/getdate.xml new file mode 100755 index 000000000..64b2c7fea --- /dev/null +++ b/modules/time/help/fr_FR/getdate.xml @@ -0,0 +1,157 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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/modules/time/help/fr_FR/now.xml b/modules/time/help/fr_FR/now.xml new file mode 100755 index 000000000..f628c26e6 --- /dev/null +++ b/modules/time/help/fr_FR/now.xml @@ -0,0 +1,54 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="now"> + <refnamediv> + <refname>now</refname> + <refpurpose>retourne la date courante sous forme d'une heure Unix (timestamp)</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Séquence d'appel</title> + <synopsis>t = now()</synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para> + t = now() la date et l'heure courante en un nombre lui correspondant (Voir <link linkend="datenum">datenum</link>) + </para> + </refsection> + <refsection> + <title>Exemples</title> + <programlisting role="example"><![CDATA[ +realtimeinit(1); +realtime(0); +t1 = now() +datevec(t1) +realtime(10); +t1 = now() +datevec(t1) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Voir aussi</title> + <simplelist type="inline"> + <member> + <link linkend="now">now</link> + </member> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="datevec">datevec</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/fr_FR/sleep.xml b/modules/time/help/fr_FR/sleep.xml new file mode 100755 index 000000000..ea3c1e203 --- /dev/null +++ b/modules/time/help/fr_FR/sleep.xml @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="sleep"> + <refnamediv> + <refname>sleep</refname> + <refpurpose>suspend Scilab</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Séquence d'appel</title> + <synopsis>sleep(milliseconds)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para> + <literal>sleep</literal>Sleep suspend Scilab durant la durée specifiée en + millisecondes. + </para> + </refsection> + <refsection> + <title>Exemples</title> + <programlisting role="example"><![CDATA[ +tic;sleep(6000);toc + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Voir aussi</title> + <simplelist type="inline"> + <member> + <link linkend="xpause">xpause</link> + </member> + <member> + <link linkend="pause">pause</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/fr_FR/tic.xml b/modules/time/help/fr_FR/tic.xml new file mode 100755 index 000000000..4db822e0a --- /dev/null +++ b/modules/time/help/fr_FR/tic.xml @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="tic"> + <refnamediv> + <refname>tic</refname> + <refpurpose>Démarre le chronomètre</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Séquence d'appel</title> + <synopsis>tic()</synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para> + La séquence de commandes <literal>tic(); opération; toc();</literal> affiche le nombre de secondes nécessaire pour opération. + </para> + </refsection> + <refsection> + <title>Exemples</title> + <programlisting role="example"><![CDATA[ +tic(); +realtimeinit(1); +realtime(0); +realtime(10); +toc(); + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Voir aussi</title> + <simplelist type="inline"> + <member> + <link linkend="toc">toc</link> + </member> + <member> + <link linkend="timer">timer</link> + </member> + <member> + <link linkend="etime">etime</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/fr_FR/timer.xml b/modules/time/help/fr_FR/timer.xml new file mode 100755 index 000000000..b988fedcf --- /dev/null +++ b/modules/time/help/fr_FR/timer.xml @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="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="timer" xml:lang="fr"> + <refnamediv> + <refname>timer</refname> + <refpurpose>temps CPU consommé</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Séquence d'appel</title> + <synopsis>timer()</synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para>Renvoie le temps CPU consommé par Scilab depuis le dernier appel à + <literal>timer()</literal>. + </para> + <para>timer a une precision de 100 nanosecondes.</para> + <para> + <note> + Remarque : Le temps CPU est le nombre de cycles processeur utilisé + pour l'execution. + </note> + </para> + <para>Le temps CPU peut etre utilisé pour comparer l'usage CPU entre + différents programmes ou fonctions, indépendamment des processus en + arrière plan qui peuvent ralentir l'ordinateur. + </para> + </refsection> + <refsection> + <title>Exemples</title> + <programlisting role="example"><![CDATA[ +timer();A=rand(100,100);timer() + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Voir aussi</title> + <simplelist type="inline"> + <member> + <link linkend="getdate">getdate</link> + </member> + <member> + <link linkend="toc">toc</link> + </member> + <member> + <link linkend="tic">tic</link> + </member> + <member> + <link linkend="timer">timer</link> + </member> + <member> + <link linkend="etime">etime</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/fr_FR/toc.xml b/modules/time/help/fr_FR/toc.xml new file mode 100755 index 000000000..d433d5cc5 --- /dev/null +++ b/modules/time/help/fr_FR/toc.xml @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="toc"> + <refnamediv> + <refname>toc</refname> + <refpurpose>Lit le chronomètre</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Séquence d'appel</title> + <synopsis>toc() + t = toc() + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Paramètres</title> + <variablelist> + <varlistentry> + <term>t</term> + <listitem> + <para> + nombre de secondes depuis le dernier appel à <literal>tic()</literal> (Précision de l'ordre de la milliseconde). + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Description</title> + <para> + La séquence de commandes <literal>tic(); opération; toc();</literal> affiche le nombre de secondes nécessaire pour opération. + </para> + </refsection> + <refsection> + <title>Exemples</title> + <programlisting role="example"><![CDATA[ +tic(); +realtimeinit(1); +realtime(0); +realtime(10); +toc(); + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Voir aussi</title> + <simplelist type="inline"> + <member> + <link linkend="tic">tic</link> + </member> + <member> + <link linkend="timer">timer</link> + </member> + <member> + <link linkend="etime">etime</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/fr_FR/weekday.xml b/modules/time/help/fr_FR/weekday.xml new file mode 100755 index 000000000..950b40a37 --- /dev/null +++ b/modules/time/help/fr_FR/weekday.xml @@ -0,0 +1,54 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="weekday"> + <refnamediv> + <refname>weekday</refname> + <refpurpose>Retourne le jour de la semaine</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Séquence d'appel</title> + <synopsis>[N,S] = weekday(D) + [N,S] = weekday(D, form) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Description</title> + <para> + [N,S] = weekday(D) retourne le jour de la semaine sous une forme numérique(N) et une chaîne de caractère(S) pour une date donnée (sous la forme d'un "serial date number" : see <link linkend="datenum">datenum</link>). Le paramètre passé en entrée peut être une matrice de "serial date number" + </para> + <para>[N,S] = weekday(D, form)) retourne le jour de la semaine sous une forme numérique(N) et une chaîne de caractère(S), où le contenu de S dépend du paramètre "form". Si form est égal à 'long', S contient le nom complet du jour de la semaine tandis que si form est égal à 'short', S contient l'abbreviation du nom du jour de la semaine.</para> + </refsection> + <refsection> + <title>Exemples</title> + <programlisting role="example"><![CDATA[ +today = datenum(); +[N,S] = weekday(today) +[N,S] = weekday(today,'short') +[N,S] = weekday(today,'long') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Voir aussi</title> + <simplelist type="inline"> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="datevec">datevec</link> + </member> + <member> + <link linkend="weekday">weekday</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/ja_JP/addchapter.sce b/modules/time/help/ja_JP/addchapter.sce new file mode 100755 index 000000000..2919c4410 --- /dev/null +++ b/modules/time/help/ja_JP/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Time and Date",SCI+"/modules/time/help/ja_JP",%T); + diff --git a/modules/time/help/ja_JP/calendar.xml b/modules/time/help/ja_JP/calendar.xml new file mode 100755 index 000000000..bf5bc8c88 --- /dev/null +++ b/modules/time/help/ja_JP/calendar.xml @@ -0,0 +1,51 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="calendar"> + <refnamediv> + <refname>calendar</refname> + <refpurpose>カレンダー</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>c=calendar() + c = calendar(y,m) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>説明</title> + <para>c = calendar は現在の月に関するカレンダーを含むリストを返します. + カレンダーは日曜日から土曜日までとなります. + </para> + <para>c = calendar(y,m), ただし, y および m は整数で, 指定した年の + 指定した月のカレンダーを返します. + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +calendar() +calendar(1973,8) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="datevec">datevec</link> + </member> + <member> + <link linkend="datenum">datenum</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/ja_JP/clock.xml b/modules/time/help/ja_JP/clock.xml new file mode 100755 index 000000000..7480f3de4 --- /dev/null +++ b/modules/time/help/ja_JP/clock.xml @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="clock"> + <refnamediv> + <refname>clock</refname> + <refpurpose>現在の時間を日付ベクトルとして返す</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>c = clock</synopsis> + </refsynopsisdiv> + <refsection> + <title>説明</title> + <para>c = clock は,現在の10進形式の日付と時間を有する要素数6の日付ベクトル + を返します: + </para> + <para>c = [年 月 日 時間 分 秒]</para> + <para>最初の5つの要素は整数です.2番目の要素は小数点以下数桁まで正確です.</para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +clock + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="datevec">datevec</link> + </member> + <member> + <link linkend="timer">timer</link> + </member> + <member> + <link linkend="etime">etime</link> + </member> + <member> + <link linkend="tic">tic</link> + </member> + <member> + <link linkend="toc">toc</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/ja_JP/date.xml b/modules/time/help/ja_JP/date.xml new file mode 100755 index 000000000..3bf197074 --- /dev/null +++ b/modules/time/help/ja_JP/date.xml @@ -0,0 +1,63 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="date"> + <refnamediv> + <refname>date</refname> + <refpurpose>現在の日付を日付文字列として得る</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>dt=date()</synopsis> + </refsynopsisdiv> + <refsection> + <title>パラメータ</title> + <variablelist> + <varlistentry> + <term>dt</term> + <listitem> + <para>文字列</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>説明</title> + <para>dt=date() は, dd-mmm-yyyy 形式の日付を有する文字列を返します.</para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +date() + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="getdate">getdate</link> + </member> + <member> + <link linkend="toc">toc</link> + </member> + <member> + <link linkend="tic">tic</link> + </member> + <member> + <link linkend="timer">timer</link> + </member> + <member> + <link linkend="etime">etime</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/ja_JP/datenum.xml b/modules/time/help/ja_JP/datenum.xml new file mode 100755 index 000000000..be4d66016 --- /dev/null +++ b/modules/time/help/ja_JP/datenum.xml @@ -0,0 +1,89 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="datenum"> + <refnamediv> + <refname>datenum</refname> + <refpurpose>シリアル日付番号に変換する</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>N = datenum() + N = datenum(DT) + N = datenum(Y, M, D) + N = datenum(Y, M, D, H, MI, S) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>説明</title> + <para> + datenum 関数は(datevecにより定義された)日付ベクトルをシリアル日付番号に変換します. + 日付番号は、ある基準日から経過した日数です. + デフォルトで,このシリアル日付の１は 1-Jan-0000 に対応します. + </para> + <para> + N = datenum() は現在の日付に対応するシリアル日付番号を返します. + </para> + <para> + N = datenum(DT) は,一つまたは複数のベクトルをシリアル日付番号Nに変換します. + DTは,m個の完全な日付ベクトルからなるm行x6列，または部分的な日付ベクトルからなるm行x3列の行列 + です. + </para> + <para> + N = datenum(Y, M, D) はY,M,D(年,月,日)配列に対応するシリアル日付番号を返します. + Y,M,Dは同じ大きさの配列(またはスカラー)とする必要があります. + </para> + <para> + N = datenum(Y, M, D, H, MI, S) は配列 Y, M, D, H, MI, および S (年,月,日,時間,分, + および秒)に対応するシリアル日付番号を返します. + Y, M, D, H, MI, および Sは同じ大きさの配列(またはスカラー)とする必要があります. + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +// N = datenum() +datenum() +// N = datenum(DT) +A = [ 0 1 1 0 0 0 ; 2005 2 8 21 37 30 ] +datenum(A) +// N = datenum(Y, M, D) +Years = [0; 1973; 2006] +Months = [1; 8; 2] +Days = [1; 4; 8] +datenum(Years,Months,Days) +Years = [0 0 0 ; 0 0 0] +Months = [1 1 1 ; 1 1 1] +Days = [1 2 3 ; 4 5 6] +datenum(Years,Months,Days) +// N = datenum(Y, M, D, H, MI, S) +Years = grand(5,10,'uin',0,2006) +Months = grand(5,10,'uin',1,12) +Days = grand(5,10,'uin',1,28) +Hours = grand(5,10,'uin',0,23) +Minutes = grand(5,10,'uin',0,59) +Seconds = grand(5,10,'uin',0,59) +datenum(Years,Months,Days,Hours,Minutes,Seconds) + ]]></programlisting> + </refsection> + <refsection> + <title>参考</title> + <simplelist type="inline"> + <member> + <link linkend="datevec">datevec</link> + </member> + <member> + <link linkend="calendar">calendar</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/ja_JP/datevec.xml b/modules/time/help/ja_JP/datevec.xml new file mode 100755 index 000000000..f8143c4df --- /dev/null +++ b/modules/time/help/ja_JP/datevec.xml @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="datevec"> + <refnamediv> + <refname>datevec</refname> + <refpurpose>日付の要素</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>V=datevec(DT) + [Y,M,D,H,MI,S]=datevec(DT) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>説明</title> + <para> + V = datevec(DT) は,(datenumにより定義された)日数を + 要素[year, month, day, hour, minute, second]を有する日付ベクトル V + に変換します. + 最初の5個の要素は整数です. + DT は配列とすることができます. + </para> + <para> + [Y, M, D, H, MI, S] = datevec(DT) は日付ベクトルの + 要素を別々の配列に返します. + DT は配列とすることができます. + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +// 最初の例 +datevec(720840) +// ２番目の例 +datevec(datenum()) +// ３番目の例 (整数値を指定) +A = grand(10,12,'uin',1,1000000) +datevec(A) +// ４番目の例 (実数値を指定) +A = grand(10,12,'unf',1,1000000) +datevec(A) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="calendar">calendar</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/ja_JP/eomday.xml b/modules/time/help/ja_JP/eomday.xml new file mode 100755 index 000000000..8d84f3c70 --- /dev/null +++ b/modules/time/help/ja_JP/eomday.xml @@ -0,0 +1,48 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="eomday"> + <refnamediv> + <refname>eomday</refname> + <refpurpose>月の最後の日を返す</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>E = eomday(Y, M)</synopsis> + </refsynopsisdiv> + <refsection> + <title>説明</title> + <para>E = eomday(Y, M) はそれぞれ配列 Y および Mで指定した年および月の + 最後の日を返します. + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +eomday(2006,3); + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="datevec">datevec</link> + </member> + <member> + <link linkend="weekday">weekday</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/ja_JP/etime.xml b/modules/time/help/ja_JP/etime.xml new file mode 100755 index 000000000..89320c761 --- /dev/null +++ b/modules/time/help/ja_JP/etime.xml @@ -0,0 +1,112 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="etime"> + <refnamediv> + <refname>etime</refname> + <refpurpose>経過時間</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>e = etime(t2,t1)</synopsis> + </refsynopsisdiv> + <refsection> + <title>パラメータ</title> + <variablelist> + <varlistentry> + <term>t2</term> + <listitem> + <para>6または10個の値を有するベクトル.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>t1</term> + <listitem> + <para>6または10個の値を有するベクトル.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>e</term> + <listitem> + <para> + <literal>t2</literal> および <literal>t1</literal>の間の秒数. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>説明</title> + <variablelist> + <varlistentry> + <term>t1 および t2 が10個の値を有する場合</term> + <listitem> + <para> + <literal>t2</literal> および <literal>t1</literal> は, + <literal>getdate</literal>により返された形式である必要があります. + この場合,その3番目,4番目および5番目の値は無視されます. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>t1 および t2 が6個の値を有する場合</term> + <listitem> + <para> + <literal>t2</literal> および <literal>t1</literal> は, + 以下の形式である必要があります: T = [年 月 日 時間 分 秒] + ただし,秒はミリ秒単位(例: 12.345)です. + </para> + </listitem> + </varlistentry> + </variablelist> + <para> + <literal>t2</literal> および <literal>t1</literal> は, + 同じ大きさである必要があります.. + </para> + <para> + <literal>t2</literal> および <literal>t1</literal> は, + 各行に上記の形式のデータを有する行列とすることができます + (全ての行は同じ形式とします). + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +t1=[2004 06 10 17 00 12.345] +t2=[2004 06 10 17 01 13.965] +E1=etime(t2,t1) +t1=[2004 06 24 162 5 10 17 00 12 345] +t2=[2004 06 24 162 5 10 17 01 13 965] +E2=etime(t2,t1) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="tic">tic</link> + </member> + <member> + <link linkend="toc">toc</link> + </member> + <member> + <link linkend="getdate">getdate</link> + </member> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="datevec">datevec</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/ja_JP/getdate.xml b/modules/time/help/ja_JP/getdate.xml new file mode 100755 index 000000000..8b1d9842f --- /dev/null +++ b/modules/time/help/ja_JP/getdate.xml @@ -0,0 +1,166 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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/modules/time/help/ja_JP/now.xml b/modules/time/help/ja_JP/now.xml new file mode 100755 index 000000000..aab4bd1eb --- /dev/null +++ b/modules/time/help/ja_JP/now.xml @@ -0,0 +1,54 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="now"> + <refnamediv> + <refname>now</refname> + <refpurpose>現在の日付と時間を返す</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>t = now()</synopsis> + </refsynopsisdiv> + <refsection> + <title>説明</title> + <para>t = now() は,日数として日付と時間を返します. + (<link linkend="datenum">datenum</link>参照) + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +realtimeinit(1); +realtime(0); +t1 = now() +datevec(t1) +realtime(10); +t1 = now() +datevec(t1) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="clock">clock</link> + </member> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="datevec">datevec</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/ja_JP/realtime.xml b/modules/time/help/ja_JP/realtime.xml new file mode 100755 index 000000000..632b51942 --- /dev/null +++ b/modules/time/help/ja_JP/realtime.xml @@ -0,0 +1,104 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="realtime"> + <refnamediv xml:id="realtimeinit"> + <refname>realtimeinit</refname> + <refpurpose>時間の単位を設定</refpurpose> + </refnamediv> + <refnamediv> + <refname>realtime</refname> + <refpurpose>日付の原点を設定または指定日付まで待つ</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>realtimeinit(time_unit) + realtime(t) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>パラメータ</title> + <variablelist> + <varlistentry> + <term>time_unit</term> + <listitem> + <para> + 実数. <literal>realtime</literal> の引数に関連する秒数 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>t</term> + <listitem> + <para>実数. 日付</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>説明</title> + <para> + これら2つの関数はScilabで実時間を処理する際に使用できます. + </para> + <para> + <literal>realtimeinit(time_unit)</literal> は, + <literal>realtime</literal> の引数 <literal>t</literal>に + 関する時間の単位を定義します. + </para> + <para> + <literal>realtime(t0)</literal>を最初にコールした際, + カレントの日付が<literal>t0</literal>に設定されます. + これ以降のコール<literal>realtime(t)</literal>では, + 日付<literal>t</literal>に達するまで待機します. + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +realtimeinit(1/2);//時間の単位を 0.5秒に設定s +realtime(0);// カレントの時刻を 0に設定 +for k=1:10 + realtime(k); + mprintf('current time is '+string(k/2)+'sec .\r\n'); +end +//次の命令では2秒毎にドットを出力 +realtimeinit(2); +realtime(0); +for k=1:10 + realtime(k); + mprintf('.\r\n'); +end +realtimeinit(1); +realtime(0); +dt=getdate('s'); +realtime(10); +getdate('s')-dt + ]]></programlisting> + <programlisting role="example"><![CDATA[ +realtimeinit(1); +realtime(0); +t1 = now() +datevec(t1) +realtime(10); +t1 = now() +datevec(t1) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="getdate">getdate</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/ja_JP/sleep.xml b/modules/time/help/ja_JP/sleep.xml new file mode 100755 index 000000000..2558b58d6 --- /dev/null +++ b/modules/time/help/ja_JP/sleep.xml @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="sleep"> + <refnamediv> + <refname>sleep</refname> + <refpurpose>Scilabを停止(サスペンド)する</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>sleep(milliseconds)</synopsis> + </refsynopsisdiv> + <refsection> + <title>説明</title> + <para> + <literal>sleep</literal> : + 引数で指定したミリ秒の間処理を停止します. + 他のシステムの処理または + 呼び出し処理の時間により,実際に停止される時間は + 長くなる可能性があります. + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +tic;sleep(6000);toc + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="xpause">xpause</link> + </member> + <member> + <link linkend="pause">pause</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/ja_JP/tic.xml b/modules/time/help/ja_JP/tic.xml new file mode 100755 index 000000000..00114e5bc --- /dev/null +++ b/modules/time/help/ja_JP/tic.xml @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="tic"> + <refnamediv> + <refname>tic</refname> + <refpurpose>ストップウォッチタイマーを開始</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>tic()</synopsis> + </refsynopsisdiv> + <refsection> + <title>説明</title> + <para> + 一連のコマンド <literal>tic(); 処理; toc();</literal> により, + 処理に要した秒数が出力されます. + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +tic(); +realtimeinit(1); +realtime(0); +realtime(10); +toc(); + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="toc">toc</link> + </member> + <member> + <link linkend="timer">timer</link> + </member> + <member> + <link linkend="etime">etime</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/ja_JP/timer.xml b/modules/time/help/ja_JP/timer.xml new file mode 100755 index 000000000..d26a1f728 --- /dev/null +++ b/modules/time/help/ja_JP/timer.xml @@ -0,0 +1,63 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="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="timer" xml:lang="ja"> + <refnamediv> + <refname>timer</refname> + <refpurpose>CPU時間</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>timer()</synopsis> + </refsynopsisdiv> + <refsection> + <title>説明</title> + <para> + <literal>timer()</literal>への前のコールからの経過時間を + CPU時間で返します. + </para> + <para>timer の時間精度は 100ナノ秒です.</para> + <para>注意: CPU 時間は, + 計算に使用されるプロセッサ周期数です. + これは,実時間と完全に等価なわけではありません. + </para> + <para>CPU時間は, + 計算機を遅くするような + バックグラウンド処理にかかわりなく, + 異なるプログラムまたは関数の間で要するCPU消費を + 比較する際に使用できます. + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +timer();A=rand(100,100);timer() + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="getdate">getdate</link> + </member> + <member> + <link linkend="toc">toc</link> + </member> + <member> + <link linkend="tic">tic</link> + </member> + <member> + <link linkend="etime">etime</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/ja_JP/toc.xml b/modules/time/help/ja_JP/toc.xml new file mode 100755 index 000000000..5810e7588 --- /dev/null +++ b/modules/time/help/ja_JP/toc.xml @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="toc"> + <refnamediv> + <refname>toc</refname> + <refpurpose>ストップウォッチタイマーを読む</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>toc() + t = toc() + </synopsis> + </refsynopsisdiv> + <refsection> + <title>パラメータ</title> + <variablelist> + <varlistentry> + <term>t</term> + <listitem> + <para> + <literal>tic()</literal>への最後のコール以降の経過秒数 + (精度はミリ秒レベル). + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>説明</title> + <para> + 一連のコマンド <literal>tic(); 処理; toc();</literal> は, + 処理に要した秒数を出力します. + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +tic(); +realtimeinit(1); +realtime(0); +realtime(10); +toc(); + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="tic">tic</link> + </member> + <member> + <link linkend="timer">timer</link> + </member> + <member> + <link linkend="etime">etime</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/ja_JP/weekday.xml b/modules/time/help/ja_JP/weekday.xml new file mode 100755 index 000000000..b9abb7ce1 --- /dev/null +++ b/modules/time/help/ja_JP/weekday.xml @@ -0,0 +1,61 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="weekday"> + <refnamediv> + <refname>weekday</refname> + <refpurpose>曜日を返す</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>呼び出し手順</title> + <synopsis>[N,S] = weekday(D) + [N,S] = weekday(D, form) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>説明</title> + <para>[N,S] = weekday(D) は, + 日数 n または日付文字列Dで指定すると, + 数値(N) および文字列(S)形式で曜日を返します. + 入力引数 D は,日数の配列で複数の日を表すことができます. + </para> + <para>[N,S] = weekday(D, form) は, + 数値(N) および文字列(S)形式で曜日を返しますが, + S の内容は form 引数に依存します. + form が 'long'の場合, S には完全な曜日 (例: Thuesday)が含まれます. + form が 'short'の場合, S には短縮形 (例: Tue) が含まれます. + </para> + </refsection> + <refsection> + <title>例</title> + <programlisting role="example"><![CDATA[ +today = datenum(); +[N,S] = weekday(today) +[N,S] = weekday(today,'short') +[N,S] = weekday(today,'long') + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>参照</title> + <simplelist type="inline"> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="datevec">datevec</link> + </member> + <member> + <link linkend="weekday">weekday</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/pt_BR/addchapter.sce b/modules/time/help/pt_BR/addchapter.sce new file mode 100755 index 000000000..d2ac8ed97 --- /dev/null +++ b/modules/time/help/pt_BR/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Data e Hora",SCI+"/modules/time/help/pt_BR",%T); + diff --git a/modules/time/help/pt_BR/date.xml b/modules/time/help/pt_BR/date.xml new file mode 100755 index 000000000..a42810c04 --- /dev/null +++ b/modules/time/help/pt_BR/date.xml @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="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="date" xml:lang="en"> + <refnamediv> + <refname>date</refname> + <refpurpose>retorna string contendo a data corrente</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>dt=date()</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>dt</term> + <listitem> + <para>a string</para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para>dt=date() retorna um string contendo a data no formato + dd-mmm-yyyy. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +date() + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="getdate">getdate</link> + </member> + <member> + <link linkend="toc">toc</link> + </member> + <member> + <link linkend="tic">tic</link> + </member> + <member> + <link linkend="timer">timer</link> + </member> + <member> + <link linkend="etime">etime</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/pt_BR/etime.xml b/modules/time/help/pt_BR/etime.xml new file mode 100755 index 000000000..ff10e1f6c --- /dev/null +++ b/modules/time/help/pt_BR/etime.xml @@ -0,0 +1,113 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="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="etime" xml:lang="en"> + <refnamediv> + <refname>etime</refname> + <refpurpose>tempo decorrido</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>e = etime(t2,t1)</synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>t2</term> + <listitem> + <para>um vetor com 6 ou 10 valores </para> + </listitem> + </varlistentry> + <varlistentry> + <term>t1</term> + <listitem> + <para>um vetor com 6 ou 10 valores </para> + </listitem> + </varlistentry> + <varlistentry> + <term>e</term> + <listitem> + <para> + nmero de segundos entre <literal>t2</literal> e + <literal>t1</literal>. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <variablelist> + <varlistentry> + <term>t1 e t2 com 10 valores</term> + <listitem> + <para> + <literal>t2</literal> e <literal>t1</literal> devem ter o + mesmo formato retornado por <literal>getdate</literal>. Neste caso, + seus terceiro, quarto e quinto valores sero ignorados. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>t1 e t2 com 6 valores</term> + <listitem> + <para> + <literal>t2</literal> e <literal>t1</literal> devem ter o + mesmo formato: T = [Ano Ms Dia Hora Minuto Segundo] com Segundo o + nmero de segundos com milisegundos (ex.: 12.345). + </para> + </listitem> + </varlistentry> + </variablelist> + <para> + <literal>t2</literal> e <literal>t1</literal> devem ter o mesmo + tamanho. + </para> + <para> + <literal>t2</literal> e <literal>t1</literal> podem ser matrizes com + cada linha contendo o formato descrito acima (todas as linhas tendo o + mesmo formato). + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +t1=[2004 06 10 17 00 12.345] +t2=[2004 06 10 17 01 13.965] +E1=etime(t2,t1) +t1=[2004 06 24 162 5 10 17 00 12 345] +t2=[2004 06 24 162 5 10 17 01 13 965] +E2=etime(t2,t1) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="tic">tic</link> + </member> + <member> + <link linkend="toc">toc</link> + </member> + <member> + <link linkend="getdate">getdate</link> + </member> + <member> + <link linkend="datenum">datenum</link> + </member> + <member> + <link linkend="datevec">datevec</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/pt_BR/getdate.xml b/modules/time/help/pt_BR/getdate.xml new file mode 100755 index 000000000..cc757de3b --- /dev/null +++ b/modules/time/help/pt_BR/getdate.xml @@ -0,0 +1,163 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="en"> + <refnamediv> + <refname>getdate</refname> + <refpurpose>retorna informao sobre data e hora</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>dt=getdate() + x=getdate("s") + dt=getdate(x) + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</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>Descrio</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 nmero (com o sculo) entre 0000 e 9999. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>dt(2)</term> + <listitem> + <para>o ms do ano como um nmero entre 01 e 12. </para> + </listitem> + </varlistentry> + <varlistentry> + <term>dt(3)</term> + <listitem> + <para>o nmero da semana ISO 8601 como um nmero entre 01 e + 53. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>dt(4)</term> + <listitem> + <para>o dia Juliano do ano como um nmero entre 001 e 366. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>dt(5)</term> + <listitem> + <para>especifica o dia da semana como um nmero decimal entre + 1 e 7 , com 1 representando domingo. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>dt(6)</term> + <listitem> + <para>o dia do ms como um nmero entre 01 e 31. </para> + </listitem> + </varlistentry> + <varlistentry> + <term>dt(7)</term> + <listitem> + <para>a hora do dia como um nmero entre 00 e 23. </para> + </listitem> + </varlistentry> + <varlistentry> + <term>dt(8)</term> + <listitem> + <para>o minuto da hora como um nmero entre 00 e 59. </para> + </listitem> + </varlistentry> + <varlistentry> + <term>dt(9)</term> + <listitem> + <para>o segundo do minuto como um nmero entre 00 e 59.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>dt(10)</term> + <listitem> + <para>o milissegundo do segundo como um nmero entre 000 e + 999. + </para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + <varlistentry> + <term>x=getdate("s")</term> + <listitem> + <para>retorna um escalar com o nmero de segundos desde 01/01/1970, + 00:00 UTC (Conveno de Tempo Unix) + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>dt=getdate(x)</term> + <listitem> + <para>pe a data dada por x (nmero 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,Ms:%d,Dia:%d",w(1),w(2),w(6)); + +x=getdate("s") +getdate(x) + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="date">date</link> + </member> + <member> + <link linkend="timer">timer</link> + </member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/pt_BR/tic.xml b/modules/time/help/pt_BR/tic.xml new file mode 100755 index 000000000..f3ffcfbc8 --- /dev/null +++ b/modules/time/help/pt_BR/tic.xml @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="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="tic" xml:lang="en"> + <refnamediv> + <refname>tic</refname> + <refpurpose>inicia um cronmetro</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>tic()</synopsis> + </refsynopsisdiv> + <refsection> + <title>Descrio</title> + <para> + A seqncia de comando <literal>tic(); operation; toc();</literal> + imprime o nmero de segundos requeridos para a operao. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +tic(); +realtimeinit(1); +realtime(0); +realtime(10); +toc(); + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="toc">toc</link> + </member> + <member> + <link linkend="timer">timer</link> + </member> + <member> + <link linkend="etime">etime</link> + </member> + </simplelist> + </refsection> + <refsection> + <title>Autores</title> + <simplelist type="vert"> + <member>V.C.</member> + <member>A.C.</member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/pt_BR/toc.xml b/modules/time/help/pt_BR/toc.xml new file mode 100755 index 000000000..4de412eaf --- /dev/null +++ b/modules/time/help/pt_BR/toc.xml @@ -0,0 +1,75 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab + * Copyright (C) INRIA - + * + * This file must be used under the terms of the CeCILL. + * This source file is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at + * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + * + --> +<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="toc" xml:lang="en"> + <refnamediv> + <refname>toc</refname> + <refpurpose>l o cronmetro</refpurpose> + </refnamediv> + <refsynopsisdiv> + <title>Seqncia de Chamamento</title> + <synopsis>toc() + t = toc() + </synopsis> + </refsynopsisdiv> + <refsection> + <title>Parmetros</title> + <variablelist> + <varlistentry> + <term>t</term> + <listitem> + <para>nmero de segundos desde a ltima chamada a + <literal>tic()</literal> (preciso em ordem de milissegundos) + </para> + </listitem> + </varlistentry> + </variablelist> + </refsection> + <refsection> + <title>Descrio</title> + <para> + A seqncia de comandos <literal>tic(); operation; toc();</literal> + imprime o nmero de segundos requeridos para a operao. + </para> + </refsection> + <refsection> + <title>Exemplos</title> + <programlisting role="example"><![CDATA[ +tic(); +realtimeinit(1); +realtime(0); +realtime(10); +toc(); + ]]></programlisting> + </refsection> + <refsection role="see also"> + <title>Ver Tambm</title> + <simplelist type="inline"> + <member> + <link linkend="tic">tic</link> + </member> + <member> + <link linkend="timer">timer</link> + </member> + <member> + <link linkend="etime">etime</link> + </member> + </simplelist> + </refsection> + <refsection> + <title>Autores</title> + <simplelist type="vert"> + <member>V.C.</member> + <member>A.C.</member> + </simplelist> + </refsection> +</refentry> diff --git a/modules/time/help/ru_RU/addchapter.sce b/modules/time/help/ru_RU/addchapter.sce new file mode 100755 index 000000000..aa6b02c55 --- /dev/null +++ b/modules/time/help/ru_RU/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Time and Date",SCI+"/modules/time/help/ru_RU",%T); + |