---
name: "pmusezone"
section: "3"
platform: "linux"
package: "libpcp3-dev"
version: "4.3.2+really4.3.1-0.1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://carta.tech/man/pmUseZone"
---

# pmusezone(3)

re-establish a reporting timezone

Part of [pmUseZone(3)](/man/pmUseZone/3.md).

## NAME

**pmUseZone** - re-establish a reporting timezone

## C SYNOPSIS

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

**int pmUseZone(const int** *tz\_handle***);**

**cc ... -lpcp**

## DESCRIPTION

The current reporting timezone effects the timezone used by [**pmCtime**(3)](/man/pmCtime/3.md) and [**pmLocaltime**(3)](/man/pmLocaltime/3.md).

The argument *tz\_handle* identifies a reporting timezone as previously established by a call to [**pmNewZone**(3)](/man/pmNewZone/3.md) or [**pmNewContextZone**(3)](/man/pmNewContextZone/3.md), and this becomes the current reporting timezone.

## SEE ALSO

[**PMAPI**(3)](/man/PMAPI/3.md), [**pmCtime**(3)](/man/pmCtime/3.md), [**pmLocaltime**(3)](/man/pmLocaltime/3.md), [**pmNewContextZone**(3)](/man/pmNewContextZone/3.md), [**pmNewZone**(3)](/man/pmNewZone/3.md) and [**pmWhichZone**(3)](/man/pmWhichZone/3.md).

## DIAGNOSTICS

A return value less than zero indicates the value of *tz\_handle* is not legal.