# react-native-timezone

> A Simple react native module to get Timezone and Region of the Android/iOS devices.

Latest version **3.2.1** (published 2026-02-07) · MIT license · 0 weekly downloads

## Install

```sh
npm install react-native-timezone
pnpm add react-native-timezone
yarn add react-native-timezone
bun add react-native-timezone
```

## Health

**Score 50/100 (C)** — status: stable.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 3.2.1 |
| Published | 2026-02-07 |
| First published | 2019-10-18 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 51 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 47 |
| Author | Samitha Nanayakkara |
| Maintainers | samitha9125 |

## Links

- npm: https://www.npmjs.com/package/react-native-timezone
- Repository: https://github.com/samitha9125/react-native-timezone
- Homepage: https://github.com/samitha9125/react-native-timezone#readme
- Issues: https://github.com/samitha9125/react-native-timezone/issues
- npm.io page: https://npm.io/package/react-native-timezone

## Recent versions

- 3.2.1 (latest) — 2026-02-07
- 3.2.0 — 2026-02-01
- 3.1.0 — 2024-12-14
- 3.0.1 — 2023-12-11
- 2.3.0 — 2023-04-22
- 2.2.0 — 2023-03-11
- 2.1.1 — 2023-01-10
- 2.1.0 — 2022-11-28
- 2.0.0 — 2021-07-21
- 1.0.3 — 2020-01-23
- 1.0.2 — 2020-01-02
- 1.0.1 — 2019-10-18
- 1.0.0 — 2019-10-18

## README

# React Native Timezone

Fast, privacy-first timezone and country detection for React Native with zero extra permissions.

`react-native-timezone` gives you:
- Current timezone ID
- Best current country from telephony (network-first, then SIM fallback)
- Locale country fallback
- Android auto-timezone setting status

## Why this package

### Privacy-first
No location permission and no `READ_PHONE_STATE` needed.

### Native + fast
TurboModule implementation with synchronous reads for simple integration.

### Expo development builds ready
Works with Expo prebuild/dev-client workflows.

### Lightweight
Measured from the v3.2.1 package (February 7, 2026):
- Publish tarball: **~13.2 KB** (varies slightly between pack runs)
- Installed package contents (unpacked): **52,165 bytes** (~51.0 KB)
- JS runtime payload (CommonJS entry used by Metro): **1,288 bytes raw**, **706 bytes gzip**

## Compatibility

| React Native | New Architecture | Status |
| --- | --- | --- |
| >= 0.71.0 | Supported | Compatible |
| 0.76.x | Default New Arch | Verified in this repo |
| 0.81.x | Default New Arch | Verified in example app |

## iOS note on telephony APIs

Apple has deprecated `CTCarrier` APIs with no direct replacement. This can make telephony country unavailable on newer iOS versions, depending on device/network/privacy behavior.

Recommended pattern:

```ts
const bestCountry =
  Timezone.getRegionByTelephony() ?? Timezone.getRegionByLocale();
```

## Installation

```bash
yarn add react-native-timezone
```

For iOS:

```bash
npx pod-install
```

## Expo (development builds)

```bash
npx expo install react-native-timezone
npx expo prebuild
npx expo run:ios
```

## Usage

```tsx
import { useEffect } from 'react';
import Timezone from 'react-native-timezone';

export default function App() {
  useEffect(() => {
    const timezone = Timezone.getTimeZone();
    const isAutoTimeZoneEnabled = Timezone.isAutoTimeZoneEnabled();
    const telephonyRegion = Timezone.getRegionByTelephony();
    const localeRegion = Timezone.getRegionByLocale();
    const bestCountry = telephonyRegion ?? localeRegion;

    console.log({
      timezone,
      isAutoTimeZoneEnabled,
      telephonyRegion,
      localeRegion,
      bestCountry,
    });
  }, []);

  return null;
}
```

See the [example app](https://github.com/samitha9125/react-native-timezone/tree/master/example).

## API

| API | Description |
| --- | --- |
| `getTimeZone()` | Returns current timezone ID (for example `Asia/Colombo`, `Europe/Berlin`). |
| `isAutoTimeZoneEnabled()` | Android only. Returns `true` or `false`; returns `null` on iOS. |
| `getRegionByTelephony()` | Returns best current telephony country (network-first, then SIM fallback) as uppercase ISO code (for example `LK`, `US`) or `null`. |
| `getRegionByLocale()` | Returns locale country as uppercase ISO code (for example `LK`, `US`) or `null`. |

---
_Source: https://npm.io/package/react-native-timezone · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._