Ns time - Revision history

Akhassin at 21:13, 14 June 2010

2010-06-14T21:13:57Z

Akhassin at 20:58, 14 June 2010

2010-06-14T20:58:47Z

Akhassin at 20:57, 14 June 2010

2010-06-14T20:57:16Z

Josephbui: Undo revision 5569 by Daniel (Talk)

2009-11-23T15:06:34Z

Undo revision 5569 by Daniel (Talk)

Akhassin at 00:43, 31 October 2009

2009-10-31T00:43:45Z

Akhassin at 00:38, 31 October 2009

2009-10-31T00:38:57Z

Vkurup: Reverted edit of 81.215.178.184, changed back to last version by Dossy

2006-03-15T21:44:14Z

Reverted edit of 81.215.178.184, changed back to last version by Dossy

Show changes

81.215.178.184 at 20:22, 15 March 2006

2006-03-15T20:22:45Z

Show changes

Dossy: formatting tweaks

2005-11-03T12:26:00Z

formatting tweaks

WikiSysop: imported from WiKit id 499

2004-06-14T13:24:37Z

imported from WiKit id 499

New page

Man page: http://aolserver.com/docs/tcl/ns_time.html

----

'''NAME'''

: ns_time - Perform various time-related functions

'''SYNOPSIS'''

: '''ns_time''' ''?option? ?arg arg ...?''

'''DESCRIPTION'''

: This command provides various time-related functions. The legal ''option''s (which may be abbreviated) are:
* '''ns_time adjust''' ''time''

: Adjusts ''time'' so that it is within the valid range of values for a time. ''(TODO: Figure out how this is actually useful.)''
* '''ns_time diff''' ''time1 time2''

: Computes the time difference between ''time1'' to ''time2''. It does this by subtracting ''time1'' from ''time2'' and returns a string in "sec:usec" format.
* '''ns_time get'''

: Returns the current time in "sec:usec" format.
* '''ns_time incr''' ''time sec ?usec?''

: Increments ''time'' by ''sec'' seconds and optionally ''usec'' microseconds. Returns a string in "sec:usec" format.
* '''ns_time make''' ''sec ?usec?''

: Returns a string in the form "sec:usec". ''usec'' defaults to zero. If ''usec'' is zero, the colon and ''usec'' are not returned. If ''sec'' is zero, however, it is returned as part of the time string.
* '''ns_time seconds''' ''time''

: Parses a time in "sec:usec" format and returns the seconds portion.
* '''ns_time microseconds''' ''time''

: Parses a time in "sec:usec" format and returns the microseconds portion. It assumes zero microseconds if ''time'' only contains seconds.

'''NOTES'''

: All times are relative to 00:00:00 UTC, January 1, 1970 aka the Unix epoch. '''ns_time''' called with no option returns the current time in seconds.

'''EXAMPLES'''

% ns_time
1087006685

% set time [[ns_time get]]
1087013247:598897

% ns_time seconds $time
1087013247

% ns_time microseconds $time
598897

% set time2 [[ns_time incr $time 5 30]]
1087013252:598927

% ns_set diff $time2 $time
5:30

% set time3 [[ns_time make 1087013240 598890]]
1087013240:598890

% ns_time diff $time $time3
7:7

% ns_time diff $time3 $time
-8:999993

% set time3 [[ns_time incr $time3 7 7]]
1087013247:598897

% ns_time diff $time $time3
0

'''SEE ALSO'''

: [[ns_fmttime]], [[ns_gmtime]], [[ns_httptime]], [[ns_localtime]], [[ns_parsehttptime]], [[ns_parsetime]]

----

[[Category Documentation]] - [[Category Core Tcl API]]

@@ Line 27: / Line 27: @@
 * '''ns_time incr''' ''time sec ?usec?''
-: Increments ''time'' by ''sec'' seconds and optionally ''usec'' microseconds.  Returns a string in "sec:usec" format.
+: Increments ''time'' by ''sec'' seconds and optionally ''usec'' microseconds.  Returns a string in "sec:usec" format.  Note that ns_time incr will result in negative seconds if given too large a value of microseconds (like an hour).  Use a proc like this to work around:
 <pre>
-    proc ns_time_frommicroseconds {microseconds} {
+    proc ns_time_incrmicroseconds {microseconds {time 0}} {
        set secondsList [split [expr {$microseconds/1000000.0}] .]
        set microseconds [expr int(0.[lindex $secondsList 1] * 1000000)]
-       return [ns_time make [lindex $secondsList 0] $microseconds]
+       return [ns_time incr $time [lindex $secondsList 0] $microseconds]
+    }
 </pre>
 * '''ns_time seconds''' ''time''

@@ Line 35: / Line 35: @@
     proc ns_time_frommicroseconds {microseconds} {
        set secondsList [split [expr {$microseconds/1000000.0}] .]
-       set microseconds [expr {int(0.[lindex $secondsList 1] * 1000000)}]
+       set microseconds [expr int(0.[lindex $secondsList 1] * 1000000)]
        return [ns_time make [lindex $secondsList 0] $microseconds]
+    }

@@ Line 31: / Line 31: @@
 * '''ns_time make''' ''sec ?usec?''
-: Returns a string in the form "sec:usec".  ''usec'' defaults to zero.  If ''usec'' is zero, the colon and ''usec'' are not returned.  If ''sec'' is zero, however, it is returned as part of the time string.
+: Returns a string in the form "sec:usec".  ''usec'' defaults to zero.  If ''usec'' is zero, the colon and ''usec'' are not returned.  If ''sec'' is zero, however, it is returned as part of the time string.  Note that ns_time make will generate negative seconds if given too large a value of microseconds (like an hour).  Use a proc like this to work around:
 * '''ns_time seconds''' ''time''

← Older revision	Revision as of 15:06, 23 November 2009
(No difference)

@@ Line 19: / Line 19: @@
 * '''ns_time diff''' ''time1 time2''
-: Computes the time difference between ''time1'' to ''time2''.  It does this by subtracting ''time1'' from ''time2'' and returns a string in "sec:usec" format.
+: Computes the time difference between ''time1'' and ''time2''.  It does this by subtracting ''time2'' from ''time1'' and returns a string in "sec:usec" format.  Put the later time first to get the proper result.
 * '''ns_time get'''

@@ Line 50: / Line 50: @@
      1087006685
-     % set time [[ns_time get]]
+     % set time [ns_time get]
      1087013247:598897
@@ Line 59: / Line 59: @@
-     % set time2 [[ns_time incr $time 5 30]]
+     % set time2 [ns_time incr $time 5 30]
      1087013252:598927
@@ Line 65: / Line 65: @@
 :30
-     % set time3 [[ns_time make 1087013240 598890]]
+     % set time3 [ns_time make 1087013240 598890]
      1087013240:598890
@@ Line 74: / Line 74: @@
      -8:999993
-     % set time3 [[ns_time incr $time3 7 7]]
+     % set time3 [ns_time incr $time3 7 7]
      1087013247:598897

@@ Line 1: / Line 1: @@
-Man page: http://aolserver.com/docs/tcl/ns_time.html
+<manpage>ns_time</manpage>
 '''NAME'''
@@ Line 14: / Line 12: @@
 : This command provides various time-related functions.  The legal ''option''s (which may be abbreviated) are:
 * '''ns_time adjust''' ''time''
 : Adjusts ''time'' so that it is within the valid range of values for a time.  ''(TODO:  Figure out how this is actually useful.)''
 * '''ns_time diff''' ''time1 time2''
 : Computes the time difference between ''time1'' to ''time2''.  It does this by subtracting ''time1'' from ''time2'' and returns a string in "sec:usec" format.
 * '''ns_time get'''
 : Returns the current time in "sec:usec" format.
 * '''ns_time incr''' ''time sec ?usec?''
 : Increments ''time'' by ''sec'' seconds and optionally ''usec'' microseconds.  Returns a string in "sec:usec" format.
 * '''ns_time make''' ''sec ?usec?''
 : Returns a string in the form "sec:usec".  ''usec'' defaults to zero.  If ''usec'' is zero, the colon and ''usec'' are not returned.  If ''sec'' is zero, however, it is returned as part of the time string.
 * '''ns_time seconds''' ''time''
 : Parses a time in "sec:usec" format and returns the seconds portion.
 * '''ns_time microseconds''' ''time''
@@ Line 79: / Line 84: @@
 : [[ns_fmttime]], [[ns_gmtime]], [[ns_httptime]], [[ns_localtime]], [[ns_parsehttptime]], [[ns_parsetime]]
-[[Category Documentation]] - [[Category Core Tcl API]]
+[[Category:Core Tcl API]]