timezone 0.1.0

Library to convert DateTimes between Time Zones.

TimeZone

Library to convert date times between TimeZones.

The data for Time Zones are from [http://www.iana.org/time-zones](the IANA Time Zone Database).

Initialization

TimeZone objects require time zone data, so the first step is to load the data.

We are providing two different APIs for browsers and servers.

Initialization for browser environment

Import package:timezone/browser.dart library and run async function initializeTimeZone([String url]).

This function has optional argument with the path to the data url.

import 'package:timezone/browser.dart';

tz.initializeTimeZone()
.then((_) {

  final detroit = getLocation('America/Detroit');
  final now = new TZDateTime.now(detroit);

});

Initialization for server environment

Import package:timezone/server.dart library and run async function initializeTimeZone().

import 'package:timezone/server.dart';

tz.initializeTimeZone()
.then((_) {

  final detroit = getLocation('America/Detroit');
  final now = new TZDateTime.now(detroit);

});

API

Location

final detroit = getLocation('America/Detroit');

TimeZone

TimeZone object represents time zone and contains offset and name in abbreviated form.

TimeZone aware DateTime

TZDateTime object implements standard DateTime interface and contains information about the time zone.

final date = new TZDateTime(detroit, 2014, 11, 17);

Updating Time Zone database

$ pub run tool/get -s 2014h