dtvtoutc

Purpose

Converts DTV vector format to UTC scalar format.

Format

utc = dtvtoutc(dtv)
Parameters

dtv (Nx8 matrix) – DTV vector format.

Returns

utc (Nx1 vector) – UTC scalar format.

Examples

// Create a 1x8 DTV vector equal
// to January 1, 1970 00:00:00
dtv = { 1970 01 01 0 0 0 0 0 };

// Convert to number of seconds since
// January 1, 1970 GMT
utc = dtvtoutc(dtv);

If the code above is run from a computer set to American Mountain Standard Time (UTC-7), then utc will equal

utc = 25200

This is because the input, dtv, is assumed to represent the local time, while the output is GMT. As the clock turned to 00:00:00 January 1, 1970 MST, GMT was seven hours ahead (7 * 60 * 60 = 25,200).

Remarks

A UTC scalar gives the number of seconds since or before January 1, 1970 Greenwich Mean Time.

Each row of dtv, in DTV vector format, contains:

[N,1]

Year

[N,2]

Month in Year, 1-12

[N,3]

Day of month, 1-31

[N,4]

Hours since midnight, 0-23

[N,5]

Minutes, 0-59

[N,6]

Seconds, 0-59

[N,7]

Day of week, 0-6, 0 = Sunday

[N,8]

Days since Jan 1 of current year, 0-365