.. index:: pair: struct; P1::ImageSdk::GpsDateTimeComponents
.. _doxid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components:

struct P1::ImageSdk::GpsDateTimeComponents
==========================================

.. toctree::
	:hidden:

Overview
~~~~~~~~

A Date & Time representation used by the GPS to provide sub-millisecond precision. :ref:`More...<details-struct_p1_1_1_image_sdk_1_1_gps_date_time_components>`


.. ref-code-block:: cpp
	:class: doxyrest-overview-code-block

	#include <P1ImageGpsImu.hpp>
	
	struct GpsDateTimeComponents
	{
		// fields
	
		bool :target:`hasDate<doxid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1ac8249942ea4ad79b34322d93a647bd32>`;
		uint32_t :target:`year<doxid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1ad84e22d30917fdf76ef80de38c05c820>`;
		uint32_t :target:`month<doxid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a54eaf79f3696b9ece2560706e5cc7513>`;
		uint32_t :target:`day<doxid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a8f2d4f0271e5a167d1edbb6211507bf3>`;
		int :target:`hours<doxid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a84a851c811b9c7003b3dcca76319efcc>`;
		int :target:`minutes<doxid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a92f9a401375e2436df4673572141cbf8>`;
		double :target:`seconds<doxid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a79d8b018a56357928c7543f725027086>`;
		bool :target:`isGpsTime<doxid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a3c3ea7648c669c765d773dc34ff5f2a9>`;

		// methods
	
		std::string :target:`ToString<doxid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a01c8aebcf07d1996a21809a32f8cfe21>`() const;
	};
.. _details-struct_p1_1_1_image_sdk_1_1_gps_date_time_components:

Detailed Documentation
~~~~~~~~~~~~~~~~~~~~~~

A Date & Time representation used by the GPS to provide sub-millisecond precision.

Note that the *date* part might not be present. (The presence depends on the GPS module used) See :ref:`hasDate <doxid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1ac8249942ea4ad79b34322d93a647bd32>` to check you date fields contains something meaningful.

The *timezone* is always GMT/UTC. However, the clock used (or time scale) might not be UTC.

GPS uses its own timescale (or clock) called *GPS Time*. It branched out from UTC in 1980, and has since lept ahead of UTC. The reason is that *GPS Time* does not account for the leap seconds added to UTC (since 1980).

The field :ref:`isGpsTime <doxid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a3c3ea7648c669c765d773dc34ff5f2a9>` tells you if the timestamp is in *GPS Time* and not *UTC*. By January 1st, 2017, the differnce between GPS Time and UTC is: GPS - UTC = +18 seconds.