System time
In computer science and computer programming, system time represents a computer system's notion of the passing of time. In this sense, time also includes the passing of days on the calendar.
System time is measured by a system clock, which is typically implemented as a simple count of the number of ticks that have transpired since some arbitrary starting date, called the epoch. For example, Unix and POSIX-compliant systems encode system time as the number of seconds elapsed since the start of the Unix epoch at 1 January 1970 00:00:00 UT. Windows NT counts the number of 100-nanosecond ticks since 1 January 1601 00:00:00 UT as reckoned in the proleptic Gregorian calendar, but returns the current time to the nearest millisecond.
System time can be converted into calendar time, which is a form more suitable for human comprehension. For example, the Unix system time 1000000000 seconds since the beginning of the epoch translates into the calendar time 9 September 2001 01:46:40 UT. Library subroutines that handle such conversions may also deal with adjustments for timezones, Daylight Saving Time (DST), leap seconds, and the user's locale settings. Library routines are also generally provided that convert calendar times into system times.
Other time measurements
Closely related to system time is process time, which is a count of the total CPU time consumed by an executing process. It may be split into user and system CPU time, representing the time spent executing user code and system kernel code, respectively. Process times are a tally of CPU instructions or clock cycles and generally have no direct correlation to wall time.
File systems keep track of the times that files are created, modified, and/or accessed by storing timestamps in the file control block (or inode) of each file and directory.
History
Most first-generation PCs did not keep track of dates and times. These included systems that ran the CP/M operating system, early models of the Apple II, and the Commodore PET, among others. The IBM PC was the first widely available personal computer that came equipped with date/time hardware built into the motherboard, and subsequent add-on peripheral boards included real-time clock chips with on-board battery back-up. Prior to the widespread availability of computer networks, most personal computer systems that did track system time did so only with respect to local time and did not make allowances for other time zones.
With current technology, all modern computers keep track of local civil time, as do many other household and personal devices such as VCRs, DVRs, cable TV receivers, PDAs, pagers, cell phones, fax machines, telephone answering machines, cameras, camcorders, central air conditioners, and microwave ovens.
Retrieving system time
The following tables illustrate methods for retrieving the system time in various operating systems, programming languages, and applications.
Note: values marked by (*) are system-dependent and may differ across implementations.
All dates are given as Gregorian calendar or proleptic Gregorian calendar dates.
Operating systems
Operating system | Command or function | Resolution | Epoch or range |
---|---|---|---|
BIOS (IBM PC) | INT 1Ah,AH=00h[1] | 54.931 ms 18.204 Hz |
Midnight of the current day |
INT 1Ah,AH=02h[1] | 1 s | 1 January 1980 | |
DOS (Microsoft) | TIME INT 21h,AH=2Ch[1] |
10 ms | 1 January 1980 to 31 December 2099 |
Mac OS (Apple) | CFAbsoluteTimeGetCurrent()[2] | < 1 ms [3][note 1] | 1 January 2001 ±10,000 years[3][note 1] |
OpenVMS (HP) | SYS$GETTIM() | 100 ns | 17 November 1858 to AD 31,086 |
z/OS (IBM) | STCK[4] | 2−12 μs 244.14 ps[5] |
1 January 1900 to 17 September 2042 UT[6] |
Unix, POSIX | () |
1 s | (*) 1 January 1970 to 19 January 2038 1 January 1970 to AD 292,277,026,596 |
() | 1 μs | ||
Windows (Microsoft) | GetSystemTime() | 1 ms | 1 January 1601 to AD 30,828 |
GetSystemTimeAsFileTime() | 100 ns |
Programming languages and applications
Language/Application | Function or variable | Resolution | Epoch or range |
---|---|---|---|
Ada | Ada.Calendar.Clock | 100 μs to 20 ms (*) |
1 January 1901 to 31 December 2099 (*) |
AWK | systime() | 1 s | (*) |
BASIC, True BASIC | DATE, DATE$ TIME, TIME$ |
1 s | (*) |
Business BASIC | DAY, TIM | 0.1 s | (*) |
C | time() | 1 s (*)[note 2] | (*)[note 2] |
C++ | std::time() | 1 s (*)[note 2] | (*)[note 2] |
C# (Microsoft) | System.DateTime.Now[7] System.DateTime.UtcNow[8] |
100 ns [9] | 1 January 1 to 31 December 9999 |
CICS (IBM) | ASKTIME | 1 ms | 1 January 1900 |
COBOL | FUNCTION CURRENT-DATE | 1 s | 1 January 1601 |
Common Lisp | (get-universal-time) | 1 s | 1 January 1900 |
Delphi (Borland) | date time |
1 ms (floating point) |
1 January 1900 |
Excel (Microsoft) | date() | ? | 0 January 1900[10] |
Fortran | DATE_AND_TIME SYSTEM_CLOCK |
(*)[11][12] | 1 January 1970 |
CPU_TIME | 1 μs | ||
Haskell | Time.getClockTime | 1 μs (*) | 1 January 1970 (*) |
Java (Sun) | java.util.Date() System.currentTimeMillis() |
1 ms | 1 January 1970 |
System.nanoTime()[13] | 1 ns | arbitrary [13] | |
JavaScript | Date() | 1 ms | 1 January 1970 |
MUMPS | $H (short for $HOROLOG) | 1 s | 31 December 1840 |
Objective-C | [NSDate timeIntervalSinceReferenceDate] | < 1 ms[14] | 1 January 2001 ±10,000 Years[14] |
Objective Caml | Unix.time () | 1 s | 1 January 1970 |
Unix.gettimeofday () | 1 μs | ||
Extended Pascal | GetTimeStamp() | 1 s | (*) |
Turbo Pascal | GetTime() GetDate() |
10 ms | (*) |
Perl | time() | 1 s | 1 January 1970 |
Time::HiRes::time[15] | 1 μs | ||
PHP | time() mktime() |
1 s | 1 January 1970 |
microtime() | 1 μs | ||
Python | time.time() | 1 μs (*) | 1 January 1970 |
RPG | CURRENT(DATE), %DATE CURRENT(TIME), %TIME |
1 s | 1 January 0001 to 31 December 9999 |
CURRENT(TIMESTAMP), %TIMESTAMP | 1 μs | ||
Ruby | Time.now()[16] | 1 μs (*) | 1 January 1970 (to 19 January 2038 prior to Rails 1.9.2[17]) |
Smalltalk | Time microsecondClock (VisualWorks) |
1 s (ANSI) 1 μs (VisualWorks) 1 s (Squeak) |
1 January 1901 (*) |
Time totalSeconds (Squeak) | |||
SystemClock ticksNowSinceSystemClockEpoch (Chronos) | |||
SQL | CURDATE() CURTIME() GETDATE() NOW() SYSDATE() |
3 ms | 1 January 1753 to 31 December 9999 (*) |
60 s | 1 January 1900 to 6 June 2079 | ||
Standard ML | Time.now () | 1 μs (*) | 1 January 1970 (*) |
TCL | [clock seconds] | 1 s | 1 January 1970 |
[clock milliseconds] | 1 ms | ||
[clock microseconds] | 1 μs | ||
[clock clicks] | 1 μs (*) | (*) | |
Windows PowerShell | Get-Date[18] | 100 ns [9] | 1 January 1 to 31 December 9999 |
[DateTime]::Now[7] [DateTime]::UtcNow[8] | |||
Visual Basic .NET (Microsoft) | System.DateTime.Now[7] System.DateTime.UtcNow[8] |
100 ns [9] | 1 January 1 to 31 December 9999 |
Notes
- ^ a b The Apple Developer Documentation is not clear on the precision & range of CFAbsoluteTime/CFTimeInterval, except in the CFRunLoopTimerCreate documentation which refers to 'sub-millisecond at most' precision. However, the similar type NSTimeInterval appears to be interchangeable, and has the precision and range listed.
- ^ a b c d The C standard library does not specify any specific resolution, epoch, range, or datatype for system time values. The C++ library encompasses the C library, so it uses the same system time implementation as C.
See also
|
References
- ^ a b c Ralf Brown's Interrupt List; online browsable version at [1]
- ^ Online reference at developer.apple.com
- ^ a b Online reference at developer.apple.com
- ^ z/Architecture Principles of Operation. (2007). Poughkeepsie, New York:International Business Machines. p. 7-187.
- ^ z/Architecture Principles of Operation. (2007). Poughkeepsie, New York:International Business Machines. p. 4-45, 4-46.
- ^ IBM intends to extend the date range on future systems beyond 2042. z/Architecture Principles of Operation. (2007). Poughkeepsie, New York:International Business Machines. p. 1-15, 4-45 to 4-47.
- ^ a b c System.DateTime.Now at microsoft.com
- ^ a b c System.DateTime.UtcNow at microsoft.com
- ^ a b c MSDN link to DateTime.Ticks [2]
- ^ "XL2000: Early Dates on Office Spreadsheet Component Differ from Excel". Microsoft. Retrieved 1 January 2010.
In the Microsoft Office Spreadsheet Component, the value 0 evaluates to the date December 30, 1899 and the value 1 evaluates to December 31, 1899. ... In Excel, the value 0 evaluates to January 0, 1900 and the value 1 evaluates to January 1, 1900.
- ^ "FORTRAN SYSTEM_CLOCK". Intel Corp. Retrieved 2011-05-10.
- ^ "FORTRAN SYSTEM_CLOCK — Time function". GNU.
- ^ a b System.nanoTime() method at java.sun.com
- ^ a b NSTimeInterval
- ^ Jarkko Hietaniemi / Time-HiRes - search.cpan.org
- ^ Time class at ruby-doc.org
- ^ Ruby 1.9.2 Release Notes
- ^ Get-Date
External links
- Critical and Significant Dates, J. R. Stockton (retrieved 1 September 2006)
- The BOOST Date/Time Library (C++)
- The Chronos Date/Time Library (Smalltalk)
- Joda Time, The Joda Date/Time Library (Java)
- The Perl DateTime Project (Perl)
- The Ruby Date/Time Library (Ruby)