Time Conversions

A comprehensive set of functions and utilities for working with timestamps and time-related data. More...

Topics
	Time structure conversions

Detailed Description

A comprehensive set of functions and utilities for working with timestamps and time-related data.

This module provides functionalities to convert, manipulate, and analyze timestamps in seconds, milliseconds, and floating-point formats. It also includes utilities for working with date-time structures, UNIX days, and various time units (hours, minutes, seconds, etc.).

Key Features:

• Convert timestamps between seconds, milliseconds, and floating-point seconds.
• Extract components such as nanoseconds, microseconds, and milliseconds from timestamps.
• Convert timestamps to and from date-time structures.
• Calculate the start and end of various time intervals (e.g., days, hours, months, years).
• Analyze time data (e.g., day of the week, day of the year, days in a month or year).

Usage Examples:

• Obtain the millisecond component of a timestamp:

  auto ms = time_shield::ms_of_sec(123.456);

• Convert a date-time structure to a timestamp:

  auto ts = time_shield::to_timestamp(2024, 11, 25, 14, 30, 0);

• Determine the start of the current year:

  auto year_start = time_shield::start_of_year(current_timestamp());