em0ney / meteor-timezone

Capture users timezone once per session in meteor applications

Overview

This is a meteor package to help developers deal with users in different locations and displaying dates in their local timezone.

If you have users all over the world, it makes sense to store dates in a single timezone. GMT/UTC is generally the timezone of choice. This package is a simple way to capture your user's timezone and easily convert to and from GMT/UTC using the utility functions provided.

The package will capture the users local timezone once per session and store it in their User.profile document. Also provided is a utility function that will show a given javascript date object in the user's local timezone.

Installation

Install by typing meteor add em0ney:timezone

Usage

Just install and we'll start tracking your user's timezones straight away.

Use the timezone offset

Getter:

Timezone.getTimezoneOffset();
	> "+1000"

Convert GMT/UTC time to user's timezone:

Timezone.userTimeFromGMT(date);

Convert user time to GMT/UTCL

Timezone.userTimeToGMT(date);

On the server side, Timezone.checkTimezone() will return the timezone offset of the server.

meteor-timezone's Issues

Support for audit-argument-checks and SimpleSchema

The idea of this package is good, but unfortunately it neither supports audit-argument-checks nor SimpleSchema. So if you're using one of them, it throws errors: SimpleSchema complains that the user profile schema does not contain the timezone field, and audit-argument-checks does complain that the method call does not check the input parameter.

SimpleSchema support can be added easily on the app side, and I think this should also be the duty of the app developer. Yet, it would be nice if the package docs stated which data format is used for the timezone (I think it's just a Number).

The audit-argument-checks problem, however, cannot be solved on the app side, since it has to be done in the method code. So I would recommend to add a check() in the method. For now, I will have to do a fork of this package to make it work in my app.

BTW: I was also missing a license information and a link from Atmosphere to Github.