====== Changing the Timezone ======

Changing the timezone may be required for the development of custom applications, in particular ones that display time. Due to unknown reasons, the reMarkable interaface does not expose a visible clock to the user.

===== Temporarily Changing The Timezone =====

To temporarily change the timezone for the current shell instance, you can set the TZ variable to the appropriate timezone 

<code>
$ TZ="CET"
$ date
Fri dec  8 10:38:50 CET 2017
</code>

**Note: The timezone change is restricted to the shell session in which it has been set. Attempting to retrieve the time outside of the current shell session will display the old timezone**

===== Permanently Changing The Timezone =====
==== timedatectl ====

Permanently changing your timezone is as simple as running the following:

<code>
timedatectl set-timezone <Zone/SubZone>
</code>

To see what timezones are available look at the contents of ''/usr/share/zoneinfo''

==== reZone script ====

The reZone script provided by the [[https://github.com/reHackable|reHackable organisation]] will update the reMarkable timezone according to the host machine.

Download the script

<code>
$ curl https://raw.githubusercontent.com/reHackable/scripts/master/host/rezone.sh -o rezone.sh
</code>

Finally execute the script. If you opt to connect to your device trough wireless instead of USB, you may provide the IP address as parameter

<code>
$ chmod +x rezone.sh
$ ./rezone.sh
</code>

If no issues were raised, the timezone has been changed and the script will confirm the success.

==== Manually Updating the Timezone ====

To update the timezone manually, the following line must be edited in ''/etc/profile''

<code>
TZ="UTC"           # Time Zone. Look at http://theory.uwinnipeg.ca/gnu/glibc/libc_303.html
</code>

To your new timezone (ie CET)
<code>
TZ="CET"           # Time Zone. Look at http://theory.uwinnipeg.ca/gnu/glibc/libc_303.html
</code>

After the line has been changed, save your changes. To confirm your new timezone, instance a new shell and execute ''date''.

<code>
$ bash
$ date
Fri dec  8 11:23:46 CET 2017
</code>