# react-tz

> A beautiful, clean and UX friendly timezone selector

Latest version **1.0.0** (published 2019-04-23) · MIT license · 0 weekly downloads

## Install

```sh
npm install react-tz
pnpm add react-tz
yarn add react-tz
bun add react-tz
```

## Health

**Score 20/100 (F)** — status: abandoned.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.0 |
| Published | 2019-04-23 |
| First published | 2019-04-23 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 286.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Mike Vercoelen |
| Maintainers | mikevercoelen |
| Keywords | react, timezone, picker, select, tz, react-tz |

## Links

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

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 1.0.0 (latest) — 2019-04-23

## README

# React-tz

An ultimate timezone picker for [React](https://reactjs.com). Built on top of [react-select](https://github.com/JedWatson/react-select), [moment-timezone](https://github.com/moment/moment-timezone) and using real timezone data from [timezone-db](https://timezonedb.com/) 

## Demo

[<img src="https://raw.githubusercontent.com/mikevercoelen/react-tz/master/usage.gif" class="logo" height="484" width="472"/>](http://mikevercoelen.github.io/react-tz/)


[mikevercoelen.github.io/react-tz](http://mikevercoelen.github.io/react-tz/)

## Requirements

You need to make sure you have these deps installed first:

- [react](https://reactjs.com) `^16.8.6`
- [react-select](https://github.com/JedWatson/react-select) `2.4.3^`
- [moment-timezone](https://github.com/moment/moment-timezone) `2.24.0^`

## Installation

```shell
npm install react-tz --save
```

With peer deps:

```shell
npm install react react-select moment-timezone react-tz --save
```

## Example

```js
import React, { useState } from 'react'
import { TimezoneSelect } from 'react-tz'

const Demo = () => {
  const [timezone, setTimezone] = useState(null)
  
  return (
    <TimezoneSelect
      value={timezone}
      onChange={setTimezone} />
  )
}

export default Demo
```

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