Mercurial > octave-nkf
annotate scripts/time/asctime.m @ 20595:c1a6c31ac29a
eliminate more simple uses of error_state
* ov-classdef.cc: Eliminate simple uses of error_state.
author | John W. Eaton <jwe@octave.org> |
---|---|
date | Tue, 06 Oct 2015 00:20:02 -0400 |
parents | 635c93bba6b6 |
children |
rev | line source |
---|---|
19731
4197fc428c7d
maint: Update copyright notices for 2015.
John W. Eaton <jwe@octave.org>
parents:
19627
diff
changeset
|
1 ## Copyright (C) 1995-2015 John W. Eaton |
2313 | 2 ## |
3 ## This file is part of Octave. | |
4 ## | |
5 ## Octave is free software; you can redistribute it and/or modify it | |
6 ## under the terms of the GNU General Public License as published by | |
7016 | 7 ## the Free Software Foundation; either version 3 of the License, or (at |
8 ## your option) any later version. | |
2313 | 9 ## |
10 ## Octave is distributed in the hope that it will be useful, but | |
11 ## WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
13 ## General Public License for more details. | |
14 ## | |
15 ## You should have received a copy of the GNU General Public License | |
7016 | 16 ## along with Octave; see the file COPYING. If not, see |
17 ## <http://www.gnu.org/licenses/>. | |
1183 | 18 |
3301 | 19 ## -*- texinfo -*- |
20 ## @deftypefn {Function File} {} asctime (@var{tm_struct}) | |
19627
446c46af4b42
strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents:
17744
diff
changeset
|
21 ## Convert a time structure to a string using the following |
20527
635c93bba6b6
doc: Make excplicit that asctime and ctime values end in a newline (bug #45976)
Mike Miller <mtmiller@octave.org>
parents:
20197
diff
changeset
|
22 ## format: @qcode{"ddd mmm mm HH:MM:SS yyyy@xbackslashchar{}n"}. |
20197
2645f9ef8c88
doc: Update more docstrings to have one sentence summary as first line.
Rik <rik@octave.org>
parents:
19731
diff
changeset
|
23 ## |
2645f9ef8c88
doc: Update more docstrings to have one sentence summary as first line.
Rik <rik@octave.org>
parents:
19731
diff
changeset
|
24 ## For example: |
3426 | 25 ## |
3301 | 26 ## @example |
27 ## @group | |
7097 | 28 ## asctime (localtime (time ())) |
20527
635c93bba6b6
doc: Make excplicit that asctime and ctime values end in a newline (bug #45976)
Mike Miller <mtmiller@octave.org>
parents:
20197
diff
changeset
|
29 ## @result{} "Mon Feb 17 01:15:06 1997@xbackslashchar{}n" |
3301 | 30 ## @end group |
31 ## @end example | |
3426 | 32 ## |
3301 | 33 ## This is equivalent to @code{ctime (time ())}. |
13856
d490ca8ab1a5
Modernize function implementations and docstrings in scripts/time.
Rik <octave@nomad.inbox5.com>
parents:
11523
diff
changeset
|
34 ## @seealso{ctime, localtime, time} |
3301 | 35 ## @end deftypefn |
1183 | 36 |
2314 | 37 ## Author: jwe |
38 | |
11469
c776f063fefe
Overhaul m-script files to use common variable name between code and documentation.
Rik <octave@nomad.inbox5.com>
parents:
10821
diff
changeset
|
39 function retval = asctime (tm_struct) |
1183 | 40 |
13856
d490ca8ab1a5
Modernize function implementations and docstrings in scripts/time.
Rik <octave@nomad.inbox5.com>
parents:
11523
diff
changeset
|
41 if (nargin != 1) |
6046 | 42 print_usage (); |
1183 | 43 endif |
44 | |
13856
d490ca8ab1a5
Modernize function implementations and docstrings in scripts/time.
Rik <octave@nomad.inbox5.com>
parents:
11523
diff
changeset
|
45 retval = strftime ("%a %b %d %H:%M:%S %Y\n", tm_struct); |
d490ca8ab1a5
Modernize function implementations and docstrings in scripts/time.
Rik <octave@nomad.inbox5.com>
parents:
11523
diff
changeset
|
46 |
1183 | 47 endfunction |
7411 | 48 |
13856
d490ca8ab1a5
Modernize function implementations and docstrings in scripts/time.
Rik <octave@nomad.inbox5.com>
parents:
11523
diff
changeset
|
49 |
7411 | 50 %!test |
51 %! t = time (); | |
14363
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
52 %! assert (strcmp (asctime (localtime (t)), ctime (t))); |
7411 | 53 |
20527
635c93bba6b6
doc: Make excplicit that asctime and ctime values end in a newline (bug #45976)
Mike Miller <mtmiller@octave.org>
parents:
20197
diff
changeset
|
54 %!assert (asctime (localtime (time ()))(end), "\n") |
635c93bba6b6
doc: Make excplicit that asctime and ctime values end in a newline (bug #45976)
Mike Miller <mtmiller@octave.org>
parents:
20197
diff
changeset
|
55 |
14363
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
56 %!error asctime () |
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
57 %!error asctime (1, 2) |
7411 | 58 |