esphome::time Namespace Reference

Namespaces
namespace	internal

Data Structures
class	CronTrigger
struct	DSTRule
	Rule for DST transition (packed for 32-bit: 12 bytes) More...
struct	ParsedTimezone
	Parsed POSIX timezone information (packed for 32-bit: 32 bytes) More...
class	RealTimeClock
	The RealTimeClock class exposes common timekeeping functions via the device's local real-time clock. More...
class	SyncTrigger
class	TimeHasTimeCondition

Enumerations
enum class	DSTRuleType : uint8_t { NONE = 0 , MONTH_WEEK_DAY , JULIAN_NO_LEAP , DAY_OF_YEAR }
	Type of DST transition rule. More...

Functions
void	set_global_tz (const ParsedTimezone &tz)
	Set the global timezone used by epoch_to_local_tm() when called without a timezone.
const ParsedTimezone &	get_global_tz ()
	Get the global timezone.
	if (dst_start< dst_end)
void	format_designation (int32_t posix_offset, char *buf, size_t buf_size)
	Format a POSIX offset as "+HHMM"/"-HHMM" into buf (must be >= 6 bytes).
bool	epoch_to_local_tm (time_t utc_epoch, const ParsedTimezone &tz, struct tm *out_tm)
	Convert a UTC epoch to local time using the parsed timezone.
bool	is_in_dst (time_t utc_epoch, const ParsedTimezone &tz)
	Check if a given UTC epoch falls within DST for the parsed timezone.

Variables
bool const ParsedTimezone &	tz
time_t	dst_start = internal::calculate_dst_transition(year, tz.dst_start, tz.std_offset_seconds)
time_t	dst_end = internal::calculate_dst_transition(year, tz.dst_end, tz.dst_offset_seconds)
	else
ESPTime	__attribute__ ((noinline)) RealTimeClock

Enumeration Type Documentation

DSTRuleType

enum class esphome::time::DSTRuleType : uint8_t

strong

Type of DST transition rule.

Enumerator
NONE	No DST rule (used to indicate no DST)
MONTH_WEEK_DAY	M format: Mm.w.d (e.g., M3.2.0 = 2nd Sunday of March)
JULIAN_NO_LEAP	J format: Jn (day 1-365, Feb 29 not counted)
DAY_OF_YEAR	Plain number: n (day 0-365, Feb 29 counted in leap years)

Definition at line 11 of file posix_tz.h.

Function Documentation

epoch_to_local_tm()

bool esphome::time::epoch_to_local_tm	(	time_t	utc_epoch,
		const ParsedTimezone &	tz,
		struct tm *	out_tm )

Convert a UTC epoch to local time using the parsed timezone.

This replaces libc's localtime() to avoid scanf dependency.

Parameters

	utc_epoch	Unix timestamp in UTC
	tz	The parsed timezone
[out]	out_tm	Output tm struct with local time

Returns

true on success

Definition at line 268 of file posix_tz.cpp.

format_designation()

void esphome::time::format_designation	(	int32_t	posix_offset,
		char *	buf,
		size_t	buf_size )

Format a POSIX offset as "+HHMM"/"-HHMM" into buf (must be >= 6 bytes).

Definition at line 258 of file posix_tz.cpp.

get_global_tz()

const ParsedTimezone & esphome::time::get_global_tz

(

)

Get the global timezone.

Definition at line 16 of file posix_tz.cpp.

if()

esphome::time::if

(

)

Definition at line 247 of file posix_tz.cpp.

is_in_dst()

bool esphome::time::is_in_dst	(	time_t	utc_epoch,
		const ParsedTimezone &	tz )

Check if a given UTC epoch falls within DST for the parsed timezone.

Parameters

utc_epoch	Unix timestamp in UTC
tz	The parsed timezone

Returns

true if DST is in effect at the given time

set_global_tz()

void esphome::time::set_global_tz

(

const ParsedTimezone &

tz

)

Set the global timezone used by epoch_to_local_tm() when called without a timezone.

This enables ESPTime::from_epoch_local() to work without libc's localtime().

Definition at line 14 of file posix_tz.cpp.

Variable Documentation

__attribute__

bool esphome::time::__attribute__

(

(noinline)

)

Definition at line 26 of file real_time_clock.cpp.

dst_end

time_t esphome::time::dst_end = internal::calculate_dst_transition(year, tz.dst_end, tz.dst_offset_seconds)

Definition at line 245 of file posix_tz.cpp.

dst_start

time_t esphome::time::dst_start = internal::calculate_dst_transition(year, tz.dst_start, tz.std_offset_seconds)

Definition at line 243 of file posix_tz.cpp.

else

esphome::time::else

Initial value:

{
    
    return (utc_epoch >= dst_start || utc_epoch < dst_end)

Definition at line 250 of file posix_tz.cpp.

tz

bool const ParsedTimezone& esphome::time::tz

Initial value:

{
  if (!tz.has_dst()) {
    return false;
  }
 
  int year = internal::epoch_to_year(utc_epoch)

Definition at line 234 of file posix_tz.cpp.