1 <?xml version='
1.0'
?> <!--*-nxml-*-->
2 <!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
6 SPDX-License-Identifier: LGPL-2.1+
8 Copyright 2012 Shawn Landden
11 <refentry id=
"localtime">
13 <title>localtime
</title>
14 <productname>systemd
</productname>
18 <contrib>Developer
</contrib>
19 <firstname>Lennart
</firstname>
20 <surname>Poettering
</surname>
21 <email>lennart@poettering.net
</email>
24 <contrib>Developer
</contrib>
25 <firstname>Shawn
</firstname>
26 <surname>Landden
</surname>
27 <email>shawnlandden@gmail.com
</email>
33 <refentrytitle>localtime
</refentrytitle>
34 <manvolnum>5</manvolnum>
38 <refname>localtime
</refname>
39 <refpurpose>Local timezone configuration file
</refpurpose>
43 <para><filename>/etc/localtime
</filename> -
> <filename>../usr/share/zoneinfo/…
</filename></para>
47 <title>Description
</title>
49 <para>The
<filename>/etc/localtime
</filename> file configures the
50 system-wide timezone of the local system that is used by
51 applications for presentation to the user. It should be an
52 absolute or relative symbolic link pointing to
53 <filename>/usr/share/zoneinfo/
</filename>, followed by a timezone
54 identifier such as
<literal>Europe/Berlin
</literal> or
55 <literal>Etc/UTC
</literal>. The resulting link should lead to the
57 <citerefentry project='man-pages'
><refentrytitle>tzfile
</refentrytitle><manvolnum>5</manvolnum></citerefentry>
58 timezone data for the configured timezone.
</para>
60 <para>Because the timezone identifier is extracted from the
61 symlink target name of
<filename>/etc/localtime
</filename>, this
62 file may not be a normal file or hardlink.
</para>
64 <para>The timezone may be overridden for individual programs by
65 using the
<varname>$TZ
</varname> environment variable. See
66 <citerefentry project='man-pages'
><refentrytitle>environ
</refentrytitle><manvolnum>7</manvolnum></citerefentry>.
</para>
69 <citerefentry><refentrytitle>timedatectl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
70 to change the settings of this file from the command line during
72 <citerefentry><refentrytitle>systemd-firstboot
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
73 to initialize the time zone on mounted (but not booted) system
78 <title>See Also
</title>
80 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
81 <citerefentry project='man-pages'
><refentrytitle>tzset
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
82 <citerefentry><refentrytitle>localtime
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
83 <citerefentry><refentrytitle>timedatectl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
84 <citerefentry><refentrytitle>systemd-timedated.service
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
85 <citerefentry><refentrytitle>systemd-firstboot
</refentrytitle><manvolnum>1</manvolnum></citerefentry>