date-tz

constructor

Wrapper above js native Date object for using with time zones that differs from current

Parameters

- zone [string][1] [zone][2] (optional, default '+0000')
- args any any data to initialize native [date][3] object

Examples

``javascript
import DateTz from 'DateTz';
const date = new DateTz('+0300', '2000-01-01T00:00:00.000Z');
i.toISOString(); // '2000-01-01T00:00:00.000Z'
`

zone

Parameters

- value [String][1] zone in [rfc2822][4] format

Examples

`javascript
import DateTz from 'DateTz';
const i = new DateTz('+0000', '2000-01-01T00:00:00.000Z');
i.zone // '+0000';
i.getTzHours(); // 0
i.getUTCHours(); // 0
i.zone = '+0300';
i.zone; // '+0300'
i.getTzHours(); // 3
i.getUTCHours(); // 0
`

getTzDate

returns date in [zone][2]

Examples

`javascript
import DateTz from 'DateTz';
const i = new DateTz('+06', '2000-01-10T00:00:00.000+06:00');
i.setTzDate(12);
i.getTzDate(); // 12
i.getUTCDate(); // 13
`

Returns [number][5]

getTzDay

returns day of week in [zone][2]

Examples

`javascript
import DateTz from 'DateTz';
const i = new DateTz('06', '2000-01-10T00:00:00.000+06:00');
i.setTzDate(12);
i.getTzDay(); // 3
i.getUTCDay(); // 2
`

Returns [number][5]

getTzFullYear

returns year in [zone][2]

Examples

`javascript
import DateTz from 'DateTz';
const i = new DateTz('+06', '2000-01-01T00:00:00.000+06:00');
i.setTzFullYear(2002);
i.getTzFullYear(); // 2002
i.getUTCFullYear(); // 2001
`

Returns [number][5]

getTzHours

returns hours in [zone][2]

Examples

`javascript
import DateTz from 'DateTz';
const i = new DateTz('-06', '2000-01-01T06:00:00.000Z');
i.getTzHours(); // 0
i.setTzHours(2);
i.getTzHours(); // 2
i.getUTCHours(); // 8;
`

Returns [number][5]

getTzMilliseconds

returns milliseconds in [zone][2]

Examples

`javascript
import DateTz from 'DateTz';
const i = new DateTz('-06', '2000-01-01T00:00:00.000Z');
i.setTzMilliseconds(15);
i.getTzMilliseconds(); // 15
i.getUTCMilliseconds(); // 15
`

Returns [number][5]

getTzMinutes

returns minutes in [zone][2]

Examples

`javascript
import DateTz from 'DateTz';
const i = new DateTz('-0603', '2000-01-01T06:00:00.000Z');
i.setTzMinutes(15);
i.getTzMinutes(); // 15
i.getUTCMinutes(); // 18
`

Returns [number][5]

getTzMonth

returns month in [zone][2]

Examples

`javascript
import DateTz from 'DateTz';
const i = new DateTz('-06', '2000-01-30T20:00:00.000-06:00');
i.setTzMonth(5);
i.getTzMonth(); // 5
i.getUTCMonth(); // 6
`

Returns [number][5]

getTzSeconds

returns seconds in [zone][2]

Examples

`javascript
import DateTz from 'DateTz';
const i = new DateTz('-06', '2000-01-01T00:00:00.000Z');
i.setTzMilliseconds(15);
i.getTzMilliseconds(); // 15
i.getUTCMilliseconds() // 15
`

Returns [number][5]

getTzTimezoneOffset

returns offset between [zone][2] and UTC

Examples

`javascript
import DateTz from 'DateTz';
i = new DateTz('-0507', '2000-01-30T20:00:00.000-06:00');
i.getTzTimezoneOffset(); // 307
``

Returns [number][5]

setTzDate

set date in [zone][2]

setTzFullYear

set year in [zone][2]

setTzHours

set hours in [zone][2]

setTzMilliseconds

set milliseconds in [zone][2]

setTzMinutes

set minutes in [zone][2]

setTzMonth

set month in [zone][2]

setTzSeconds

set seconds in [zone][2]

Installation

npm install --save DateTz

[1]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String

[2]: zone

[3]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Date

[4]: https://rfc2.ru/5322.rfc/print#p3.3

[5]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number