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+
9 <refentry id=
"localtime">
11 <title>localtime
</title>
12 <productname>systemd
</productname>
16 <refentrytitle>localtime
</refentrytitle>
17 <manvolnum>5</manvolnum>
21 <refname>localtime
</refname>
22 <refpurpose>Local timezone configuration file
</refpurpose>
26 <para><filename>/etc/localtime
</filename> -
> <filename>../usr/share/zoneinfo/…
</filename></para>
30 <title>Description
</title>
32 <para>The
<filename>/etc/localtime
</filename> file configures the
33 system-wide timezone of the local system that is used by
34 applications for presentation to the user. It should be an
35 absolute or relative symbolic link pointing to
36 <filename>/usr/share/zoneinfo/
</filename>, followed by a timezone
37 identifier such as
<literal>Europe/Berlin
</literal> or
38 <literal>Etc/UTC
</literal>. The resulting link should lead to the
40 <citerefentry project='man-pages'
><refentrytitle>tzfile
</refentrytitle><manvolnum>5</manvolnum></citerefentry>
41 timezone data for the configured timezone.
</para>
43 <para>Because the timezone identifier is extracted from the
44 symlink target name of
<filename>/etc/localtime
</filename>, this
45 file may not be a normal file or hardlink.
</para>
47 <para>The timezone may be overridden for individual programs by
48 using the
<varname>$TZ
</varname> environment variable. See
49 <citerefentry project='man-pages'
><refentrytitle>environ
</refentrytitle><manvolnum>7</manvolnum></citerefentry>.
</para>
52 <citerefentry><refentrytitle>timedatectl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
53 to change the settings of this file from the command line during
55 <citerefentry><refentrytitle>systemd-firstboot
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
56 to initialize the time zone on mounted (but not booted) system
61 <title>See Also
</title>
63 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
64 <citerefentry project='man-pages'
><refentrytitle>tzset
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
65 <citerefentry><refentrytitle>localtime
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
66 <citerefentry><refentrytitle>timedatectl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
67 <citerefentry><refentrytitle>systemd-timedated.service
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
68 <citerefentry><refentrytitle>systemd-firstboot
</refentrytitle><manvolnum>1</manvolnum></citerefentry>