.. _doxcsid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components:

GpsDateTimeComponents Struct
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Definition
^^^^^^^^^^

*Namespace:* ``P1.ImageSdk``

A date & time representation used by the GPS to provide sub-millisecond precision :ref:`More...<csdetails-struct_p1_1_1_image_sdk_1_1_gps_date_time_components>`

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

	public struct GpsDateTimeComponents


.. _csdetails-struct_p1_1_1_image_sdk_1_1_gps_date_time_components:

Remarks
^^^^^^^

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 <doxcsid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1aadbfd186bbf2ff05eb2f363b3487b604>` 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 <doxcsid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a5bdc5c5352364cdc3879c98adbf15d0e>` 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.


Members
^^^^^^^

.. toctree::
	:hidden:

	HasDate <variable_P1_ImageSdk_GpsDateTimeComponents_HasDate.rst>
	Year <variable_P1_ImageSdk_GpsDateTimeComponents_Year.rst>
	Month <variable_P1_ImageSdk_GpsDateTimeComponents_Month.rst>
	Day <variable_P1_ImageSdk_GpsDateTimeComponents_Day.rst>
	Hours <variable_P1_ImageSdk_GpsDateTimeComponents_Hours.rst>
	Minutes <variable_P1_ImageSdk_GpsDateTimeComponents_Minutes.rst>
	Seconds <variable_P1_ImageSdk_GpsDateTimeComponents_Seconds.rst>
	IsGpsTime <variable_P1_ImageSdk_GpsDateTimeComponents_IsGpsTime.rst>

.. list-table::
	:widths: 30 70

	*
		- :ref:`HasDate <doxcsid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1aadbfd186bbf2ff05eb2f363b3487b604>`
		- True if a date value has been supplied by the GPS device
	*
		- :ref:`Year <doxcsid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a09919a477e754ee6773f964b458a92ff>`
		- Year with 4 digits
	*
		- :ref:`Month <doxcsid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a6aecb3c6e61238fd6de5e6468ab96932>`
		- Month of year, 1-12
	*
		- :ref:`Day <doxcsid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a762ba3bcb505a22486d38ea99b9622c9>`
		- Day of month, 1-31
	*
		- :ref:`Hours <doxcsid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a537dd2f0bb7b84b1a15d05aad7755fa6>`
		- Hours, 0-23
	*
		- :ref:`Minutes <doxcsid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a1215ebda3c930eb8203d184a3309dc07>`
		- Minutes, 0-59
	*
		- :ref:`Seconds <doxcsid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a37004becef8499b9061bac68af55e64a>`
		- Number of seconds 0-59, with decimals
	*
		- :ref:`IsGpsTime <doxcsid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a5bdc5c5352364cdc3879c98adbf15d0e>`
		- If ``true``, then time is provided in *GPS Time*. If ``false``, time is UTC.

Methods
^^^^^^^

.. toctree::
	:hidden:

	ToTimeSpan <function_P1_ImageSdk_GpsDateTimeComponents_ToTimeSpan.rst>
	ToDateTime <function_P1_ImageSdk_GpsDateTimeComponents_ToDateTime.rst>
	ToString <function_P1_ImageSdk_GpsDateTimeComponents_ToString.rst>

.. list-table::
	:widths: 33 67

	* 
		- :ref:`ToTimeSpan() <doxcsid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1adf72c18b3e1c3bc74f922b0a84a4bb7b>`
		- Get a TimeSpan representation. However, precision is lost - since TimeSpan resolution is milliseconds
	* 
		- :ref:`ToDateTime() <doxcsid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a95a255315c4efe6e372c8eb9b088a849>`
		- Get a DateTime from the GPS date-time stamp (in UTC). Some GPS devices might not supply a date value. If so, this method returns NULL.
	* 
		- :ref:`ToString() <doxcsid-struct_p1_1_1_image_sdk_1_1_gps_date_time_components_1a006b9c1a0af7822be83f157e82bed83b>`
		- Get as a human readable string representation