🌍 mytimezonesinfo

An Angular utility library that provides a structured list of global time zones with labels, IANA values, and UTC offsets.

📦 Installation

npm install mytimezonesinfo

✅ Compatibility

| Package | Supported Version | |------------------|--------------------------| | Angular | 14.x → 21.x | | @angular/core | >=14.0.0 <22.0.0 | | @angular/common | >=14.0.0 <22.0.0 | | TypeScript | >=4.7 |

🚀 Basic Usage

1️⃣ Import the package

import { TIMEZONES } from 'mytimezonesinfo';

2️⃣ Use inside component

import { Component } from '@angular/core';
import { TIMEZONES } from 'mytimezonesinfo';

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html'
})
export class AppComponent {
  timezones = TIMEZONES;
}

3️⃣ Use in HTML template

<select>
  <option *ngFor="let tz of timezones" [value]="tz.value">
    {{ tz.label }} (UTC {{ tz.offset }})
  </option>
</select>

🔎 Example Filters (Using TimeZoneService)

Get By Country

this.tzService.getByCountry('IN');

Get By Continent

this.tzService.getByContinent('AS');

Get By Name (IANA)

this.tzService.getByName('Asia/Kolkata');

🧠 Using in Standalone Angular 21

import { Component } from '@angular/core';
import { TimeZoneService } from 'mytimezonesinfo';

@Component({
  standalone: true,
  selector: 'app-home',
  template: `
    <div *ngFor="let tz of timezones">
      {{ tz.label }}
    </div>
  `
})
export class HomeComponent {

  timezones = [];

  constructor(private tzService: TimeZoneService) {
    this.timezones = this.tzService.getAll();
  }
}

🧪 Angular Usage Example

import { TimeZoneService } from 'mytimezonesinfo';

const tzService = new TimeZoneService();

// Filter example
const asiaZones = tzService.filter({
  continentCode: 'AS'
});

// Search example
const london = tzService.filter({
  search: 'London'
});

// Current time example
const tokyoTime = tzService.getCurrentTimeByName('Asia/Tokyo');
console.log(tokyoTime?.toLocaleString());

📂 Data Structure

Each timezone object follows this structure:

export interface Timezone {
  label: string;
  value: string;   // IANA timezone (e.g. "Asia/Kolkata")
  offset: string;  // UTC offset (e.g. "+05:30")
  country?: string;
  continent?: string;
}

Example Object

{
  label: "India Standard Time",
  value: "Asia/Kolkata",
  offset: "+05:30",
  country: "IN",
  continent: "AS"
}

💡 Use Cases

• User profile timezone selection
• Admin panel settings
• Event scheduling systems
• Calendar applications
• Global SaaS platforms

📜 License

MIT License
© 2026 Vansh Mehta

🤝 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.