---
name: "pmiSetTimezone"
section: "3"
platform: "linux"
package: "pcp"
version: "7.2.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pmiSetTimezone"
---

# pmiSetTimezone(3)

set the source timezone for a LOGIMPORT archive

## NAME

**pmiSetTimezone**, **pmiSetZoneinfo** - set the source timezone for a LOGIMPORT archive

## C SYNOPSIS

**#include \<pcp/pmapi.h\>**\
 **#include \<pcp/import.h\>**

**int pmiSetTimezone(const char \****value***);**\
 **int pmiSetZoneinfo(const char \****value***);**

**cc ... -lpcp\_import -lpcp**

## Perl SYNOPSIS

**use PCP::LogImport;**

**pmiSetTimezone($***value***);**

## Python SYNOPSIS

**from pcp import pmi**

**log.pmiSetTimezone(***value***)**

## DESCRIPTION

As part of the Performance Co-Pilot Log Import API (see [**LOGIMPORT**(3)](/LOGIMPORT/3.md)), **pmiSetTimezone** sets the POSIX timezone string in the current context to *value*, which is stored in the archive label. In the absence of a call to **pmiSetTimezone** the source timezone defaults to the timezone of the localhost.

**pmiSetZoneinfo** sets the Olson (tzdata) timezone name for the archive, providing higher-fidelity timezone information than the POSIX string alone. If *value* is NULL, **pmiSetZoneinfo** auto-detects the Olson name for the current local timezone from the system timezone database; if no Olson name can be determined the call is a silent no-op. Passing an explicit Olson name such as *America/New\_York* stores it directly without any lookup. The zoneinfo string is written into v3 archives alongside the POSIX timezone string.

## DIAGNOSTICS

Both functions return zero on success, or a negative value that can be turned into an error message by calling [**pmiErrStr**(3)](/pmiErrStr/3.md).

## SEE ALSO

[**LOGIMPORT**(3)](/LOGIMPORT/3.md), [**pmiErrStr**(3)](/pmiErrStr/3.md), [**pmiSetHostname**(3)](/pmiSetHostname/3.md), [**pmiSetVersion**(3)](/pmiSetVersion/3.md) and [**pmiStart**(3)](/pmiStart/3.md).