funkydev / windows-iana

A small tool to convert Windows time zones to IANA

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Build Status Coverage Status

This library exports two functions to help convert from Windows time zones to IANA time zones (based on this mapping definition and this list of IANA aliases).

Installation

Add the dependency to your project with npm install --save windows-iana or yarn add windows-iana.

Usage

The library exports:

  • findIana(): will return an array of possible IANA time zones, including all their aliases.
  • findOneIana(): will return just one string.
  • findWindows(): will return a string with a Windows time zone.
  • findAlias(): will an array of all IANA aliases, including the one passed as a parameter.

findOneIana()

import { findOneIana } from "windows-iana";

const result = findOneIana("Romance Standard Time");
console.log(result); // "Europe/Paris"

You may also pass the territory code as a second parameter (have a look again at the mapping by unicode.org for more details).

import { findOneIana } from "windows-iana";

const result = findOneIana("Romance Standard Time", "ES");
console.log(result); // "Europe/Madrid"

findIana()

import { findIana } from "windows-iana";

const result = findIana("Romance Standard Time");
console.log(result); // ["Europe/Paris"]

You may also pass the territory code to findIana().

import { findIana } from "windows-iana";

const result = findIana("Romance Standard Time", "ES");
console.log(result); // ["Europe/Madrid", "Africa/Ceuta"]

findWindows()

import { findWindows } from "windows-iana";

const result = findWindows("America/New_York");
console.log(result); // Eastern Standard Time

There is no territory code for this function because all IANA names map to exactly one territory.

findAlias()

import { findAlias } from "windows-iana";

const result = findAlias("America/New_York");
console.log(result); // ["America/New_York", "US/Eastern"]

About

A small tool to convert Windows time zones to IANA

License:MIT License


Languages

Language:TypeScript 93.7%Language:JavaScript 6.3%