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 This file is part of systemd.
10 Copyright 2010 Lennart Poettering
11 Copyright 2012 Shawn Landden
14 <refentry id=
"localtime">
16 <title>localtime
</title>
17 <productname>systemd
</productname>
21 <contrib>Developer
</contrib>
22 <firstname>Lennart
</firstname>
23 <surname>Poettering
</surname>
24 <email>lennart@poettering.net
</email>
27 <contrib>Developer
</contrib>
28 <firstname>Shawn
</firstname>
29 <surname>Landden
</surname>
30 <email>shawnlandden@gmail.com
</email>
36 <refentrytitle>localtime
</refentrytitle>
37 <manvolnum>5</manvolnum>
41 <refname>localtime
</refname>
42 <refpurpose>Local timezone configuration file
</refpurpose>
46 <para><filename>/etc/localtime
</filename> -
> <filename>../usr/share/zoneinfo/…
</filename></para>
50 <title>Description
</title>
52 <para>The
<filename>/etc/localtime
</filename> file configures the
53 system-wide timezone of the local system that is used by
54 applications for presentation to the user. It should be an
55 absolute or relative symbolic link pointing to
56 <filename>/usr/share/zoneinfo/
</filename>, followed by a timezone
57 identifier such as
<literal>Europe/Berlin
</literal> or
58 <literal>Etc/UTC
</literal>. The resulting link should lead to the
60 <citerefentry project='man-pages'
><refentrytitle>tzfile
</refentrytitle><manvolnum>5</manvolnum></citerefentry>
61 timezone data for the configured timezone.
</para>
63 <para>Because the timezone identifier is extracted from the
64 symlink target name of
<filename>/etc/localtime
</filename>, this
65 file may not be a normal file or hardlink.
</para>
67 <para>The timezone may be overridden for individual programs by
68 using the
<varname>$TZ
</varname> environment variable. See
69 <citerefentry project='man-pages'
><refentrytitle>environ
</refentrytitle><manvolnum>7</manvolnum></citerefentry>.
</para>
72 <citerefentry><refentrytitle>timedatectl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
73 to change the settings of this file from the command line during
75 <citerefentry><refentrytitle>systemd-firstboot
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
76 to initialize the time zone on mounted (but not booted) system
81 <title>See Also
</title>
83 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
84 <citerefentry project='man-pages'
><refentrytitle>tzset
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
85 <citerefentry><refentrytitle>localtime
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
86 <citerefentry><refentrytitle>timedatectl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
87 <citerefentry><refentrytitle>systemd-timedated.service
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
88 <citerefentry><refentrytitle>systemd-firstboot
</refentrytitle><manvolnum>1</manvolnum></citerefentry>