View Source: TimeNotes - Waikato Linux Users Group

You are viewing an old revision of this page. View the current version.
[Unix] systems and cousins traditionally store times as [UTC], and convert them according to the local timezone settings only for display. On a typical [Linux] machine, <tt>/etc/timezone</tt> contains the time zone (such as <tt>Pacific/Auckland</tt>), and <tt>/etc/localtime</tt> is a SymLink to a binary file containing information on the standard and the daylight savings offset of that time zone, as well instructions on how to calculate when daylight savings is in effect. In the above-mentioned example it might look like this:

 <pre>
 __$__ ls -l /etc/localtime
 lrwxrwxrwx    1 root    root    33 Apr 22 00:19 __/etc/localtime__ -> __/usr/share/zoneinfo/Pacific/Auckland__
 </pre>

The SuperUser can use [tzselect(8)] to change these settings. ''Make sure'' it is set correctly! If you have it set to [UTC] your system time will not reflect your localtime. [ntpdate(8)] will set the system clock correctly, but the hardware clock will get confused. You can compare these by looking at the output of [date(1)] and [hwclock(8)].

On [Debian] systems <tt>/etc/default/rcS</tt> contains a <tt>UTC</tt> variable that decides whether or not the hardware clock is set to [UTC].

On [SUSE] systems, <tt>/etc/sysconfig/clock</tt> defines a <tt>HWCLOCK</tt> variable that specifies the command-line option [hwclock(8)] for selecting the clock offset: <tt>-u</tt> for [UTC], or <tt>--localtime</tt> for local time.

On [RedHat] systems, <tt>/etc/sysconfig/clock</tt> defines the <tt>UTC</tt> variable as either <tt>UTC=true</tt> if the hardware clock is in UTC, or <tt>UTC=false</tt> if it is in local time.

Having the hardware clock set to [UTC] is [A Good Idea|BadIdea], because it avoids the need to adjust the clock forward or backward an hour when daylight saving goes on or off. There is no standard, ''reliable'' way of recognizing whether the hardware clock has been set for daylight saving or not; hence it is possible, particularly if your machine boots more than one OperatingSystem and you switch between them at the wrong time, for the adjustment to be done twice, or not at all. However, you might be forced to have your hardware clock set to local time in order to maintain compatibility with another OperatingSystem that fiddles with your hardware clock for daylight saving.

See [UTC] and [NTP] for more.

The internal representation of [UTC] time that all Unix systems use is often known as the Unix timestamp. This value is defined as the number of seconds since 00:00.00 01-01-1970. This value is always stored in [UTC] and when displayed is adjusted via your time zone to display your local time.

----

!! How to accomplish some simple tasks

Get the Unix timestamp for the current time::

  Try one of the following:

  <verbatim>
  date +%s
  perl -e 'print time() . "\n"'
  </verbatim>

See a human readable time for a given timestamp::

  Try one of the following:

  <pre>
  date --date="1970-01-01 ''<unix timestamp>'' secs UTC"
  perl -e 'print localtime( ''<unix timestamp>'' ) . "\n"'
  perl -e 'print gmtime( ''<unix timestamp>'' ) . "\n"' # for UTC
  /usr/lib/news/bin/convdate -c ''<unix timestamp>''
  </pre>

Convert a time in localtime to a Unix timestamp::

  <pre>
  /usr/lib/news/bin/convdate -n ''<date string>''
  </pre>

  (<tt>convdate</tt> is part of the <tt>inn</tt> package.)

Or using the date command::

  <pre>
  date --date="<date> <time> UTC" +%s
  </pre>

Or use the mktime(3) function available in various programming languages.

  <verbatim>
  <?php
  $ts = mktime(11, 49, 00, 10, 17, 2004);
  echo strftime("%Y-%m-%d %H:%M:%S %Z<br>", $ts);
  putenv("TZ=UTC");
  echo strftime("%Y-%m-%d %H:%M:%S %Z<br>", $ts);
  ?>
  </verbatim>

If you run this script you'll get output like this (depending on the TimeZone of your server)

    <verbatim>
    2004-10-17 11:49:00 NZDT
    2004-10-16 22:49:00 UTC
    </verbatim>

Find the current time/date for somewhere::

  A really simple way is to set the <tt>TZ</tt> EnvironmentVariable to the timezone you're interested in, then run [date(1)]:

  <verbatim>
  TZ=Pacific/Auckland date
  </verbatim>

Here the value of TZ is a filename path; if it doesn' begin with a <tt>/</tt>, then it is interpreted relative to the <tt>/usr/share/zoneinfo</tt> directory (on most Linux distros). Multiple files in this directory with the same contents give different ways of specifying the same time zone; thus <tt>NZ</tt> is a synonym for <tt>Pacific/Auckland</tt>.

Note that setting <tt>TZ</tt> in this way can also be used on other commands that show dates/times, such as [ls(1)], the abovementioned <tt>perl</tt> and <tt>convdate</tt> examples etc.
----

Excerpt from comp.risks 22.94:

> Motorola reports that several [GPS] receivers in its Oncore line will misdisplay the date on 28 Nov 2003 at midnight UTC. For a one-second window the receivers will mistakenly report the date as 29 Nov instead of 28 Nov.
>
> Here's why. Every couple of years or so for the past three decades, the International Earth Rotation Service has announced a leap-second because the Earth is rotating slightly more slowly than an 86400-second day would suggest.  But since 1 Jan 1999, we've had an unusually long dry spell without any leap seconds.  The GPS week number in the UTC correction parameter is 8 bits long, which allows for 256 weeks of unambiguous time calculation.  Until now this parameter has never rolled over, but because of the dry spell 28 Nov will be exactly 256 weeks after the most recent leap second, and the rollover will contribute to the bug. [http://www.motorola.com/ies/GPS/docs_pdf/notification_oncore.pdf]
>
> Steve Allen writes in [http://www.ucolick.org/~sla/leapsecs/onlinebib.html] that some JDAM smart bombs and other munitions are rumored to contain these receivers.  Anyone intending to use those weapons around the magic window might want to reschedule their bombing runs for some other time...


[Critical and Significant Dates|http://www.merlyn.demon.co.uk/critdate.htm] contains some interesting dates useful for testing, and also an interesting read.
----
!!Time Hilarity:
The conversion from Julian to Gregorian Calendar:
<verbatim>
 $ cal 1752
</verbatim>

London during the blitz:
<verbatim>
 $ zdump -v Europe/London | grep 194[0-9]
</verbatim>

----
See also [NTPNotes]
----
CategoryNotes
6 pages link to TimeNotes:
Version 24, saved on Tuesday, December 21, 2010 7:56:39 am by PerryLorier
Edit PageHistory Diff Info LikePages