UTC offset2.9.0++

moment().utcOffset();
moment().utcOffset(Number|String);
moment().utcOffset(Number|String, Boolean);

Get the UTC offset in minutes.

Note: Unlike moment.fn.zone thisfunction returns the real offset from UTC, not the reverse offset (as returnedby Date.prototype.getTimezoneOffset).

Getting the utcOffset of the current object:

moment().utcOffset(); // (-240, -120, -60, 0, 60, 120, 240, etc.)

Setting the UTC offset by supplying minutes. The offset is set on the moment objectthat utcOffset() is called on. If you are wanting to set the offset globally,try using moment-timezone. Note that once you set an offset,it's fixed and won't change on its own (i.e there are no DST rules). If you wantan actual time zone — time in a particular location, likeAmerica/Los_Angeles, consider moment-timezone.

moment().utcOffset(120);

If the input is less than 16 and greater than -16, it will interpret your input as hours instead.

// these are equivalent
moment().utcOffset(8);  // set hours offset
moment().utcOffset(480);  // set minutes offset (8 * 60)

It is also possible to set the UTC offset from a string.

// these are equivalent
moment().utcOffset("+08:00");
moment().utcOffset(8);
moment().utcOffset(480);

moment#utcOffset will search the string for the first match of +00:00 +0000 -00:00 -0000 Z, so you can even pass an ISO8601 formatted string and the momentwill be changed to that UTC offset.

Note that the string, if not 'Z', is required to start with the + or - character.

moment().utcOffset("2013-03-07T07:00:00+08:00");

The utcOffset function has an optional second parameter which accepts a boolean valueindicating whether to keep the existing time of day.

• Passing false (the default) will keep the same instant in Universal Time, but thelocal time will change.

• Passing true will keep the same local time, but at the expense of choosing a differentpoint in Universal Time.

One use of this feature is if you want to construct a moment with a specific time zoneoffset using only numeric input values:

moment([2016, 0, 1, 0, 0, 0]).utcOffset(-5, true) // Equivalent to "2016-01-01T00:00:00-05:00"