Commit Graph

72 Commits

Author SHA1 Message Date
Eric Appelt 23557d59b8 bpo-29026: Clarify documentation of time.time (#34)
* bpo-29026: Clarity documentation of time.time

Clarify the documentation of time.time by more
precisely defining what is meant by "seconds since
the epoch" on most platforms. Additionally explain
how gmtime and localtime may be used to extract
calendar components and convert to a more common
date format.

* bpo-29026: Minor improvements for time.time doc

* bpo-29026: Consistency fixes for time.time doc
2017-02-16 11:00:45 +01:00
Alexander Belopolsky f810d041dc Closes #28130: Documented that time.tzset() updates time module globals.
Thanks Greg Bengeult for the patch.
2017-01-12 13:17:23 -05:00
Alexander Belopolsky 18f3a9b93c Closes #25283: Make tm_gmtoff and tm_zone available on all platforms. 2016-09-11 22:55:16 -04:00
Terry Jan Reedy 4da945f361 Merge Issue #22558. 2016-06-11 15:06:08 -04:00
Terry Jan Reedy fa089b9b0b Issue #22558: Add remaining doc links to source code for Python-coded modules.
Reformat header above separator line (added if missing) to a common format.
Patch by Yoni Lavi.
2016-06-11 15:02:54 -04:00
Senthil Kumaran 15777231e9 merge from 3.5
Issue21221 - Explain the usage of tm_isdst attribute of mktime, with valid
values and meaning.

Patch contributed by Andrew Scheller.
2016-01-03 00:45:05 -08:00
Senthil Kumaran 6ffbcdf13f merge from 3.4
Issue21221 - Explain the usage of tm_isdst attribute of mktime, with valid
values and meaning.

Patch contributed by Andrew Scheller.
2016-01-03 00:43:23 -08:00
Senthil Kumaran a880800363 Issue21221 - Explain the usage of tm_isdst attribute of mktime, with valid
values and meaning.

Patch contributed by Andrew Scheller.
2016-01-03 00:40:03 -08:00
Alexander Belopolsky 357cb986b2 Fixed typos in TZ format description 2015-08-28 16:56:45 -04:00
Victor Stinner 79d68f929d Issue #23646: If time.sleep() is interrupted by a signal, the sleep is now
retried with the recomputed delay, except if the signal handler raises an
exception (PEP 475).

Modify also test_signal to use a monotonic clock instead of the system clock.
2015-03-19 21:54:09 +01:00
Victor Stinner 0c2fd89777 Revert changeset d927047b1d8eb87738676980a24930d053ba2150
Sorry, it was a mistake, the patch is still under review: issue #23646.
2015-03-17 10:49:17 +01:00
Victor Stinner 945c82eea3 test 2015-03-12 16:19:01 +01:00
R David Murray 58f02019e0 Merge: #23215: note that time.sleep affects the current thread only. 2015-01-25 15:47:06 -05:00
R David Murray 1923b627b5 #23215: reflow paragraph. 2015-01-25 15:46:22 -05:00
R David Murray f1f9675b8a #23251: Note that time.sleep affects the calling thread only.
This change parallels the language used in the unix man page.
2015-01-25 15:45:14 -05:00
Georg Brandl 3fab2085b7 merge with 3.4 2014-10-28 21:35:42 +01:00
Georg Brandl 01546a88b8 Closes #22749: remove outdated advice to use clock() for accurate timing. 2014-10-28 21:35:35 +01:00
Victor Stinner ae58649721 Issue #22043: time.monotonic() is now always available
threading.Lock.acquire(), threading.RLock.acquire() and socket operations now
use a monotonic clock, instead of the system clock, when a timeout is used.
2014-09-02 23:18:25 +02:00
Serhiy Storchaka bfdcd436f0 Issue #18758: Fixed and improved cross-references. 2013-10-13 23:09:14 +03:00
Georg Brandl b7117af07d Refer to strftime(3) manpage for platform specific format codes.
Suggested by Skip Montanaro on docs@.
2013-10-13 18:28:25 +02:00
Terry Jan Reedy 41459a9b29 Issue #15940: Replace tab. 2013-04-03 12:45:24 -04:00
Terry Jan Reedy b5e2e7e93a Issue #15940: Specify effect of locale on time functions. 2013-04-03 12:34:57 -04:00
Ezio Melotti 99bafff7cc Fix typo noticed by Tom Lynn. 2012-11-05 22:22:48 +02:00
Andrew Svetlov 3934b61a16 Fix typo in documentation for time module, thanks to docs@ 2012-10-04 19:52:32 +03:00
Georg Brandl 61063cca6a Fix a couple of versionadded/versionchanged related markup errors. 2012-06-24 22:48:30 +02:00
Alexander Belopolsky 93c9cd07b6 Issue #9527: tm_gmtoff has 'correct' sign. 2012-06-22 16:04:19 -04:00
Alexander Belopolsky c142bba2a7 Issue #1667546: On platforms supporting tm_zone and tm_gmtoff fields
in struct tm, time.struct_time objects returned by time.gmtime(),
time.localtime() and time.strptime() functions now have tm_zone and
tm_gmtoff attributes.  Original patch by Paul Boddie.
2012-06-13 22:15:26 -04:00
Victor Stinner 2b89fdf7eb PEP 418: Rename adjusted attribute to adjustable in time.get_clock_info() result
Fix also its value on Windows and Linux according to its documentation:
"adjustable" indicates if the clock *can be* adjusted, not if it is or was
adjusted.

In most cases, it is not possible to indicate if a clock is or was adjusted.
2012-06-12 22:46:37 +02:00
Victor Stinner bda4b8802c time.get_clock_info() uses a namespace instead of structseq 2012-06-12 22:11:44 +02:00
Petri Lehtinen ed3639595a Fix time.time() references in the time module docs
Closes #14842.
2012-05-18 21:28:47 +03:00
Petri Lehtinen 1033b310a3 Fix time.time() references in the time module docs
Closes #14842.
2012-05-18 21:22:47 +03:00
Benjamin Peterson 49a69e4d48 strip is_ prefixes on clock_info fields 2012-05-01 09:38:34 -04:00
Georg Brandl 514880caae Review of doc changes re PEP 418. 2012-04-30 12:50:30 +02:00
Victor Stinner 47620a6611 Close #14309: Deprecate time.clock()
Use time.perf_counter() or time.process_time() instead.
2012-04-29 02:52:39 +02:00
Victor Stinner ec89539ccc Issue #14428, #14397: Implement the PEP 418
* Rename time.steady() to time.monotonic()
 * On Windows, time.monotonic() uses GetTickCount/GetTickCount64() instead of
   QueryPerformanceCounter()
 * time.monotonic() uses CLOCK_HIGHRES if available
 * Add time.get_clock_info(), time.perf_counter() and time.process_time()
   functions
2012-04-29 02:41:27 +02:00
Victor Stinner ca6e40f12a Time doc: documentation that the CLOCK_* constants and clock_*() functions are
not always available.
2012-04-28 23:47:33 +02:00
Victor Stinner 6125e232e2 Doc: sort time.CLOCK_xxx constants 2012-04-12 21:40:14 +02:00
Victor Stinner 30d79471bb Expose clock_settime() as time.clock_settime() 2012-04-03 00:45:07 +02:00
Victor Stinner 1470f35bc6 Add time.CLOCK_HIGHRES constant, needed on Solaris 2012-04-03 00:31:17 +02:00
Georg Brandl 909f5bc849 Fix newlines. 2012-03-29 09:18:14 +02:00
Victor Stinner 2bf1f3bee4 time.steady() doc: don't repeat the default value 2012-03-19 13:17:24 +01:00
R David Murray 7cc7033cb4 Merge #12758: removing confusing mention of UTC from time.time description
Patch by Dylan Sarber.

(Not sure why hg told me it merged pyexpat.c too, it showed no changes)
2012-03-15 03:09:53 -04:00
R David Murray 38c2754652 #12758: removing confusing mention of UTC from time.time description
Patch by Dylan Sarber.
2012-03-15 03:06:15 -04:00
Victor Stinner 071eca3f5c Issue #10278: Add an optional strict argument to time.steady(), False by default 2012-03-15 01:17:09 +01:00
Victor Stinner ec919cc74d Issue #10278: Drop time.monotonic() function, rename time.wallclock() to time.steady()
* On Mac OS X, time.steady() now uses mach_absolute_time(), a monotonic clock
 * Optimistic change: bet that CLOCK_MONOTONIC and CLOCK_REALTIME are available
   when clock_gettime() is available
 * Rewrite time.steady() documentation
2012-03-15 00:58:32 +01:00
Victor Stinner 0a786221d9 Issue #13846: Enhance time.monotonic() documentation 2012-02-24 00:10:45 +01:00
Victor Stinner 0f7888d453 Time module doc: Fix reST syntax 2012-02-14 02:42:21 +01:00
Victor Stinner 4195b5caea Backout f8409b3d6449: the PEP 410 is not accepted yet 2012-02-08 23:03:19 +01:00
Victor Stinner ccd5715a14 PEP 410 2012-02-08 14:31:50 +01:00
Victor Stinner 8b30201f7d Issue #13846: Add time.monotonic(), monotonic clock. 2012-02-07 23:29:46 +01:00