.. index:: pair: struct; EE::System::LocalDateTime
.. _doxid-struct_e_e_1_1_system_1_1_local_date_time:

struct EE::System::LocalDateTime
================================

.. toctree::
	:hidden:

Overview
~~~~~~~~

A local civil date and wall-clock time. :ref:`More...<details-struct_e_e_1_1_system_1_1_local_date_time>`


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

	#include <datetime.hpp>
	
	struct LocalDateTime {
		// fields
	
		:ref:`CalendarDate<doxid-struct_e_e_1_1_system_1_1_calendar_date>` :target:`date<doxid-struct_e_e_1_1_system_1_1_local_date_time_1aec57ef8040256355219de98c6e36d699>`;
		:ref:`TimeOfDay<doxid-struct_e_e_1_1_system_1_1_time_of_day>` :target:`time<doxid-struct_e_e_1_1_system_1_1_local_date_time_1a823ca9b5014104b872f96b5623e5367d>`;

		// methods
	
		bool :target:`isValid<doxid-struct_e_e_1_1_system_1_1_local_date_time_1a29b80f245cf9e9cc72d90a4d0375a23a>`() const;
		std::optional<:ref:`Int64<doxid-namespace_e_e_1a08ce4c6c46ed4d44737063c848bdf542>`> :ref:`toUnixTimestamp<doxid-struct_e_e_1_1_system_1_1_local_date_time_1aa20787e3cf10c59fadf4b89d2955fde1>`(:ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>` utcOffsetSeconds = 0) const;
		std::optional<:ref:`Int64<doxid-namespace_e_e_1a08ce4c6c46ed4d44737063c848bdf542>`> :ref:`toUnixTimestampMilliseconds<doxid-struct_e_e_1_1_system_1_1_local_date_time_1aa1c59202b19f26ccf3942f1623a4a847>`(:ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>` utcOffsetSeconds = 0) const;
		LocalDateTime :target:`addHours<doxid-struct_e_e_1_1_system_1_1_local_date_time_1a9bec7e4859a8b2b9ba4a50151b6278b1>`(:ref:`Int64<doxid-namespace_e_e_1a08ce4c6c46ed4d44737063c848bdf542>` hours) const;
		LocalDateTime :target:`addMinutes<doxid-struct_e_e_1_1_system_1_1_local_date_time_1a01682bb019e797ffc3d608b45d058463>`(:ref:`Int64<doxid-namespace_e_e_1a08ce4c6c46ed4d44737063c848bdf542>` minutes) const;
		LocalDateTime :target:`addSeconds<doxid-struct_e_e_1_1_system_1_1_local_date_time_1ae966340513bfa3d263762ef4bab72202>`(:ref:`Int64<doxid-namespace_e_e_1a08ce4c6c46ed4d44737063c848bdf542>` seconds) const;
		auto :target:`operator<doxid-struct_e_e_1_1_system_1_1_local_date_time_1a98cfc184633fa1cd7869d4f7e7650a73>`(const LocalDateTime&) const;
		static std::optional<LocalDateTime> :ref:`fromUnixTimestamp<doxid-struct_e_e_1_1_system_1_1_local_date_time_1a397a1f3b4add7b4e01a9dafbc323a579>`(:ref:`Int64<doxid-namespace_e_e_1a08ce4c6c46ed4d44737063c848bdf542>` seconds, :ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>` utcOffsetSeconds = 0);
		static std::optional<LocalDateTime> :ref:`fromUnixTimestampMilliseconds<doxid-struct_e_e_1_1_system_1_1_local_date_time_1ae969a47623734a900c11e5dcf032630b>`(:ref:`Int64<doxid-namespace_e_e_1a08ce4c6c46ed4d44737063c848bdf542>` milliseconds, :ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>` utcOffsetSeconds = 0);
		static LocalDateTime :target:`now<doxid-struct_e_e_1_1_system_1_1_local_date_time_1aebc426a8f645f7a13b42028a81ce4862>`();
	};
.. _details-struct_e_e_1_1_system_1_1_local_date_time:

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

A local civil date and wall-clock time. This value does not imply a timezone.

Methods
-------

.. index:: pair: function; toUnixTimestamp
.. _doxid-struct_e_e_1_1_system_1_1_local_date_time_1aa20787e3cf10c59fadf4b89d2955fde1:

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

	std::optional<:ref:`Int64<doxid-namespace_e_e_1a08ce4c6c46ed4d44737063c848bdf542>`> toUnixTimestamp(:ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>` utcOffsetSeconds = 0) const

Unix seconds using a UTC offset in seconds (local = UTC + offset), defaulting to UTC. Discards milliseconds; returns nullopt for an invalid value. Does not infer the system timezone or resolve daylight-saving transitions.

.. index:: pair: function; toUnixTimestampMilliseconds
.. _doxid-struct_e_e_1_1_system_1_1_local_date_time_1aa1c59202b19f26ccf3942f1623a4a847:

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

	std::optional<:ref:`Int64<doxid-namespace_e_e_1a08ce4c6c46ed4d44737063c848bdf542>`> toUnixTimestampMilliseconds(:ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>` utcOffsetSeconds = 0) const

Unix milliseconds preserving the millisecond field, with the same offset convention. Returns nullopt for an invalid value or an Int64 timestamp overflow.

.. index:: pair: function; fromUnixTimestamp
.. _doxid-struct_e_e_1_1_system_1_1_local_date_time_1a397a1f3b4add7b4e01a9dafbc323a579:

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

	static std::optional<LocalDateTime> fromUnixTimestamp(:ref:`Int64<doxid-namespace_e_e_1a08ce4c6c46ed4d44737063c848bdf542>` seconds, :ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>` utcOffsetSeconds = 0)

Civil date/time at the given UTC offset (default: UTC), with zero milliseconds. Returns nullopt if the result is outside the Int32 year range.

.. index:: pair: function; fromUnixTimestampMilliseconds
.. _doxid-struct_e_e_1_1_system_1_1_local_date_time_1ae969a47623734a900c11e5dcf032630b:

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

	static std::optional<LocalDateTime> fromUnixTimestampMilliseconds(:ref:`Int64<doxid-namespace_e_e_1a08ce4c6c46ed4d44737063c848bdf542>` milliseconds, :ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>` utcOffsetSeconds = 0)

Civil date/time at the given UTC offset (default: UTC), preserving milliseconds. Returns nullopt if the result is outside the Int32 year range.