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